Saltar al contenido principal
GET
CSharp (SDK)

Autorizaciones

Authorization
string
header
requerido

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.

Encabezados

X-On-Behalf-Of
string

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

Parámetros de ruta

approval_id
string
requerido

El ID del elemento de solicitud de aprobación (mcpr_... o tapr_...).

Required string length: 1 - 255

Respuesta

200 - application/json

Está bien

Una llamada de herramienta retenida para aprobación. Las aprobaciones que nombran aprobadores permanecen listadas durante 30 días después de que se deciden o caducan; las demás se eliminan en su fecha límite.

object
any
requerido
id
string
requerido

El ID del elemento de la solicitud de aprobación en la salida de la respuesta (mcpr_... o tapr_...).

kind
enum<string>
requerido

El tipo del elemento de solicitud de aprobación: mcp_approval_request para una llamada MCP, tool_approval_request para una herramienta integrada.

Opciones disponibles:
mcp_approval_request,
tool_approval_request
status
enum<string>
requerido

pendiente hasta que un aprobador decida, o, en el caso de una aprobación sin aprobadores, hasta que la continuación del llamador la responda. caducada cuando se superó el plazo sin una decisión.

Opciones disponibles:
pending,
approved,
denied,
expired
tool_type
string
requerido

El tipo de la herramienta mantenida: mcp, o un tipo de herramienta integrado como web_search o code_interpreter.

tool_name
string
requerido

El nombre de la herramienta que el modelo llamó.

server_label
string | null
requerido

Solo llamadas MCP: la etiqueta del servidor MCP.

arguments
object
requerido

Los argumentos con los que se ejecuta la llamada si se aprueba.

response_id
string
requerido

La respuesta que se detuvo para esta aprobación.

agent_id
string | null
requerido

El agente guardado para el que se ejecutó la solicitud, si lo hay.

requested_by
Tool approval requester · object
requerido

Quién hizo la solicitud cuya llamada a herramienta fue retenida. Solo este llamador puede continuar la respuesta.

approver_user_ids
string[]
requerido

Los usuarios a los que la política de herramientas de la organización nombra para decidir esta llamada. Vacío cuando el llamante decide.

decided_by_user_id
string | null
requerido

Quién decidió: ¿el aprobador, o el solicitante de una aprobación sin aprobadores?

comment
string | null
requerido

El comentario o motivo dado junto con la decisión.

claimed
boolean
requerido

Si la continuación del llamador ha consumido la decisión. Una llamada aprobada se ejecuta solo cuando esto ocurre, y solo una vez.

created_at
string<date-time>
requerido

Cuando se realizó la llamada.

expires_at
string<date-time>
requerido

El plazo para el siguiente paso: la decisión mientras está pendiente, luego la continuación del llamante. Una decisión le da al llamante 24 horas.

decided_at
string<date-time> | null
requerido

Cuando se tomó la decisión.