Recuperar la aprobación de una herramienta
Recupera una llamada de herramienta retenida. Puedes verla cuando hiciste la solicitud a la que pertenece, o cuando la política de herramientas de tu organización te nombró como uno de sus aprobadores. Cualquier otra respuesta de aprobación devuelve un 404.
Autorizaciones
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
Optional external end-user identifier forwarded by the API gateway.
Parámetros de ruta
El ID del elemento de solicitud de aprobación (mcpr_... o tapr_...).
1 - 255Respuesta
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.
El ID del elemento de la solicitud de aprobación en la salida de la respuesta (mcpr_... o tapr_...).
El tipo del elemento de solicitud de aprobación: mcp_approval_request para una llamada MCP, tool_approval_request para una herramienta integrada.
mcp_approval_request, tool_approval_request 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.
pending, approved, denied, expired El tipo de la herramienta mantenida: mcp, o un tipo de herramienta integrado como web_search o code_interpreter.
El nombre de la herramienta que el modelo llamó.
Solo llamadas MCP: la etiqueta del servidor MCP.
Los argumentos con los que se ejecuta la llamada si se aprueba.
La respuesta que se detuvo para esta aprobación.
El agente guardado para el que se ejecutó la solicitud, si lo hay.
Quién hizo la solicitud cuya llamada a herramienta fue retenida. Solo este llamador puede continuar la respuesta.
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.
Quién decidió: ¿el aprobador, o el solicitante de una aprobación sin aprobadores?
El comentario o motivo dado junto con la decisión.
Si la continuación del llamador ha consumido la decisión. Una llamada aprobada se ejecuta solo cuando esto ocurre, y solo una vez.
Cuando se realizó la llamada.
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.
Cuando se tomó la decisión.