Skip to main content
POST
Emergency Kill Switch
Use this endpoint for an emergency such as a compromised agent. Supply the agent identifier and a nonempty incident reason (maximum 2000 UTF-8 bytes). The authenticated workspace and environment determine which agent you can revoke. The operation revokes the agent and its delegated descendants, terminates their active sessions, revokes their active delegation links, and persists the decision in one database transaction. If that transaction fails, its state changes are rolled back.
Revocation is permanent. Register a new agent if work needs to resume. Previously issued receipt evidence is preserved; this endpoint does not erase or rewrite it.

Check the result

A successful response has status: "killed". agents_changed includes the requested agent; cascade_count counts newly revoked descendants. sessions_terminated and delegations_revoked report the affected sessions and delegation links. When managed signing succeeds, receipt_status is signed and receipt_id identifies a signed revocation receipt. Retrieve it through the receipts API. Signature validity and the revoked agent’s lifecycle status are separate checks. When signing is unavailable, revocation still succeeds: receipt_status is unavailable and receipt_id is null. The durable revocation decision remains recorded. No signed receipt or automatic signing retry is implied by that response.

Audit behavior

The service records an agent.killed event and a revocation event alongside the state changes. A response does not establish external transparency anchoring, webhook delivery, or SIEM delivery. Verify those channels separately if your incident process depends on them. An unknown agent in the selected workspace environment returns 404. An already revoked agent returns 409. Review the existing state before retrying an emergency request.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

agentId
string
required

Agent identifier

Body

application/json
reason
string
required

Nonempty incident reason, at most 2000 UTF-8 bytes

Required string length: 1 - 2000

Response

Agent killed

agent_id
string
tenant_id
string<uuid>
status
enum<string>
Available options:
killed
agents_changed
integer
cascade_count
integer

Descendant agents newly revoked, excluding the requested agent.

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

Signed revocation receipt identifier, or null when signing was unavailable.

receipt_status
enum<string>

Unavailable does not undo the completed emergency revocation.

Available options:
signed,
unavailable