AI Employees API
The five fixed AI Employees: Sarah (BD), Mike (Social), Lisa (Order Ops), Tom (Support), Emma (Content).
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | `/api/v1/ai-employees` | List with persona overrides |
| GET | `/api/v1/ai-employees/:role` | Get one (`sarah` / `mike` / `lisa` / `tom` / `emma`) |
| PATCH | `/api/v1/ai-employees/:role` | Override persona fields |
| POST | `/api/v1/ai-employees/:role/reset` | Reset to factory defaults |
| POST | `/api/v1/ai-employees/:role/dispatch` | Assign a task |
| GET | `/api/v1/ai-employees/:role/tasks` | Task history |
Personas
Default personas live in services/crm-service/src/ai-employees/persona-defaults.ts and ship in 9 locales each.
Every response uses the standard envelope:
{
"success": true,
"data": { /* resource or array */ },
"meta": { "total": 100, "cursor": "...", "hasMore": true },
"error": { "code": "ERROR_CODE", "message": "Human readable" }
}error is omitted on success; meta is omitted when not paginating.
Rate Limits
Subject to the standard 200 req/min/tenant authenticated limit. See [Rate Limits](/docs/api-reference/rate-limits) for full details and the per-endpoint overrides.