v1Recursos/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-tagsCorpo da solicitação
namestringobrigatório
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)opcional
The tag's color: neutral, accent, success, warning or danger. Optional.
Resposta
okbooleanopcional
Sempre true em uma resposta bem-sucedida.
tagobjectopcional
idstringopcional
The tag's id. Pass it in add or remove when tagging items.
namestringopcional
The tag's name, 1 to 60 characters. Creating a tag with the name of an archived approvals tag brings that tag back.
colorstringopcional
The tag's color: neutral, accent, success, warning or danger. Optional.
Erros
400Os erros de Tarefas e aprovações retornam ok: false com um objeto error contendo code, message, retryable e details. Os erros da própria verificação da chave de API (chave ausente ou inválida, scope ausente, limite de requisições) usam o formato padrão, em que error é uma string.
401Chave de API ausente, inválida, expirada ou revogada.
403Os erros de Tarefas e aprovações retornam ok: false com um objeto error contendo code, message, retryable e details. Os erros da própria verificação da chave de API (chave ausente ou inválida, scope ausente, limite de requisições) usam o formato padrão, em que error é uma string.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/work-management/approval-tags
Sua chave de API
Corpo da solicitação*
{}