Skip to content
deedglassdocs

Overview

Agents

Section titled “Agents”

Agents, their API keys, Stop and Stop all (docs/AGENTS.md). Control-plane routes accept a Console session (by role) or an org admin key (admin scope). Agent keys get 403 insufficient_scope on all of them: no agent key changes any agent, including its own. A 401 carries WWW-Authenticate: Bearer realm="deedglass", error="invalid_token", error_description="…"; a 403 insufficient_scope carries WWW-Authenticate: Bearer realm="deedglass", error="insufficient_scope", scope="…". Every change seals an admin deed.

Operations

Section titled “Operations”
GET
/v1/agents
POST
/v1/agents
GET
/v1/agents/{id}
PATCH
/v1/agents/{id}
POST
/v1/agents/{id}/suspend
POST
/v1/agents/{id}/resume
POST
/v1/agents/{id}/stop
POST
/v1/agents/{id}/start
GET
/v1/agents/{id}/keys
POST
/v1/agents/{id}/keys
GET
/v1/agents/{id}/intent-keys
POST
/v1/agents/{id}/intent-keys
DELETE
/v1/agents/{id}/intent-keys/{kid}
POST
/v1/keys/{id}/roll
POST
/v1/keys/{id}/revoke
POST
/v1/org/stop-all
POST
/v1/org/start-all
GET
/v1/org/keys
POST
/v1/org/keys
GET
/v1/whoami