Saltar para o conteúdo principal
POST
Revogar Agente

Revogar Agente

POST /v1/agents/{agentID}/revoke Revoga permanentemente uma identidade de agente de máquina. Esta é uma operação irreversível que:
  1. Define o status do agente para "revoked"
  2. Invalida todas as sessões ativas
  3. Bloqueia todas as futuras invocações da ferramenta
  4. Impede que o agente seja usado em novas delegações
A revogação é permanente e não pode ser desfeita. Se você precisar temporariamente desativar um agente, use o suspender endpoint em vez disso. Agentes revogados agentes permanecem no sistema para fins de trilha de auditoria, mas não podem ser reativado.

Autenticação

Requer cabeçalho X-API-Key ou token JWT de portador. O espaço de trabalho é derivado da credencial autenticada; não envie X-Tenant-ID.

Resposta

string
Status atualizado, sempre "revoked" em caso de sucesso.
string
O identificador do agente MAIP que foi revogado.

Exemplo


Quando Revogar vs. Suspender

Após revogar um agente, você ainda pode visualizar seu histórico completo via GET /v1/agents/ endpoint. O registro do agente é retido indefinidamente para conformidade de auditoria (SOC 2 Tipo II, ISO 27001).

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Parâmetros de caminho

agentId
string<uuid>
obrigatório

Identificador do agente

Corpo

application/json
reason
string
obrigatório

Razão legível por humanos para a revogação

Resposta

Agente revogado

id
string<uuid>
agent_type
enum<string>
Opções disponíveis:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
Opções disponíveis:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
Intervalo necessário: 0 <= x <= 1
public_key
string

Chave pública codificada em Base64

session_count
integer
keys
object[]
created_at
string<date-time>
updated_at
string<date-time>