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 add tags to anyone's collection. You can only replace tags created by the user whose credentials you provided to authenticate with the server. You can remove tags from the tag collection for your profile by leaving them out of the updated set. See Authenticating requests
for information about how to authenticate the request.
Table 1. Atom API request details
Table 2. Input parameters
Atom category document
Profiles tags category document
Specifies the email 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.
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.
Specifies the email address of the creator of the tags. You must provide one source parameter, either this option or the sourceKey option.
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 email or key using a source parameter.
Provide a profile tags Atom categories document.
The content type of the Atom entry document must be application/atomcat+xml.
Returned HTTP headers
HTTP/1.1 200 OK
Indicates that the tags were successfully updated.HTTP/1.1 400 Bad Request
An error was encountered.Parent topic: Working with profile tags
Tags category document
Retrieving profile tags