Coder

Coder Chats API

The Chats API from Coder — 20 operation(s) for chats.

GitHub OpenAPI

Operations 91

GET /api/experimental/chats/projects List chat projects #
GET /api/experimental/chats/{chat}/stream/desktop Connect to chat workspace desktop via WebSockets #
POST /api/experimental/organizations/{organization}/chats/projects Create chat project #
GET /api/experimental/organizations/{organization}/chats/projects/{project} Get chat project #
DELETE /api/experimental/organizations/{organization}/chats/projects/{project} Delete chat project #
PATCH /api/experimental/organizations/{organization}/chats/projects/{project} Update chat project #
GET /api/experimental/organizations/{organization}/chats/projects/{project}/acl Get chat project ACL #
PATCH /api/experimental/organizations/{organization}/chats/projects/{project}/acl Update chat project ACL #
GET /api/experimental/organizations/{organization}/chats/projects/{project}/instructions Get chat project instructions #
PUT /api/experimental/organizations/{organization}/chats/projects/{project}/instructions Update chat project instructions #
DELETE /api/experimental/organizations/{organization}/chats/projects/{project}/instructions Delete chat project instructions #
GET /api/experimental/organizations/{organization}/chats/projects/{project}/memories List chat project memories #
POST /api/experimental/organizations/{organization}/chats/projects/{project}/memories Create chat project memory #
GET /api/experimental/organizations/{organization}/chats/projects/{project}/memories/{memory} Get chat project memory #
DELETE /api/experimental/organizations/{organization}/chats/projects/{project}/memories/{memory} Delete chat project memory #
GET /api/experimental/organizations/{organization}/chats/projects/{project}/skills List chat project skills #
POST /api/experimental/organizations/{organization}/chats/projects/{project}/skills Create chat project skill #
GET /api/experimental/organizations/{organization}/chats/projects/{project}/skills/{skillName} Get chat project skill by name #
DELETE /api/experimental/organizations/{organization}/chats/projects/{project}/skills/{skillName} Delete chat project skill #
PATCH /api/experimental/organizations/{organization}/chats/projects/{project}/skills/{skillName} Update chat project skill #
GET /api/v2/chats List chats #
POST /api/v2/chats Create chat #
GET /api/v2/chats/by-workspace List chats by workspace #
GET /api/v2/chats/config/auto-archive-days Get chat auto archive days #
PUT /api/v2/chats/config/auto-archive-days Update chat auto archive days #
GET /api/v2/chats/config/debug-logging Get chat debug logging setting #
PUT /api/v2/chats/config/debug-logging Update chat debug logging setting #
GET /api/v2/chats/config/debug-retention-days Get chat debug retention days #
PUT /api/v2/chats/config/debug-retention-days Update chat debug retention days #
GET /api/v2/chats/config/personal-model-overrides Get chat personal model override settings #
PUT /api/v2/chats/config/personal-model-overrides Update chat personal model override settings #
GET /api/v2/chats/config/plan-mode-instructions Get chat plan mode instructions #
PUT /api/v2/chats/config/plan-mode-instructions Update chat plan mode instructions #
GET /api/v2/chats/config/retention-days Get chat retention days #
PUT /api/v2/chats/config/retention-days Update chat retention days #
GET /api/v2/chats/config/system-prompt Get chat system prompt #
PUT /api/v2/chats/config/system-prompt Update chat system prompt #
GET /api/v2/chats/config/user-compaction-thresholds Get user chat compaction thresholds #
PUT /api/v2/chats/config/user-compaction-thresholds/{modelConfig} Update user chat compaction threshold #
DELETE /api/v2/chats/config/user-compaction-thresholds/{modelConfig} Delete user chat compaction threshold #
GET /api/v2/chats/config/user-debug-logging Get user chat debug logging setting #
PUT /api/v2/chats/config/user-debug-logging Update user chat debug logging setting #
GET /api/v2/chats/config/user-prompt Get user chat custom prompt #
PUT /api/v2/chats/config/user-prompt Update user chat custom prompt #
GET /api/v2/chats/config/workspace-ttl Get chat workspace time to live #
PUT /api/v2/chats/config/workspace-ttl Update chat workspace time to live #
POST /api/v2/chats/files Upload chat file #
GET /api/v2/chats/files/{file} Get chat file #
GET /api/v2/chats/files/{file}/download Download chat file with signed token #
POST /api/v2/chats/files/{file}/download-url Create chat file download URL #
GET /api/v2/chats/watch Watch chat events for a user via WebSockets #
GET /api/v2/chats/{chat} Get chat by ID #
PATCH /api/v2/chats/{chat} Update chat #
GET /api/v2/chats/{chat}/acl Get chat ACLs #
PATCH /api/v2/chats/{chat}/acl Update chat ACL #
POST /api/v2/chats/{chat}/clear Clear chat context #
POST /api/v2/chats/{chat}/compact Compact chat #
PUT /api/v2/chats/{chat}/context Refresh chat context #
GET /api/v2/chats/{chat}/cost Get chat cost #
GET /api/v2/chats/{chat}/diff Get chat diff contents #
POST /api/v2/chats/{chat}/interrupt Interrupt chat #
GET /api/v2/chats/{chat}/messages List chat messages #
POST /api/v2/chats/{chat}/messages Send chat message #
PATCH /api/v2/chats/{chat}/messages/{message} Edit chat message #
GET /api/v2/chats/{chat}/prompts List chat user prompts #
DELETE /api/v2/chats/{chat}/queue/{queuedMessage} Delete chat queued message #
POST /api/v2/chats/{chat}/queue/{queuedMessage}/promote Promote chat queued message #
POST /api/v2/chats/{chat}/reconcile-invalid Reconcile invalid chat state #
GET /api/v2/chats/{chat}/stream Stream chat events via WebSockets #
GET /api/v2/chats/{chat}/stream/git Watch chat workspace git state via WebSockets #
GET /api/v2/chats/{chat}/stream/parts Stream chat parts via WebSockets #
POST /api/v2/chats/{chat}/title/propose Propose chat title #
POST /api/v2/chats/{chat}/tool-results Submit chat tool results #
POST /api/v2/chats/{chat}/workspace-files Upload a file to a chat's workspace #
GET /api/v2/organizations/{organization}/chats/config/system-prompt Get organization chat system prompt #
PUT /api/v2/organizations/{organization}/chats/config/system-prompt Update organization chat system prompt #
GET /api/v2/organizations/{organization}/chats/model-overrides List organization chat model overrides #
PUT /api/v2/organizations/{organization}/chats/model-overrides/{context} Update organization chat model override #
GET /api/v2/organizations/{organization}/chats/models List AI models and provider descriptors in an organization #
POST /api/v2/organizations/{organization}/chats/models Create an AI model in an organization #
GET /api/v2/organizations/{organization}/chats/models/{model} Get an AI model #
DELETE /api/v2/organizations/{organization}/chats/models/{model} Delete an AI model #
PATCH /api/v2/organizations/{organization}/chats/models/{model} Update an AI model #
GET /api/v2/organizations/{organization}/chats/models/{model}/acl Get an AI model ACL #
PATCH /api/v2/organizations/{organization}/chats/models/{model}/acl Update an AI model ACL #
GET /api/v2/organizations/{organization}/chats/models/{model}/acl/available Get available AI model ACL users and groups #
GET /api/v2/organizations/{organization}/members/{user}/chats/model-overrides Get organization member chat model overrides #
PUT /api/v2/organizations/{organization}/members/{user}/chats/model-overrides/{context} Update organization member chat model override #
GET /api/v2/users/{user}/ai-provider-keys List user AI provider key configurations #
PUT /api/v2/users/{user}/ai-provider-keys/{aiProvider} Update user AI provider key #
DELETE /api/v2/users/{user}/ai-provider-keys/{aiProvider} Delete user AI provider key #

Documentation

📖
Documentation
https://coder.com/docs/reference/api

Specifications

⚙
OpenAPI
https://artifacts.apis.io/coder/openapi/coder-chats-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/coder:coder-chats-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

coder-chats-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: Coderd is the service created by running coder server. It is a thin API that connects workspaces, provisioners and users. coderd stores its state in Postgres and is the only service that communicates with Postgres.
  title: Coder Chats API
  termsOfService: https://coder.com/legal/terms-of-service
  contact:
    name: API Support
    url: https://coder.com
    email: support@coder.com
  license:
    name: AGPL-3.0
    url: https://github.com/coder/coder/blob/main/LICENSE
  version: '2.0'
servers:
- url: /
tags:


# --- truncated at 32 KB (144 KB total) ---
# Full source: https://artifacts.apis.io/coder/openapi/coder-chats-api-openapi.yml