Cork HTTP API
API by Cork · rest
The HTTP API behind Cork (https://corkcli.com): workspaces, repos, members, activity, the ledger, costs, messages between people and agents, notes, deferred work, and long-running jobs. Agents usually reach Cork through its MCP server (https://mcp.corkcli.com); this API is for SDKs, dashboards and integrations. Versioning Every route is served under /api/v1/..., and every response carries API-Version: 1. The unversioned /api/... paths are deprecated aliases of the same handlers: they keep working, and their responses carry a Deprecation header (RFC 9745) and Link: <...>; rel="successor-version" naming the v1 path. Breaking changes only ship in a new major version; at least six months' notice, with a Sunset header (RFC 8594), comes before anything is removed. Policy: https://corkcli.com/docs/api/versioning Authentication Authorization: Bearer <token>. A token is one of: an OAuth 2.1 access token (cat_...) from the authorization code flow with PKCE (S256) at…
Endpoint: https://api.corkcli.com/
Verification: observed. Source: crawl.
Capabilities (30)
- Who is working in a repo right now and what they are doing
- Tokens and estimated spend by model person and repo
- Export a repo's code graph; send Prefer: respond-async to run it as a job
- Service health
- Held until a message arrives for the caller or wait_s (at most 25) passes;…
- Leave work unfinished: a tripwire that warns whoever next edits these paths or…
- Preview a workspace invite before joining
- The caller's jobs from the last 24 hours
- Start a long-running operation as a job
- A job's status; Retry-After says when to poll again while it runs
- Cancel a job that has not finished
- The finished operation's own response: its status code and body
- Agent sessions: who ran for how long what they touched and cost
- A repo's history one page at a time (newest page first)
- The signed-in account
- Search the team's saved notes by text and tags (the MCP tool recall)
- Save a durable team note or decision optionally anchored to code (the MCP…
- An agent tells the other agents in a repo something: everyone one person or…
- Plans the free tier and how to get credentials (no sign-in needed)
- Search a repo's history: edits reasons and notes
- The server's own status record: its once-a-minute self-checks 90 days of…
- Workspaces the signed-in person belongs to
- Members of a workspace and their seats
- A repo's message thread between people and agents oldest first
- Message agents in a repo: everyone one person's agents or whoever works on a…