Saltar al contenido principal
POST
Revocar agente

Revocar Agente

POST /v1/agents/{agentID}/revoke Revoca permanentemente una identidad de agente de máquina. Esta es una operación irreversible que:
  1. Establece el estado del agente en "revoked"
  2. Invalida todas las sesiones activas.
  3. Bloquea todas las futuras invocaciones de la herramienta
  4. Impide que el agente se utilice en nuevas delegaciones
La revocación es permanente y no se puede deshacer. Si necesita temporalmente deshabilitar un agente, use el suspender endpoint en su lugar. Los agentes revocados los agentes permanecen en el sistema para fines de auditoría, pero no pueden ser reactivado.

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.

Respuesta

string
Estado actualizado, siempre "revoked" en caso de éxito.
string
El identificador de agente MAIP que fue revocado.

Ejemplo


Cuándo revocar vs. suspender

Después de revocar un agente, aún puede ver su historial completo a través de GET /v1/agents/ punto final. El registro del agente se retiene indefinidamente para el cumplimiento de auditorías (SOC 2 Tipo II, ISO 27001).

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Parámetros de ruta

agentId
string<uuid>
requerido

Identificador de agente

Cuerpo

application/json
reason
string
requerido

Razón de revocación legible por humanos

Respuesta

Agente revocado

id
string<uuid>
agent_type
enum<string>
Opciones disponibles:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
Opciones disponibles:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
Rango requerido: 0 <= x <= 1
public_key
string

Clave pública codificada en Base64

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