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/applyCuerpo de la solicitud
itemKeysarray of stringobligatorio
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.
Respuesta
okbooleanopcional
Siempre true en una respuesta correcta.
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
La clave de la tarea, con el formato task:<id>.
codestringopcional
Qué falló: invalid (400), forbidden (403), not_found (404), stale, conflict o blocked (409), o internal (500).
Errores
400Los errores de Tareas y aprobaciones llegan como ok: false con un objeto error que contiene code, message, retryable y details. Los errores de la propia comprobación de la clave de API (clave ausente o no válida, scope ausente, límite de solicitudes) usan el formato estándar, en el que error es un string.
401La clave de API falta, es inválida, expiró o fue revocada.
403Los errores de Tareas y aprobaciones llegan como ok: false con un objeto error que contiene code, message, retryable y details. Los errores de la propia comprobación de la clave de API (clave ausente o no válida, scope ausente, límite de solicitudes) usan el formato estándar, en el que error es un string.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/work-management/approval-tags/apply
Su clave de API
Cuerpo de la solicitud*
{}