Saltar para o conteúdo principal
POST
Suspender Agente

Suspender Agente

POST /v1/agents/{agentID}/suspend Suspende uma identidade de agente de máquina, impedindo-o imediatamente de criar novas sessões, invocar ferramentas ou realizar quaisquer operações autenticadas. A suspensão é reversível — o agente pode ser reativado atualizando seu status de volta para "active" através do endpoint de atualização. Todas as sessões ativas pertencentes ao agente suspenso são efetivamente bloqueadas na camada de controle de acesso. Os tokens de sessão existentes falharão nas verificações de escopo até que o agente seja reativado.
A suspensão é a primeira resposta recomendada para comportamento anômalo do agente. Use revogar apenas quando permanente descomissionamento é necessário.

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 "suspended" em caso de sucesso.
string
O identificador do agente MAIP que foi suspenso.

Exemplo


Reativando um Agente Suspenso

Para restaurar um agente suspenso para o status ativo, use o endpoint PATCH /v1/agents/:

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 suspensão

Resposta

Agente suspenso

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>