Configuration¶

Agent Registration¶

Register agents with a name and framework identifier.

curl -X POST /api/v1/agents/register \
  -H "Authorization: Bearer ag_..." \
  -d '{"name": "my-agent", "framework": "crewai"}'

Supported Frameworks¶

Framework	Value
CrewAI	`crewai`
LangGraph	`langgraph`
AutoGen	`autogen`
Custom / other	`custom`

Agent Config¶

Pass arbitrary configuration in the config field:

{
  "name": "research-analyst",
  "framework": "crewai",
  "config": {
    "role": "Senior Research Analyst",
    "monitored_patterns": ["BP-001", "BP-003", "BP-007"]
  }
}

Authentication¶

All API calls (except /api/v1/auth/register and /api/v1/patterns) require an API key in the Authorization header:

Authorization: Bearer ag_abc123...

API keys are SHA-256 hashed before storage. The plaintext key is returned once at registration and cannot be retrieved.

Key Rotation¶

curl -X POST /api/v1/auth/rotate \
  -H "Authorization: Bearer ag_old_key..."

Returns a new API key. The old key is immediately invalidated.