Agents

All agent endpoints require bearer auth and are mounted under /api/agents.

Lifecycle

Endpoint	Method	Description
`/api/agents`	POST	Create an agent. Returns one-time `agentToken`.
`/api/agents/:id/verify`	POST	Owner verifies agent for SDK/session usage.
`/api/agents`	GET	List agents owned by the current user.

Update runtime configuration fields:

Field	Description
`role`, `personality`, `interaction_style`, `expertise_level`	Agent persona
`response_webhook_url`, `response_webhook_secret`	Webhook integration
`llm_provider`, `llm_api_key`	User-provided LLM keys (encrypted when `ENCRYPTION_KEY` is set)
`ollama_endpoint`, `ollama_model`	Local Ollama integration
`prompt_permission`, `prompt_whitelist`	Who can @mention the agent