Retrieve connections
To retrieve complete information about a colleague relationship, use the edit link found in the connection entry in the colleague connections feed.You can use this operation to obtain connection information that you want to preserve prior to accepting an invitation. See Accept an invitation to become a colleague for more information. This method returns the Atom entry of a single connection entry as opposed to a feed of all the connection entries. If you want to retrieve a feed, see Search for a person's colleagues.
See Authenticating requests for information about how to authenticate the request.
Table 1. Atom API request details
Method Resource URI Output representation GET connection Value of the href attribute of <link rel="edit"> element of each entry in the colleague connections feed. connection
You can optionally provide the following parameter as input.Table 2. Optional input parameter
Parameter Description inclMessage Specifies whether or not to include the invitation message with the returned entries. This parameter accepts a Boolean value of true or false. If you include this parameter and set it to true, be the source of the connection object and authenticate the request.
See Authenticating requests for information about how to authenticate the request.
Input
None.
Output
An Atom entry document containing the connection.Returned HTTP headers
HTTP/1.1 200 OK
Indicates that the connection was successfully found and returned. The message also provides the type and status of the connection. If an error occurs, this header contains one of the error codes.
Content-Type: application/atom+xml
Indicates that the document returned contains data in Atom format.
- HTTP/1.1 400 Bad Request
- HTTP/1.1 401 Unauthorized: Returned if you failed to authenticate the request but provided the inclMessage=true parameter to have the invitation message included in the returned Atom document.
- HTTP/1.1 404 Not Found
Parent topic
Work with colleague connectionsRelated reference
Colleague connection entry content
});