v1Resources/Approvals/postCreate an approvals tag
Create an approvals tag
Approvals tags organize items in Inbox → Approvals and are separate from Social Inbox tags. Tag names and colors are shared across the workspace; usage counts are not returned. Tags are added or removed only on items the token creator can currently see, and an item it can’t see is skipped, never tagged. Tagging is not a decision and grants no access.
post
approvals:write/api/v1/work-management/approval-tagsRequest body
namestringrequired
The tag's name, 1 to 60 characters. Creating a tag with the name of an archived approvals tag brings that tag back.
colorstring (neutral | accent | success | warning | danger)optional
The tag's color: neutral, accent, success, warning or danger. Optional.
Response
okbooleanoptional
Always true on a successful response.
tagobjectoptional
idstringoptional
The tag's id. Pass it in add or remove when tagging items.
namestringoptional
The tag's name, 1 to 60 characters. Creating a tag with the name of an archived approvals tag brings that tag back.
colorstringoptional
The tag's color: neutral, accent, success, warning or danger. Optional.
Errors
400Tasks & Approvals errors come back as ok: false with an error object holding code, message, retryable and details. Errors from the API key check itself (a missing or invalid key, a missing scope, the rate limit) use the standard error shape, where error is a string.
401Missing, invalid, expired, or revoked API key.
403Tasks & Approvals errors come back as ok: false with an error object holding code, message, retryable and details. Errors from the API key check itself (a missing or invalid key, a missing scope, the rate limit) use the standard error shape, where error is a string.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/work-management/approval-tags
Your API key
Request body*
{}