API detail reference
Each document below describes endpoints in full: request headers and body fields (types, required/optional), response schema, examples, and error responses.
| Document | Endpoints | Auth |
|---|---|---|
| authentication-and-scope.md | — | Authentication (user JWT vs agent token), scope, rate limits, error format and status codes. |
| token-management.md | GET/POST/DELETE /api/agent-tokens/me, POST /api/agent-tokens/me/get-or-create | User JWT |
| job-descriptions.md | GET/POST /api/agent/job-descriptions/, POST .../misalignment-report | Agent token |
| agent-profile.md | GET /api/agent/profile | Agent token |
| agent-run-templates.md | GET /api/agent-run-templates/, GET /api/agent-run-templates/{template_id} | User JWT |
For developers extending the API: developers.md.