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.yaml

This is the public API spec.

What’s Included

The public spec covers:

Resource	Operations
Tasks	CRUD + transitions + comments + attachments
Projects	CRUD + list project tasks
Initiatives	CRUD + list initiative projects
Agents	CRUD
Team	List, get, update
Activity	List
Context	Session briefing
Me	Identity check
Health / Status	Liveness + subsystem health

Using the Spec

With Swagger UI or Redoc

Point any OpenAPI viewer at the URL:


https://docs.cohort.bot/openapi.yaml

With 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-client

The spec is regenerated on every build from the source files.