v1Ressources/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-decideCorps de la requête
idempotencyKeystringobligatoire
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)obligatoire
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.
reasonstringfacultatif
Why you decided, up to 2,000 characters. Required when decision is reject; not used when approving.
itemsarray of unknownobligatoire
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.
Réponse
okbooleanfacultatif
Toujours true pour une réponse réussie.
appliedintegerfacultatif
How many items succeeded, replays included.
failedintegerfacultatif
How many items failed. Each one is in results with its code and message.
resultsarray of objectfacultatif
One result per item, in the order you sent them.
idempotencyKeystringfacultatif
The idempotency key used for this item: your idempotencyKey followed by :<item id>.
itemKeystringfacultatif
La clé de la tâche, au format task:<id>.
okbooleanfacultatif
Toujours true pour une réponse réussie.
replayedbooleanfacultatif
true lorsque cette réponse reprend une requête précédente avec le même idempotencyKey : rien de nouveau n'a été enregistré.
codestringfacultatif
Ce qui a échoué : invalid (400), forbidden (403), not_found (404), stale, conflict ou blocked (409), ou internal (500).
messagestringfacultatif
Une explication lisible de l'erreur.
retryablebooleanfacultatif
true lorsque la même requête peut réussir si vous la renvoyez plus tard.
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.
404Les 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.
500La requête n'a pas pu aboutir à cause d'un problème de notre côté.
post/api/v1/work-management/approvals/bulk-decide
Votre clé API
Corps de la requête*
{}