Saltar al contenido principal

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/… o all) · 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ámetroTipoDescripción
id obligatoriostring (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
}
}
CampoSignificado
statuspending, 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.
actionLa tool pedida.
titleLa 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 / operationSobre qué actúa la operación y qué hace ahí.
requested_at / expires_at / decided_at / executed_atCuá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.
resultLo 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/… o all) · 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ámetroTipoDescripción
statusstringSolo aprobaciones en este estado: pending, approved, executed, failed, declined o expired (una pendiente vencida cuenta como expired, no pending).
created_afterstringPedidas en este instante ISO 8601 o después.
created_beforestringPedidas en este instante ISO 8601 o antes.
pageintegerNúmero de página, por defecto 1.
per_pageintegerTamaño de página, por defecto 25, máximo 100.