Saltar al contenido principal
POST
Suspender agente

Suspender Agente

POST /v1/agents/{agentID}/suspend Suspende la identidad de un agente de máquina, impidiéndole inmediatamente crear nuevas sesiones, invocar herramientas o realizar cualquier operación autenticada. La suspensión es reversible: el agente puede reactivarse actualizando su estado a "active" a través del punto final de actualización. Todas las sesiones activas pertenecientes al agente suspendido están efectivamente bloqueadas en la capa de control de acceso. Los tokens de sesión existentes fallarán las comprobaciones de alcance hasta que el agente se reactive.
La suspensión es la primera respuesta recomendada para el comportamiento anómalo del agente. Utilice revocar solo cuando sea permanente se requiere la desmantelación.

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 "suspended" en caso de éxito.
string
El identificador de agente MAIP que fue suspendido.

Ejemplo


Reactivación de un agente suspendido

Para restaurar un agente suspendido a estado activo, use el endpoint PATCH /v1/agents/:

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 suspensión legible por humanos

Respuesta

Agente suspendido

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>