Aprovar ou negar as chamadas de ferramentas pendentes de uma execução
Responde às solicitações de aprovação para as quais uma execução foi interrompida e cria a execução que a continua. Uma execução que parou para aprovação tem status concluído e lista as chamadas retidas em pending_approvals: um mcp_approval_request para uma chamada de ferramenta MCP, um tool_approval_request para uma chamada de ferramenta integrada que a política de ferramentas da organização retém. Envie uma única decisão como o próprio corpo, ou várias em decisions. Uma solicitação deve decidir sobre todas as aprovações pendentes da execução, porque as chamadas deixadas de fora nunca poderão ser respondidas depois; caso contrário, a resposta é 409 com o código de erro approvals_incomplete. Uma aprovação expirada não precisa de decisão e é omitida da continuação. A decisão é de uso único e vinculada à ferramenta original e aos argumentos; uma chamada negada nunca é executada. Quando a política de ferramentas nomeia aprovadores para uma chamada, apenas eles a decidem na fila de aprovação: até que um o faça, a resposta é 409 com o código de erro tool_approval_pending, e uma decisão que difere da do aprovador é 409 com o código de erro tool_approval_decision_mismatch. Decisões que passam nessas verificações e ainda assim são recusadas aparecem como uma execução de continuação com falha, cujo error.code é um desses dois códigos. Uma execução cujas aprovações já tenham sido respondidas retorna 409 com o código de erro approvals_already_answered. Somente o chamador cuja execução foi retida pode respondê-la; um colega de equipe que consegue ler a execução recebe 403 com o código de erro not_run_caller. Chamadores com chave de API também precisam de read:responses, que é necessário para ler as aprovações.
Autorizações
Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.
Cabeçalhos
Optional external end-user identifier forwarded by the API gateway.
Corpo
Resposta
Decisões aceitas e execução de continuação criada.
agent.run.mcp_approval A solicitação de aprovação da primeira decisão. Mantida para clientes que enviam uma única decisão.
A primeira decisão.
Cada decisão que a execução de continuação carrega. Decisões para aprovações expiradas são omitidas.