v1Recursos/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-decideCuerpo de la solicitud
idempotencyKeystringobligatorio
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)obligatorio
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.
reasonstringopcional
Why you decided, up to 2,000 characters. Required when decision is reject; not used when approving.
itemsarray of unknownobligatorio
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.
Respuesta
okbooleanopcional
Siempre true en una respuesta correcta.
appliedintegeropcional
How many items succeeded, replays included.
failedintegeropcional
How many items failed. Each one is in results with its code and message.
resultsarray of objectopcional
One result per item, in the order you sent them.
idempotencyKeystringopcional
The idempotency key used for this item: your idempotencyKey followed by :<item id>.
itemKeystringopcional
La clave de la tarea, con el formato task:<id>.
okbooleanopcional
Siempre true en una respuesta correcta.
replayedbooleanopcional
true cuando esta respuesta repite una solicitud anterior con el mismo idempotencyKey, por lo que no se guardó nada nuevo.
codestringopcional
Qué falló: invalid (400), forbidden (403), not_found (404), stale, conflict o blocked (409), o internal (500).
messagestringopcional
Una explicación legible del error.
retryablebooleanopcional
true cuando la misma solicitud puede funcionar si la vuelves a enviar más tarde.
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.
404Los 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.
500No se pudo completar la solicitud por un problema de nuestra parte.
post/api/v1/work-management/approvals/bulk-decide
Su clave de API
Cuerpo de la solicitud*
{}