To accept an invitation to be a colleague, send an updated connection document in Atom format to the existing connection's edit web address.
After you accept a connection, the status of the connection in your connections is changed from pending to accepted and the status of the connection in the invitee's list of connections is changed from unconfirmed to accepted. To decline the invitation, delete it by sending a DELETE HTTP request to the resource.
All existing connection information will be replaced with the new data. To avoid deleting all existing data, retrieve any data you want to retain first, and send it back with this request. See Inviting a person to become your colleague
for more information.
See Authenticating requests
for information about how to authenticate the request.
Table 1. Atom API request details
Value of the href attribute of the <link> element that has a rel="edit" attribute value for each entry in the colleague connections feed.
Provide a connection Atom entry document. Be sure to change the value of the term attribute of the category element with the attribute value of scheme="http://www.ibm.com/xmlns/prod/sn/status"
from pending to accepted. The content type of the Atom entry document must be application/atom+xml.
Returned HTTP headers
HTTP/1.1 200 OK
Indicates that the colleague connection was successfully updated. If an error occurs, this header will contain one of the error codes below.Error codes
- HTTP/1.1 401 Unauthorized
- HTTP/1.1 404 Not Found
HTTP request header:
Authorization: Basic xxxx
HTTP request content:
<?xml version="1.0" encoding="UTF-8"?>
<title type="text">Bill User45</title>
<category term="connection" scheme="http://www.ibm.com/xmlns/prod/sn/type">
just friends of Bill
Parent topic: Working with colleague connections
Colleague connection entry content