Admiral
Agents

Delete an agent

DELETE
/api/v1/agents/{agent_id}

Scope: agent:write

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (PAT) or Service Access Token (SAT). Pass the token in the Authorization header: Bearer admp_...

In: header

Path Parameters

agent_id*agent_id

The unique identifier of the agent to delete (UUID). All associated service access tokens will be revoked.

Formatuuid

Response Body

application/json

curl -X DELETE "https://api.admiral.io/api/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{}

Create an agent token POST

Use this to create additional SATs for an existing agent (e.g., for zero-downtime token rotation). The initial SAT is created automatically by CreateAgent. Scope: `agent:write`

Retrieve an agent GET

Returns the Agent record with its server-derived health_status. For detailed telemetry (capacity, node/workload counts), use GetAgentStatus instead. Scope: `agent:read`