Tags API
Errors
Every error is a JSON object with a single error string, written to be shown to a person.
| Status | Meaning |
|---|---|
200 | Success, or POST /api/v1/tags found an existing tag with that name |
201 Created | The tag was created |
400 Bad Request | A missing or invalid field |
401 Unauthorized | Missing, malformed, expired, or revoked API key |
403 Forbidden | The key lacks read:tags (for GET) or write:tags (everything else) |
404 Not Found | A tag or record ID that is not in this workspace |
409 Conflict | A rename to a name another tag already has |
429 Too Many Requests | Rate limit exceeded. See the Retry-After header |
Examples
{ "error": "name is required." }{ "error": "entity must be one of: CONTACT, LEAD, COMPANY, DEAL." }{ "error": "At most 500 recordIds per request." }{ "error": "No contact with id cmq2cont9alk34567899 in this workspace. Nothing was changed." }{ "error": "Tag not found: cmq5tag9alk34567899. Nothing was changed." }{ "error": "A tag named \"Key account\" already exists." }