Saltar para o conteúdo principal
POST
Solicitar aprovação do agente
Registra uma solicitação de revisão humana independente. Não executa uma ação de agente, não concede permissões nem pausa ou retoma automaticamente um fluxo de trabalho Temporal. Consulte revisões de agentes independentes para os limites de autorização e execução.

Autorizações

X-API-Key
string
header
obrigatório

Corpo

application/json
agent_id
string
obrigatório

Um agente ativo e não comprometido neste ambiente de espaço de trabalho autenticado.

action
string
obrigatório

A ação pretendida; 1–200 bytes UTF-8. Criar uma solicitação não a executa.

resource
string
obrigatório

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

scope
string
obrigatório

Permissão pretendida; 1–200 bytes UTF-8. Não concede acesso.

justification
string

Evidências de suporte e propósito; no máximo 4000 bytes UTF-8. Nunca inclua segredos.

risk_level
enum<string>
padrão:medium
Opções disponíveis:
low,
medium,
high,
critical
required_approvals
integer
padrão:1

Revisores humanos autorizados distintos; solicitante excluído.

Intervalo necessário: 1 <= x <= 10
ttl_minutes
integer
padrão:60
Intervalo necessário: 1 <= x <= 10080

Resposta

Resultado registrado

id
string<uuid>
obrigatório
agent_id
string
obrigatório
requested_by
string
obrigatório

Solicitante autenticado: UUID de usuário humano ou api_key:; nunca um revisor fornecido pelo chamador.

status
enum<string>
obrigatório
Opções disponíveis:
pending,
approved,
rejected,
expired,
cancelled
expires_at
string<date-time>
obrigatório
required_approvals
integer
obrigatório
Intervalo necessário: 1 <= x <= 10
current_approvals
integer
obrigatório
Intervalo necessário: 0 <= x <= 10
decisions
object[]
obrigatório

Revisões individuais imutáveis. A resposta da fila deixa isso vazio; obtenha a solicitação para seu histórico completo de revisões.

tenant_id
string<uuid>
action
string
resource
string
scope
string
justification
string
decision_reason
string
risk_level
enum<string>
Opções disponíveis:
low,
medium,
high,
critical
created_at
string<date-time>
updated_at
string<date-time>
decided_at
string<date-time>
decided_by
string

Revisor final ou requerente a cancelar o pedido; ausente enquanto pendente.