Home
Retrieving 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 Accepting 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. To retrieve a feed, see Searching for a person's colleagues.
See Authenticating requests for information about how to authenticate the request.
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.
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 will contain one of the error codes below.
- Content-Type: application/atom+xml
- Indicates that the document returned contains data in Atom format.
Error codes
- 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
Working with colleague connections
Related reference
Colleague connection entry content