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-decideCorpo da solicitação
idempotencyKeystringobrigatório
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)obrigatório
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 unknownobrigatório
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.
Resposta
okbooleanopcional
Sempre true em uma resposta bem-sucedida.
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
A chave da tarefa, no formato task:<id>.
okbooleanopcional
Sempre true em uma resposta bem-sucedida.
replayedbooleanopcional
true quando esta resposta repete uma solicitação anterior com o mesmo idempotencyKey, então nada novo foi salvo.
codestringopcional
O que deu errado: invalid (400), forbidden (403), not_found (404), stale, conflict ou blocked (409), ou internal (500).
messagestringopcional
Uma explicação legível do erro.
retryablebooleanopcional
true quando a mesma requisição pode funcionar se você a enviar de novo mais tarde.
Erros
400Os erros de Tarefas e aprovações retornam ok: false com um objeto error contendo code, message, retryable e details. Os erros da própria verificação da chave de API (chave ausente ou inválida, scope ausente, limite de requisições) usam o formato padrão, em que error é uma string.
401Chave de API ausente, inválida, expirada ou revogada.
403Os erros de Tarefas e aprovações retornam ok: false com um objeto error contendo code, message, retryable e details. Os erros da própria verificação da chave de API (chave ausente ou inválida, scope ausente, limite de requisições) usam o formato padrão, em que error é uma string.
404Os erros de Tarefas e aprovações retornam ok: false com um objeto error contendo code, message, retryable e details. Os erros da própria verificação da chave de API (chave ausente ou inválida, scope ausente, limite de requisições) usam o formato padrão, em que error é uma string.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
500Não foi possível concluir a requisição por um problema do nosso lado.
post/api/v1/work-management/approvals/bulk-decide
Sua chave de API
Corpo da solicitação*
{}