v1Recursos/Approvals/postAdd or remove approvals tags
Add or remove approvals tags
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-tags/applyCorpo da solicitação
itemKeysarray of stringobrigatório
1 to 200 items to change, each as task:<id> or approval:<id>. Repeats are counted once.
addarray of stringopcional
Ids of approvals tags to add. Unknown or archived tags are ignored. add and remove together hold 1 to 50 ids.
removearray of stringopcional
Ids of approvals tags to remove. Unknown tags are ignored.
Resposta
okbooleanopcional
Sempre true em uma resposta bem-sucedida.
updatedintegeropcional
How many items the change was applied to. Repeating a call changes nothing more: an item keeps a tag once.
skippedarray of objectopcional
Items left unchanged because you can't see them, each with the code a write would get, such as not_found or forbidden.
itemKeystringopcional
A chave da tarefa, no formato task:<id>.
codestringopcional
O que deu errado: invalid (400), forbidden (403), not_found (404), stale, conflict ou blocked (409), ou internal (500).
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/apply
Sua chave de API
Corpo da solicitação*
{}