v1Ressources/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/applyCorps de la requête
itemKeysarray of stringobligatoire
1 to 200 items to change, each as task:<id> or approval:<id>. Repeats are counted once.
addarray of stringfacultatif
Ids of approvals tags to add. Unknown or archived tags are ignored. add and remove together hold 1 to 50 ids.
removearray of stringfacultatif
Ids of approvals tags to remove. Unknown tags are ignored.
Réponse
okbooleanfacultatif
Toujours true pour une réponse réussie.
updatedintegerfacultatif
How many items the change was applied to. Repeating a call changes nothing more: an item keeps a tag once.
skippedarray of objectfacultatif
Items left unchanged because you can't see them, each with the code a write would get, such as not_found or forbidden.
itemKeystringfacultatif
La clé de la tâche, au format task:<id>.
codestringfacultatif
Ce qui a échoué : invalid (400), forbidden (403), not_found (404), stale, conflict ou blocked (409), ou internal (500).
Erreurs
400Les erreurs de Tâches et validations renvoient ok: false avec un objet error contenant code, message, retryable et details. Les erreurs de la vérification de la clé API elle-même (clé absente ou invalide, scope manquant, limite de débit) utilisent le format standard, où error est une chaîne.
401Clé API manquante, invalide, expirée ou révoquée.
403Les erreurs de Tâches et validations renvoient ok: false avec un objet error contenant code, message, retryable et details. Les erreurs de la vérification de la clé API elle-même (clé absente ou invalide, scope manquant, limite de débit) utilisent le format standard, où error est une chaîne.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/work-management/approval-tags/apply
Votre clé API
Corps de la requête*
{}