Passer au contenu principal
POST
Interrupteur d'urgence
Utilisez ce point de terminaison pour une urgence telle qu’un agent compromis. Fournissez l’identifiant de l’agent et un incident non vide reason (maximum 2000 octets UTF-8). L’espace de travail et l’environnement authentifiés déterminent quel agent vous pouvez révoquer. L’opération révoque l’agent et ses descendants délégués, met fin à leurs sessions actives, révoque leurs liens de délégation actifs et persiste la décision dans une seule transaction de base de données. Si cette transaction échoue, ses modifications d’état sont annulées.
La révocation est permanente. Enregistrez un nouvel agent si le travail doit reprendre. Les preuves de reçus précédemment émises sont conservées ; ce point de terminaison ne les efface ni ne les réécrit.

Vérifier le résultat

Une réponse réussie contient status: "killed". agents_changed inclut l’agent demandé ; cascade_count compte les descendants nouvellement révoqués. sessions_terminated et delegations_revoked signalent les sessions et les liens de délégation affectés. Lorsque la signature gérée réussit, receipt_status est signed et receipt_id identifie un reçu de révocation signé. Récupérez-le via l’API des reçus. La validité de la signature et l’état du cycle de vie de l’agent révoqué sont des vérifications distinctes. Lorsque la signature n’est pas disponible, la révocation réussit toujours : receipt_status est unavailable et receipt_id est null. La décision de révocation durable reste enregistrée. Aucun reçu signé ou nouvelle tentative de signature automatique n’est impliqué par cette réponse.

Comportement d’audit

Le service enregistre un événement agent.killed et un événement de révocation parallèlement aux changements d’état. Une réponse n’établit pas d’ancrage de transparence externe, de livraison de webhook ou de livraison SIEM. Vérifiez ces canaux séparément si votre processus d’incident en dépend. Un agent inconnu dans l’environnement d’espace de travail sélectionné renvoie 404. Un agent déjà révoqué renvoie 409. Examinez l’état existant avant de retenter une demande d’urgence.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Paramètres de chemin

agentId
string
requis

Identifiant de l'agent

Corps

application/json
reason
string
requis

Raison de l'incident non vide, au maximum 2000 octets UTF-8

Required string length: 1 - 2000

Réponse

Agent tué

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

Agents descendants nouvellement révoqués, à l'exclusion de l'agent demandé.

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

Identifiant du reçu de révocation signé, ou nul si la signature n'était pas disponible.

receipt_status
enum<string>

Indisponible n'annule pas la révocation d'urgence terminée.

Options disponibles:
signed,
unavailable