docs / api / agents

Agents endpoints

CRUD for agent personas. All endpoints are scoped to the current tenant.

GET/api/agents

List agent personas in the current workspace.

Example

curl http://localhost:8765/api/agents | jq
POST/api/agents

Create a new agent persona.

Parameters

NameTypeRequiredDescription
namestringyesDisplay name
rolestringyesOne of reasoning, coding, general
system_promptstringyesSystem prompt for the persona
GET/api/agents/{id}

Get a specific agent persona.

Parameters

NameTypeRequiredDescription
idstringyesPersona id
POST/api/agents/{id}/feedback

Submit feedback that feeds into the persona's learning system.

Parameters

NameTypeRequiredDescription
idstringyesPersona id
ratingintegeryes1-5
reasonstringnoWhy the rating?