Decida a aprovação da ferramenta
Aprove ou negue uma chamada de ferramenta retida como um de seus aprovadores. Você deve estar autenticado pessoalmente: chaves de API e chamadas em nome de um usuário final são recusadas. A decisão não executa a ferramenta. O chamador que fez a solicitação tem 24 horas para continuar sua resposta com uma resposta de aprovação contendo a mesma decisão, o que executa uma chamada aprovada uma vez. Repetir sua própria decisão retorna a aprovação inalterada; uma decisão tomada por outra pessoa, ou uma que difira da sua, responde com 409 tool_approval_already_decided, e uma aprovação após seu prazo responde com 409 tool_approval_expired.
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.
Parâmetros de caminho
O ID do item da solicitação de aprovação (mcpr_... ou tapr_...).
1 - 255Corpo
Resposta
OK
Uma chamada de ferramenta ficou aguardando aprovação. As aprovações que nomeiam aprovadores permanecem listadas por 30 dias após serem decididas ou expirarem; as demais são removidas no prazo final.
O ID do item da solicitação de aprovação na saída da resposta (mcpr_... ou tapr_...).
O tipo do item de solicitação de aprovação: mcp_approval_request para uma chamada MCP, tool_approval_request para uma ferramenta integrada.
mcp_approval_request, tool_approval_request pendente até que um aprovador decida ou, no caso de uma aprovação sem aprovadores, até que a continuação do chamador responda. expirado quando o prazo passou sem uma decisão.
pending, approved, denied, expired O tipo da ferramenta mantida: mcp, ou um tipo de ferramenta integrada como web_search ou code_interpreter.
O nome da ferramenta que o modelo chamou.
Chamadas MCP apenas: o rótulo do servidor MCP.
Os argumentos com os quais a chamada é executada se for aprovada.
A resposta que foi interrompida para esta aprovação.
O agente salvo para o qual a solicitação foi executada, se houver.
Quem fez a solicitação cuja chamada de ferramenta foi retida. Somente esse solicitante pode continuar a resposta.
Os usuários que a política de ferramentas da organização nomeou para decidir esta chamada. Vazio quando o chamador decide.
Quem decidiu: o aprovador ou o solicitante em uma aprovação sem aprovadores.
O comentário ou motivo fornecido com a decisão.
Se a continuação do chamador consumiu a decisão. Uma chamada aprovada só é executada quando isso acontece, e apenas uma vez.
Quando a ligação foi realizada.
O prazo para a próxima etapa: a decisão, enquanto pendente, então a continuação do solicitante. Uma decisão dá ao solicitante 24 horas.
Quando a decisão foi tomada.