Sign in

v2

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-01-12412664.0 KB
Agents

Register New Agent

Register a new AI agent in the system with its Ed25519 public key. The agent_id will be automatically generated if not provided.

post/agents

Request body

agent_idstring

Optional agent ID. If not provided, one will be generated.

namestring

Human-readable name for the agent

descriptionstring

Optional description of the agent's purpose

public_keystring base64 required

Base64-encoded Ed25519 public key (32 bytes)

Example request

{
  "agent_id": "agent-custom-001",
  "name": "MyAwesomeAgent",
  "description": "Agent for processing order data",
  "public_key": "AAAAC3NzaC1lZDI1NTE5AAAAIDAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
}

Response

Agent registered successfully

agent_idstring
namestring
descriptionstring
public_keystring base64
status'active' | 'inactive' | 'revoked'
created_atstring date-time
updated_atstring date-time
last_seen_atstring date-time nullable

Example response

{
  "agent_id": "agent-ebd9cd4a-1234-5678-90ab-cdef01234567",
  "name": "MyAwesomeAgent",
  "description": "Agent for processing order data",
  "public_key": "AAAAC3NzaC1lZDI1NTE5AAAAIDAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=",
  "status": "active"
}