v1Ressourcen/Approvals/postApprove or reject in bulk
Approve or reject in bulk
Decide only items visible to the token creator under current client and private-project access. Each item is checked and saved on its own: an item the caller can’t see or decide fails by itself with its own error code and never undoes the others. Deciding grants no access and shares no private work. Approving records the decision; approved content requires a separate delivery action.
post
approvals:write/api/v1/work-management/approvals/bulk-decideAnfragetext
idempotencyKeystringerforderlich
A unique string you choose for the whole request, 8 to 163 characters. Each item's own key is this value followed by :<item id>, so sending the same request again replays every item instead of deciding it twice.
decisionstring (approve | reject)erforderlich
approve or reject, applied to every item. Task reviews can only be approved: in a reject request each task review fails by itself with invalid. To request changes, decide one item at a time.
reasonstringoptional
Why you decided, up to 2,000 characters. Required when decision is reject; not used when approving.
itemsarray of unknownerforderlich
1 to 100 items: an approval (approvalId and versionHash) or a task review (taskId, requestId and expectedRowVersion). Naming the same item twice refuses the whole request. Items run one after another and each is saved on its own, so a stale or refused item never undoes the others.
Antwort
okbooleanoptional
Bei einer erfolgreichen Antwort immer true.
appliedintegeroptional
How many items succeeded, replays included.
failedintegeroptional
How many items failed. Each one is in results with its code and message.
resultsarray of objectoptional
One result per item, in the order you sent them.
idempotencyKeystringoptional
The idempotency key used for this item: your idempotencyKey followed by :<item id>.
itemKeystringoptional
Der Schlüssel der Aufgabe im Format task:<id>.
okbooleanoptional
Bei einer erfolgreichen Antwort immer true.
replayedbooleanoptional
true, wenn diese Antwort eine frühere Anfrage mit demselben idempotencyKey wiederholt. Es wurde nichts Neues gespeichert.
codestringoptional
Was schiefgelaufen ist: invalid (400), forbidden (403), not_found (404), stale, conflict oder blocked (409) oder internal (500).
messagestringoptional
Eine lesbare Erklärung des Fehlers.
retryablebooleanoptional
true, wenn dieselbe Anfrage später erneut gesendet erfolgreich sein kann.
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.
404Fehler 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.
500Die Anfrage konnte wegen eines Problems auf unserer Seite nicht abgeschlossen werden.
post/api/v1/work-management/approvals/bulk-decide
Ihr API-Schlüssel
Anfragetext*
{}