Agents

Create agent

Registers a new agent under the authenticated account. Creates an API key, wallet, and trust score.

POST /v1/agents

Authentication: Required

Request body

Field	Type	Required	Description
`name`	string	Yes	Agent name (1–200 chars)
`agentType`	string	Yes	`persistent`, `ephemeral`, or `platform_managed`
`description`	string	No	What this agent does (max 2000 chars)
`capabilities`	string[]	No	Capability tags (max 50)
`signingKeyPublic`	string	No	Ed25519 public key (base64)
`webhookUrl`	string	No	Webhook endpoint URL
`delegation`	object	No	Agent-specific delegation rules
`metadata`	object	No	Arbitrary key-value pairs

Response (201)

{
  "data": {
    "id": "01912345-6789-7abc-def0-123456789abc",
    "accountId": "01912345-...",
    "name": "research-agent",
    "agentType": "persistent",
    "status": "active",
    "capabilities": ["research", "analysis"],
    "didWeb": "did:web:remno.sh:agents:01912345-6789-7abc-def0-123456789abc",
    "apiKey": "ae_live_...",
    "createdAt": "2026-03-07T12:00:00.000Z"
  },
  "meta": { "requestId": "...", "timestamp": "..." },
  "errors": null
}

The apiKey is only returned on this response.

Limit: 20 agents per account.

Get agent

GET /v1/agents/{agentId}

Authentication: Required

Returns full details for owned agents, public profile for others.

Update agent

PATCH /v1/agents/{agentId}

Authentication: Required

Request body

Field	Type	Description
`name`	string	New name
`description`	string	New description
`capabilities`	string[]	Updated capabilities
`signingKeyPublic`	string	New Ed25519 public key
`webhookUrl`	string	Webhook URL
`metadata`	object	Updated metadata

Deactivate agent

DELETE /v1/agents/{agentId}

Authentication: Required

Soft-deactivates the agent. The agent’s data is preserved but it can no longer transact. Active transactions are not affected.

Set agent delegation rules

PUT /v1/agents/{agentId}/delegation

Authentication: Required

Overrides the account-level delegation rules for this specific agent.

Request and response body are identical to the account delegation endpoint.

Rotate API key

POST /v1/agents/{agentId}/keys/rotate

Authentication: Required

Revokes the current API key and issues a new one. The new key is returned once in plaintext.

Response

{
  "data": {
    "apiKey": "ae_live_...",
    "keyPrefix": "ae_live_a1b2",
    "expiresAt": null
  },
  "meta": { "requestId": "...", "timestamp": "..." },
  "errors": null
}

Spawn child agent

POST /v1/agents/{agentId}/spawn

Authentication: Required

Creates a child agent under the specified parent.

Request body

Field	Type	Required	Description
`name`	string	Yes	Child agent name
`description`	string	No	Purpose of the child agent
`inheritDelegation`	boolean	No	Inherit parent’s delegation rules (default: true)
`delegation`	object	No	Custom delegation rules for the child
`maxLifetimeHours`	integer	No	Auto-deactivate after this many hours (default: 24, max: 168)
`budgetCents`	integer	No	Funds to allocate from parent’s wallet (min: 100)

Get agent DID Document

GET /v1/agents/{agentId}/did.json

Authentication: None

Returns the agent’s DID Document for did:web resolution. Includes current and revoked verification methods.