The tags API allows you to add, update, and delete tags from parties (people and companies), cases, and deals. In the documentation below, the generic "#{subject_type}" text must be replaced in practice with either "people", "companies", "kases", or "deals", and "#{subject_id}" should be the id of the subject (person, company, case or deal) that you want to manipulate or query the tags for.
Return all tags used in the account.
Status: 200 OK
<tags type="array">
<tag>
<id type="integer"></id>
<name></name>
</tag>
...
</tags>
Return the tags on a person, company, case, or deal.
Status: 200 OK
<tags type="array">
<tag>
<id type="integer"></id>
<name></name>
</tag>
...
</tags>
Return all parties (people and companies) associated with a given tag. Note, though, that this will not include deals and cases for that tag.
Status: 200 OK
<parties type="array">
<party type="Person">
...
</party>
<party type="Company">
...
</parties>
Adds a tag to a person, company, deal, or case.
<name>#{name}</name>
Status: 201 Created
Location: /tags/#{new_id}.xml
<tag>
<id type="integer"></id>
<name></name>
</tag>
Removes a tag from a person, company, deal, or case.
Status: 200 OK