Saltar al contenido principal
POST
Solicitar aprobación de agente
Registra una solicitud de revisión humana independiente. No ejecuta una acción de agente, no otorga permisos ni pausa o reanuda automáticamente un flujo de trabajo temporal. Consulte revisiones de agentes independientes para conocer los límites de autorización y ejecución.

Autorizaciones

X-API-Key
string
header
requerido

Cuerpo

application/json
agent_id
string
requerido

Un agente activo y no comprometido en este entorno de espacio de trabajo autenticado.

action
string
requerido

La acción prevista; 1–200 bytes UTF-8. La creación de una solicitud no la ejecuta.

resource
string
requerido

Recurso objetivo específico; 1–2000 bytes UTF-8.

scope
string
requerido

Permiso previsto; 1–200 bytes UTF-8. No concede acceso.

justification
string

Evidencia de apoyo y propósito; como máximo 4000 bytes UTF-8. Nunca incluya secretos.

risk_level
enum<string>
predeterminado:medium
Opciones disponibles:
low,
medium,
high,
critical
required_approvals
integer
predeterminado:1

Revisores humanos autorizados distintos; solicitante excluido.

Rango requerido: 1 <= x <= 10
ttl_minutes
integer
predeterminado:60
Rango requerido: 1 <= x <= 10080

Respuesta

Resultado registrado

id
string<uuid>
requerido
agent_id
string
requerido
requested_by
string
requerido

Solicitante autenticado: UUID de usuario humano o api_key:; nunca un revisor proporcionado por el llamador.

status
enum<string>
requerido
Opciones disponibles:
pending,
approved,
rejected,
expired,
cancelled
expires_at
string<date-time>
requerido
required_approvals
integer
requerido
Rango requerido: 1 <= x <= 10
current_approvals
integer
requerido
Rango requerido: 0 <= x <= 10
decisions
object[]
requerido

Revisiones individuales inmutables. La respuesta de la cola lo deja vacío; obtenga la solicitud para su historial de revisión completo.

tenant_id
string<uuid>
action
string
resource
string
scope
string
justification
string
decision_reason
string
risk_level
enum<string>
Opciones disponibles:
low,
medium,
high,
critical
created_at
string<date-time>
updated_at
string<date-time>
decided_at
string<date-time>
decided_by
string

Revisor final o solicitante que cancela la solicitud; ausente mientras está pendiente.