Aprobaciones de operación
Lo que pasó con una operación enviada a aprobación por enlace. Dos tools de solo lectura, disponibles para todo cliente conectado: solo informan — ninguna aprueba, cancela ni reabre una aprobación.
Una tool destructiva llamada por un cliente que no puede confirmar en el chat responde approval_required con un approval.id y una URL. Muestra la URL a la persona y no vuelvas a llamar la tool. Cuando la persona diga que eligió Continuar o Cancelar, llama operation_approvals_get con ese approval.id — una vez, no en bucle.
Las dos tools ven solo tus propias aprobaciones — las de la persona del token — en la organización del token y en el workspace de la conexión. No exigen scope de recurso específico ni permiso — el dato es tuyo —, pero, a diferencia de me, el token necesita alcance: algún scope inbox/… o un all suelto (si no, INSUFFICIENT_SCOPE con details.required: ["inbox/all"]). Pero el resultado (result, error) es dato del recurso: solo aparece cuando el token alcanza ese recurso y todavía tienes su permiso de lectura; si no, se retiene y result_hidden es true.
operation_approvals_get
Lectura · alcance (algún
inbox/…oall) · sin permiso · miembro activo ·GET /operation-approvals/{id}
Una aprobación, por el approval.id de la respuesta approval_required. La aprobación de otra persona, de otra organización o un id que no existe responden el mismo NOT_FOUND — la tool no revela que existe.
| Parámetro | Tipo | Descripción |
|---|---|---|
id obligatorio | string (uuid) | El approval.id de la respuesta approval_required. |
{
"data": {
"id": "2b0f8c1e-…",
"status": "executed",
"action": "webhooks_regenerate_secret",
"title": "Rotar el secreto de firma del webhook",
"resource": "webhooks",
"operation": "regenerate_secret",
"requested_at": "2026-10-31T12:00:00.000Z",
"expires_at": "2026-10-31T12:15:00.000Z",
"decided_at": "2026-10-31T12:03:10.000Z",
"executed_at": "2026-10-31T12:03:10.400Z",
"error": null,
"result": { "data": { "id": "…", "signing_secret": "[redacted]" } },
"result_hidden": false
}
}
| Campo | Significado |
|---|---|
status | pending, approved (se eligió Continuar y aún se está ejecutando), executed, failed, declined (Cancelar) o expired. Una pendiente después de expires_at ya sale como expired. |
action | La tool pedida. |
title | La operación, como la nombra la pantalla de aprobación, en el idioma de la solicitud (Accept-Language; portugués por defecto, inglés o español). |
resource / operation | Sobre qué actúa la operación y qué hace ahí. |
requested_at / expires_at / decided_at / executed_at | Cuándo se pidió, hasta cuándo valía el enlace, cuándo decidió la persona y cuándo se ejecutó. |
error | { code, message } cuando failed — p. ej. SUBJECT_CHANGED cuando el registro cambió después de mostrarse la pantalla; null en los demás casos. |
result | Lo que devolvió la tool cuando executed, con todo secreto enmascarado ([redacted]): un secreto de un solo uso se muestra una sola vez, en la pantalla de aprobación. null en los demás casos. |
| result_hidden | true cuando este token no puede leer el recurso de la aprobación (inbox/<recurso> — p. ej. inbox/webhooks para webhooks_regenerate_secret — o un nivel de acceso que lo alcance) — y, como en toda lectura, todavía tienes el permiso de lectura de ese recurso (<recurso>.show) en la organización. Si no, result y error son null, pase lo que pase. Los demás campos se muestran. |
El enlace de la aprobación, su token y la tarjeta que vio la persona nunca se devuelven.
operation_approvals_list
Lectura · alcance (algún
inbox/…oall) · sin permiso · miembro activo ·GET /operation-approvals
Tus aprobaciones en el workspace, de la más reciente a la más antigua, con los mismos campos de operation_approvals_get. Paginada por página: { data, meta: { total, page, per_page, total_pages } }.
| Parámetro | Tipo | Descripción |
|---|---|---|
status | string | Solo aprobaciones en este estado: pending, approved, executed, failed, declined o expired (una pendiente vencida cuenta como expired, no pending). |
created_after | string | Pedidas en este instante ISO 8601 o después. |
created_before | string | Pedidas en este instante ISO 8601 o antes. |
page | integer | Número de página, por defecto 1. |
per_page | integer | Tamaño de página, por defecto 25, máximo 100. |