Saltar al contenido principal
POST
Interruptor de emergencia
Utilice este endpoint para una emergencia, como un agente comprometido. Proporcione el identificador del agente y un incidente no vacío reason (máximo 2000 bytes UTF-8). El espacio de trabajo y el entorno autenticados determinan qué agente puede revocar. La operación revoca al agente y sus descendientes delegados, finaliza sus sesiones activas, revoca sus enlaces de delegación activos y persiste la decisión en una única transacción de base de datos. Si esa transacción falla, sus cambios de estado se revierten.
La revocación es permanente. Registre un nuevo agente si el trabajo necesita reanudarse. La evidencia de recibos emitida previamente se conserva; este endpoint no la borra ni la reescribe.

Comprobar el resultado

Una respuesta exitosa tiene status: "killed". agents_changed incluye el agente solicitado; cascade_count cuenta los descendientes recién revocados. sessions_terminated y delegations_revoked informan las sesiones afectadas y los enlaces de delegación. Cuando la firma gestionada tiene éxito, receipt_status es signed y receipt_id identifica un recibo de revocación firmado. Recupérelo a través de la API de recibos. La validez de la firma y el estado del ciclo de vida del agente revocado son verificaciones separadas. Cuando la firma no está disponible, la revocación aún tiene éxito: receipt_status es unavailable y receipt_id es null. La decisión de revocación duradera permanece registrada. Esa respuesta no implica un recibo firmado ni un reintento automático de firma.

Comportamiento de auditoría

El servicio registra un evento agent.killed y un evento de revocación junto con los cambios de estado. Una respuesta no establece el anclaje de transparencia externa, la entrega de webhook o la entrega de SIEM. Verifique esos canales por separado si su proceso de incidentes depende de ellos. Un agente desconocido en el entorno del espacio de trabajo seleccionado devuelve 404. Un agente ya revocado devuelve 409. Revise el estado existente antes de reintentar una solicitud de emergencia.

Autorizaciones

X-API-Key
string
header
requerido

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

Parámetros de ruta

agentId
string
requerido

Identificador de agente

Cuerpo

application/json
reason
string
requerido

Motivo del incidente no vacío, como máximo 2000 bytes UTF-8

Required string length: 1 - 2000

Respuesta

Agente eliminado

agent_id
string
tenant_id
string<uuid>
status
enum<string>
Opciones disponibles:
killed
agents_changed
integer
cascade_count
integer

Agentes descendientes recién revocados, excluyendo el agente solicitado.

sessions_terminated
integer
delegations_revoked
integer
reason
string
killed_at
string<date-time>
receipt_id
string | null

Identificador de recibo de revocación firmado, o nulo cuando la firma no estaba disponible.

receipt_status
enum<string>

No disponible no anula la revocación de emergencia completada.

Opciones disponibles:
signed,
unavailable