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

Error codes


Working with colleague connections

 

Related reference


Colleague connection entry content


+

Search Tips   |   Advanced Search