Pular para o conteúdo principal
POST
CSharp (SDK)

Autorizações

Authorization
string
header
obrigatório

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

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parâmetros de caminho

approval_id
string
obrigatório

O ID do item da solicitação de aprovação (mcpr_... ou tapr_...).

Required string length: 1 - 255

Corpo

application/json
decision
enum<string>
obrigatório

approve permite que a continuação do chamador execute a chamada; deny permite apenas registrar a negação.

Opções disponíveis:
approve,
deny
comment
string

Por quê, mostrado ao solicitante e registrado no livro-razão de auditoria.

Maximum string length: 2000

Resposta

200 - application/json

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.

object
any
obrigatório
id
string
obrigatório

O ID do item da solicitação de aprovação na saída da resposta (mcpr_... ou tapr_...).

kind
enum<string>
obrigatório

O tipo do item de solicitação de aprovação: mcp_approval_request para uma chamada MCP, tool_approval_request para uma ferramenta integrada.

Opções disponíveis:
mcp_approval_request,
tool_approval_request
status
enum<string>
obrigatório

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.

Opções disponíveis:
pending,
approved,
denied,
expired
tool_type
string
obrigatório

O tipo da ferramenta mantida: mcp, ou um tipo de ferramenta integrada como web_search ou code_interpreter.

tool_name
string
obrigatório

O nome da ferramenta que o modelo chamou.

server_label
string | null
obrigatório

Chamadas MCP apenas: o rótulo do servidor MCP.

arguments
object
obrigatório

Os argumentos com os quais a chamada é executada se for aprovada.

response_id
string
obrigatório

A resposta que foi interrompida para esta aprovação.

agent_id
string | null
obrigatório

O agente salvo para o qual a solicitação foi executada, se houver.

requested_by
Tool approval requester · object
obrigatório

Quem fez a solicitação cuja chamada de ferramenta foi retida. Somente esse solicitante pode continuar a resposta.

approver_user_ids
string[]
obrigatório

Os usuários que a política de ferramentas da organização nomeou para decidir esta chamada. Vazio quando o chamador decide.

decided_by_user_id
string | null
obrigatório

Quem decidiu: o aprovador ou o solicitante em uma aprovação sem aprovadores.

comment
string | null
obrigatório

O comentário ou motivo fornecido com a decisão.

claimed
boolean
obrigatório

Se a continuação do chamador consumiu a decisão. Uma chamada aprovada só é executada quando isso acontece, e apenas uma vez.

created_at
string<date-time>
obrigatório

Quando a ligação foi realizada.

expires_at
string<date-time>
obrigatório

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.

decided_at
string<date-time> | null
obrigatório

Quando a decisão foi tomada.