Home

 

Updating profile tags

To update the tags that one user created and assigned to another user's profile, use a HTTP PUT request to update the tags listed in the tag creator's tags category document.

When you update profile tags, the existing tag information is replaced with the new data. To avoid deleting all existing tags, retrieve the tags that you want to retain first, and send them back with this request. See Retrieving profile tags for more information.

You can only replace the tags created by the user whose credentials you provided to authenticate with the server. See Authenticating requests for information about how to authenticate the request.


Atom API request details

Method Resource URI Input representation
PUT Atom category document /atom/profileTags.do Profiles tags category document


Input parameters

Parameter Description
targetEmail Specifies the e-mail address of the person whose profile you want to apply the updated tags to. You must provide one target parameter, either this option or the targetKey option.
targetKey Specifies the unique ID of the person whose profile you want to apply the updated tags to. You must provide one target parameter, either this option or the targetEmail option.
sourceEmail Specifies the e-mail address of the creator of the tags. You must provide one source parameter, either this option or the sourceKey option.
sourceKey Specifies the unique ID of the creator of the tags. You must provide one source parameter, either this option or the sourceEmail option.

An example of when you might want to use one of the source parameters is if you tagged a person's profile, and then wanted to update it. For example, you tagged Sandy's profile. Now you want to add a new tag to the set. First, you retrieve the existing tags, and then you update them. To both retrieve and update the tags, specify Sandy's information using a target parameter and provide your e-mail or key using a source parameter.

 

Input

Provide a profile tags Atom categories document.

The content type of the Atom entry document must be application/atomcat+xml.

 

Output

None. Returned HTTP Headers


Working with profile tags

 

Related reference


Tags category document

Retrieving profile tags


+

Search Tips   |   Advanced Search