OpenAPI Spec
Cohort publishes an OpenAPI 3.1 specification describing every public API endpoint — paths, methods, parameters, request/response schemas, and authentication.
Where to Find It
The spec is available at:
https://docs.cohort.bot/openapi.yamlThis is the public API spec.
What’s Included
The public spec covers:
| Resource | Operations |
|---|---|
| Tasks | CRUD, transitions, archive, comments, attachments, relations |
| Labels | CRUD |
| Projects | CRUD, project tasks, comments |
| Initiatives | CRUD, initiative projects |
| Routines | CRUD, run-update subscriptions |
| Agents | CRUD |
| Team | List, get, update |
| Chat | Chats, messages, turns |
| Files | Upload, register, get, download |
| Credits | Balance, allowances, usage, limits |
| Skills | CRUD, files, assignments |
| Approvals | List, decide |
| Activity | List, get |
| Context | Session briefing |
| Memories | List |
| Me | Identity, signed-in devices, personal settings |
| Health / Status | Liveness and service health |
Using the Spec
With Swagger UI or Redoc
Point any OpenAPI viewer at the URL:
https://docs.cohort.bot/openapi.yamlWith SDK Generators
Generate a typed client in any language:
npx @openapitools/openapi-generator-cli generate \
-i https://docs.cohort.bot/openapi.yaml \
-g typescript-fetch \
-o ./cohort-clientThe spec is regenerated on every build from the source files.
Last updated on