API reference / agent

agent

GET/api/v1/agents

List agent configurations

Auth:
required (min role: admin)
Response:
{ data }
GET/api/v1/agents/:type

Get agent configuration by type

Auth:
required (min role: admin)
Response:
{ data }
POST/api/v1/agents/:type/suggest

Get agent suggestions (advisor mode)

Auth:
required (min role: admin)
Request:
{ requestId, agentType, action, parameters, orgId, requestedBy, correlationId, requestedAt, timeoutMs }
Response:
{ data }
POST/api/v1/agents/:type/execute

Execute agent action (assisted/autonomous)

Auth:
required (min role: director)
Request:
{ requestId, agentType, action, parameters, orgId, requestedBy, correlationId, requestedAt, timeoutMs }
Response:
{ data }
POST/api/v1/agents/:type/stream

Stream agent operation via SSE

Auth:
required (min role: admin)
Streaming:
SSE (text/event-stream)
POST/api/v1/agents/:type/feedback

Submit feedback feedback

Auth:
required
Response:
{ success, message }
GET/api/v1/agents/:type/stream

GET /api/v1/agents/[type]/stream?action=generate_formation&

Auth:
required
Streaming:
SSE (text/event-stream)
agent API — Peer10 Developers