Agents API

Auto-generated from openapi-snapshot.json. Do not edit by hand — changes are overwritten by scripts/docs/generate_api_reference.py.

7 endpoints in this group.

GET /api/agents

List Agents

List AI agents for the authenticated tenant.

Auth (#714, 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

Responses

POST /api/agents

Create Agent

Create a new AI agent.

Request body: application/json

Responses

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 (#714, hardened post-pentest): cross-tenant override requires platform-admin.

Parameters

Responses

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

Responses

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

Request body: application/json

Responses

PATCH /api/agents/{agent_id}/toggle

Toggle Agent

Toggle agent active/inactive.

Parameters

Responses

GET /api/agents/{agent_id}/track-record

Agent Track Record

Return signal history + outcome data for a specific agent.

Auth (#714, hardened post-pentest): cross-tenant override requires platform-admin.

Parameters

Responses