v15

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-287323136.0 KB
Agents

Register a new agent

Atomic: creates API key + pre-seeds fingerprint row. Returns plain API key (shown once).

post/api/v1/agents/register

Request body

displayNamestring required
descriptionstring
capabilitiesstring[] required
modelstring
agentVersionstring

Example request

{
  "displayName": "prod-sentiment-analyzer",
  "description": "Processes Farcaster sentiment for trading signals",
  "capabilities": [
    "sentiment_analysis",
    "general"
  ],
  "model": "llama3:70b",
  "agentVersion": "1.0.0"
}

Response

Agent registered. API key returned once — store securely.