Use these endpoints to manage agents, capabilities, and resources. All requests require the tenant-id header.
Agents
| Method | Endpoint | Description |
|---|
| GET | /api/v1/agents | List agents (use ?include=stats for capability stats) |
| GET | /api/v1/agents/:id | Get agent by ID |
| GET | /api/v1/agents/slug/:slug | Get agent by slug |
| POST | /api/v1/agents | Create agent |
| PUT | /api/v1/agents/:id | Update agent |
| DELETE | /api/v1/agents/:id | Delete agent |
Capabilities
| Method | Endpoint | Description |
|---|
| GET | /api/v1/agents/:agentId/capabilities | List capabilities for agent |
| POST | /api/v1/agents/:agentId/capabilities | Create capability |
| GET | /api/v1/capabilities/:id | Get capability by ID |
| PUT | /api/v1/capabilities/:id | Update capability |
| DELETE | /api/v1/capabilities/:id | Delete capability |
| POST | /api/v1/capabilities/validate | Validate DSL |
| POST | /api/v1/capabilities/:id/compile | Compile capability |
| GET | /api/v1/capabilities/:id/compiled | Get compiled model |
Integrations
| Method | Endpoint | Description |
|---|
| GET | /api/v1/integrations | List integrations |
| GET | /api/v1/integrations/active | List active integrations |
| GET | /api/v1/integrations/:id | Get integration |
| POST | /api/v1/integrations | Create integration |
| PUT | /api/v1/integrations/:id | Update integration |
| DELETE | /api/v1/integrations/:id | Delete integration |
| POST | /api/v1/integrations/:id/test | Test connection |
Actions
| Method | Endpoint | Description |
|---|
| GET | /api/v1/integrations/:integrationId/actions | List actions for integration |
| POST | /api/v1/integrations/:integrationId/actions | Create action |
| GET | /api/v1/actions/:id | Get action |
| PUT | /api/v1/actions/:id | Update action |
| DELETE | /api/v1/actions/:id | Delete action |
| POST | /api/v1/actions/:id/test | Test action (not implemented) |
Datapoints
| Method | Endpoint | Description |
|---|
| GET | /api/v1/datapoints | List datapoints |
| GET | /api/v1/datapoints/by-slugs?slugs=a,b | Fetch by slug list |
| GET | /api/v1/datapoints/:id | Get datapoint |
| POST | /api/v1/datapoints | Create datapoint |
| PUT | /api/v1/datapoints/:id | Update datapoint |
| DELETE | /api/v1/datapoints/:id | Delete datapoint |
Knowledge
| Method | Endpoint | Description |
|---|
| GET | /api/v1/knowledge/collections | List collections |
| GET | /api/v1/knowledge/collections/:id | Get collection |
| POST | /api/v1/knowledge/collections | Create collection |
| PUT | /api/v1/knowledge/collections/:id | Update collection |
| DELETE | /api/v1/knowledge/collections/:id | Delete collection |
| GET | /api/v1/knowledge/collections/:collectionId/documents | List documents |
| POST | /api/v1/knowledge/collections/:collectionId/documents | Upload document (multipart) |
| GET | /api/v1/knowledge/collections/:collectionId/documents/:id | Get document |
| GET | /api/v1/knowledge/collections/:collectionId/documents/:id/download | Download document |
| DELETE | /api/v1/knowledge/collections/:collectionId/documents/:id | Delete document |
| POST | /api/v1/knowledge/search | Search knowledge |
Document uploads use multipart form data with fields name, slug, description, and metadata plus the file payload.
Conversations (Global)
| Method | Endpoint | Description |
|---|
| GET | /api/v1/conversations | List conversations (current user) |
| GET | /api/v1/conversations/:id | Get conversation |
| GET | /api/v1/conversations/:id/history | Get history |