Skip to content
UltimateTeam.ai Docs

Activate Kill Switch

POST
/api/v1/admin/kill-switch

Activate the emergency kill switch.

Halts all agent execution for a specific tenant or globally. Requires platform-operator access.

Authorizations

Request Body required

Request body for activating the kill switch.

Attributes: tenant_id: Optional tenant to halt. If omitted, a global halt is activated. reason: Required human-readable reason for the halt.

object
reason
required

Reason for the emergency halt (min 10 chars).

string
>= 10 characters
tenant_id
Any of:
string

Responses

200

Successful Response

Response body for kill switch operations.

Attributes: action: The action performed (halt, resume, status). scope: Whether the action is tenant-scoped or global. tenant_id: The tenant affected (None for global). active: Whether the kill switch is currently active. reason: The halt reason (empty if not active).

object
action
required
string
active
required
boolean
reason
string
""
scope
required
string
tenant_id
Any of:
string

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string