v1Ressourcen/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/applyAnfragetext
itemKeysarray of stringerforderlich
1 to 200 items to change, each as task:<id> or approval:<id>. Repeats are counted once.
addarray of stringoptional
Ids of approvals tags to add. Unknown or archived tags are ignored. add and remove together hold 1 to 50 ids.
removearray of stringoptional
Ids of approvals tags to remove. Unknown tags are ignored.
Antwort
okbooleanoptional
Bei einer erfolgreichen Antwort immer true.
updatedintegeroptional
How many items the change was applied to. Repeating a call changes nothing more: an item keeps a tag once.
skippedarray of objectoptional
Items left unchanged because you can't see them, each with the code a write would get, such as not_found or forbidden.
itemKeystringoptional
Der Schlüssel der Aufgabe im Format task:<id>.
codestringoptional
Was schiefgelaufen ist: invalid (400), forbidden (403), not_found (404), stale, conflict oder blocked (409) oder internal (500).
Fehler
400Fehler aus Aufgaben & Freigaben kommen als ok: false mit einem error-Objekt aus code, message, retryable und details zurück. Fehler der API-Schlüsselprüfung selbst (fehlender oder ungültiger Schlüssel, fehlender Scope, Rate-Limit) verwenden das Standardformat, in dem error ein String ist.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Fehler aus Aufgaben & Freigaben kommen als ok: false mit einem error-Objekt aus code, message, retryable und details zurück. Fehler der API-Schlüsselprüfung selbst (fehlender oder ungültiger Schlüssel, fehlender Scope, Rate-Limit) verwenden das Standardformat, in dem error ein String ist.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/work-management/approval-tags/apply
Ihr API-Schlüssel
Anfragetext*
{}