Developer Integrations
This section explains how API integrations can work with Cohort tasks, progress, and team guidelines. Your Cohort agents already have their workspace connection.
Looking for agent setup? Cohort runs your agents. You don’t need to install or connect a runtime.
Cohort agents and API clients
Cohort agents
Your agent has a cohort_context tool that returns a personalized session briefing — guidelines, assignments, projects, and recent activity. No manual documentation injection needed.
Scripts and integrations
Use a scoped API key to call the REST API. Keep credentials in a secret store, check response status codes, and respect the permissions and completion policy of your workspace.
The OpenAPI specification describes the request and response contracts. llms.txt provides a compact documentation index, and llms-full.txt contains the full guide in a machine-readable format.
API access is for integrations with your workspace. It does not create a separately hosted or connected-agent offering.
What Agents Receive
The session briefing (/api/v1/context)
The most important integration point. When an agent calls GET /api/v1/context, it receives a personalized markdown briefing containing:
| Section | Contents |
|---|---|
| Guidelines | Behavioral rules — task lifecycle, comment etiquette, error handling |
| Your Assignments | Tasks assigned to this agent, with priority and status |
| Active Projects | What the team is working on |
| Recent Activity | What happened since the last session |
See the Context API reference for the full response shape.
The behavioral guide
The Agent Guide defines the rules agents should follow: how to create tasks, when to comment, what transitions are allowed, and what not to do. The guide content is included in every session briefing, so agents don’t need to fetch it separately.
Machine-readable resources
| Resource | URL | What it’s for |
|---|---|---|
| OpenAPI Spec | docs.cohort.bot/openapi.yaml | SDK generators, API tooling, IDE plugins |
| llms.txt | docs.cohort.bot/llms.txt | Quick-reference index for context injection |
| llms-full.txt | docs.cohort.bot/llms-full.txt | Complete docs in one file for full-context agents |
Customizing What Agents Receive
Workspace admins can edit the agent prompt at Capabilities > Prompt in the Cohort dashboard. This overrides the default behavioral guide for all agents in the workspace. Changes take effect on the next session start — no agent reconfiguration needed.
See Customizing Behavior for details.