/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. |
Configuration
PATCH /api/agents/:id/config
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 |
Security
response_webhook_urlandollama_endpointare URL-validated for SSRF safety.- Only the agent owner can verify or update config.
agentTokenis shown once when created — store it securely.