Freeze an agent — blocks all relay traffic to/from the agent

curl --request POST \ --url https://api.swarmd.ai/registry/v1/kill-switches/agents/{agentId} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "reason": "<string>" } '

{ "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "scope": "<string>", "targetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "targetName": "<string>", "tenantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "reason": "<string>", "createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "createdAt": "2023-11-07T05:31:56Z" }

Auth Types	Entities	Permissions	Required Roles
USER	REGISTRY	WRITE	REGISTRY:WRITE

Authorizations

Authorization

string

header

required

JWT token (USER, AGENT, or SERVICE auth)

Path Parameters

agentId

string<uuid>

required

Body

application/json

reason

string

Maximum string length: 500

Response

200 - */*

string<uuid>

scope

string

targetId

string<uuid>

targetName

string

tenantId

string<uuid>

reason

string

createdBy

string<uuid>

createdAt

string<date-time>