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

Content-Type: application/atom+xml

Error codes


Parent topic

Work with colleague connections

Related reference
Colleague connection entry content


   

 

});