> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Revisiones de agentes independientes

> Solicite una revisión humana, recopile decisiones distintas y aplique el resultado final en su aplicación.

Las aprobaciones de agente registran decisiones humanas sobre una acción de agente propuesta en un entorno de espacio de trabajo. Son independientes de las aprobaciones del motor de flujo de trabajo, las concesiones de permisos, los recibos de acciones criptográficas y la ejecución temporal.

## Antes de empezar

* Usar un agente activo del mismo espacio de trabajo y entorno que su credencial.
* Cree solicitudes utilizando una clave API del espacio de trabajo o un usuario del espacio de trabajo con sesión iniciada.
* Los revisores deben ser miembros humanos activos del espacio de trabajo con el permiso `tenant:governance:approve` a nivel de espacio de trabajo. Un rol solo de organización es insuficiente.
* El solicitante no puede aprobar o rechazar su propia solicitud. Cada revisor puede decidir una vez. Las claves API no pueden emitir votos humanos.

En Console, abra **Agentes de IA → Aprobaciones de Agentes**. Los formularios de solicitud, revisión y cancelación tienen cada uno una página dedicada. Guarde el enlace de la solicitud para volver a ella después de que salga de la cola pendiente.

## Crear una solicitud

Este ejemplo solicita dos aprobaciones independientes en una ventana de una hora. Reemplace el identificador del agente con un agente de sandbox existente; un agente de producción no se puede usar con una credencial de sandbox.

```bash theme={null}
curl --fail-with-body https://sandbox-api.truthlocks.com/v1/approvals \
  -H "X-API-Key: $TRUTHLOCKS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "agent_id": "YOUR_SANDBOX_AGENT_ID",
    "action": "publish reviewed report",
    "resource": "reports/quarterly-review",
    "scope": "reports:publish",
    "risk_level": "high",
    "justification": "The report has completed technical review. Confirm the approved version before publication.",
    "required_approvals": 2,
    "ttl_minutes": 60
  }'
```

La respuesta `201` contiene `id`, `requested_by`, `status: "pending"`, `current_approvals: 0` y `expires_at`. Guarde `id`; la creación no publica el informe ni crea un flujo de trabajo en segundo plano.

## Revisar con una sesión humana

Use Console para decisiones interactivas. Si su integración utiliza la API, proporcione la sesión de portador del espacio de trabajo de corta duración del revisor. No sustituya una clave de API ni incruste un token de sesión en el código fuente.

```bash theme={null}
curl --fail-with-body "https://sandbox-api.truthlocks.com/v1/approvals/$APPROVAL_ID/approve" \
  -H "Authorization: Bearer $TRUTHLOCKS_REVIEWER_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"reason":"Reviewed the exact report version and its supporting evidence."}'
```

La primera aprobación en este ejemplo devuelve `status: "pending"` y `current_approvals: 1`. Un revisor autorizado diferente debe proporcionar el segundo voto. Reutilizar el mismo revisor devuelve un conflicto. Un rechazo cambia inmediatamente la solicitud a `rejected` independientemente de las aprobaciones anteriores.

El servicio verifica los permisos de membresía actuales, la propiedad de la solicitud, la caducidad y los votos existentes dentro de la transacción de decisión. Los votos y el evento de auditoría se confirman juntos. Las decisiones no se pueden editar ni eliminar a través de estas API.

## Verificar y hacer cumplir el resultado

```bash theme={null}
curl --fail-with-body "https://sandbox-api.truthlocks.com/v1/approvals/$APPROVAL_ID" \
  -H "X-API-Key: $TRUTHLOCKS_API_KEY"
```

La respuesta detallada incluye el historial del revisor. Proceda solo cuando `status` sea `approved` y la solicitud aún coincida con el agente, la acción, el recurso y el alcance exactos que su aplicación pretende usar. Su aplicación también debe hacer cumplir los permisos de acceso actuales, el estado del agente y sus propios controles de un solo uso o de repetición. Estos registros de aprobación no proporcionan un mecanismo automático de ejecución o consumo.

| Estado | Significado |
| - | - |
| `pending` | Se requieren más aprobaciones independientes. |
| `approved` | Se alcanzó el quórum configurado dentro de la ventana de revisión. |
| `rejected` | Un revisor independiente rechazó la solicitud. |
| `expired` | Una solicitud pendiente superó su fecha límite de revisión. |
| `cancelled` | Su solicitante original lo canceló. |

La fecha límite de revisión limita cuándo se pueden enviar las decisiones. No convierte una solicitud ya aprobada en un token de acceso que caduca. Defina cualquier fecha límite de ejecución en su propia aplicación.

## Cola, cancelación y errores

`GET /v1/approvals` devuelve una matriz de como máximo 100 solicitudes pendientes más antiguas y no vencidas. No tiene paginación ni filtro de estado histórico. La cola omite el historial de decisiones individuales; obtenga una solicitud por ID para ese historial.

El solicitante original puede enviar `POST /v1/approvals/{approvalID}/cancel` con un `reason` no vacío. Una solicitud no puede reabrirse después de su cancelación, rechazo, aprobación o vencimiento. Cree una nueva solicitud si la acción propuesta cambia.

| Estado HTTP | Qué verificar |
| - | - |
| `400` | Límites de campo, un ID de solicitud UUID y una razón de decisión no en blanco. |
| `403` | Permiso de revisor del espacio de trabajo actual, auto-revisión del solicitante, votación con clave API o propiedad de cancelación. |
| `404` | La solicitud o el agente activo pertenece al entorno de espacio de trabajo seleccionado. |
| `409` | La solicitud es final, ha caducado o esta persona ya votó. |

Estos registros respaldan su proceso de revisión; no establecen el cumplimiento de SOC 2, la certificación ISO, la verificación de documentos de identidad o la corrección de la evidencia presentada.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.