Agents API
7 endpoints in this group.
GET /api/agents
List Agents
List AI agents for the authenticated tenant.
Auth (, hardened post-pentest): tenant_id is derived from the JWT
claim. Cross-tenant override now requires platform-admin, not the
tenant-level role=admin.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenant_id | query | — | optional | |
active_only | query | boolean | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /api/agents
Create Agent
Create a new AI agent.
Request body: application/json
Responses
| Code | Description |
|---|---|
201 | Successful Response |
422 | Validation Error |
GET /api/agents/leaderboard
Agent Leaderboard
Compute per-agent signal volume and confidence stats.
Falls back to signal confidence distribution if trade linkage is absent.
Auth (, hardened post-pentest): cross-tenant override requires platform-admin.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenant_id | query | — | optional | |
period_days | query | integer | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
DELETE /api/agents/{agent_id}
Delete Agent
Soft-delete an agent by flagging is_active=false. A hard delete is avoided
because agent_signals and strategies FK to ai_agents.id.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
agent_id | path | integer | required | |
tenant_id | query | — | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
PATCH /api/agents/{agent_id}
Update Agent
Generic agent update. Only fields provided in the body are applied. Returns the full updated agent row. 404 if agent doesn't exist for tenant.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
agent_id | path | integer | required |
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
PATCH /api/agents/{agent_id}/toggle
Toggle Agent
Toggle agent active/inactive.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
agent_id | path | integer | required | |
tenant_id | query | — | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/agents/{agent_id}/track-record
Agent Track Record
Return signal history + outcome data for a specific agent.
Auth (, hardened post-pentest): cross-tenant override requires platform-admin.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
agent_id | path | integer | required | |
tenant_id | query | — | optional | |
account_id | query | — | optional | |
limit | query | integer | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |