Files
coder/docs/reference/api/chats.md
T
Hugo Dutka 84527390c6 feat: chat desktop backend (#23005)
Implement the backend for the desktop feature for agents.

- Adds a new `/api/experimental/chats/$id/desktop` endpoint to coderd
which exposes a VNC stream from a
[portabledesktop](https://github.com/coder/portabledesktop) process
running inside the workspace
- Adds a new `spawn_computer_use_agent` tool to chatd, which spawns a
subagent that has access to the `computer` tool which lets it interact
with the `portabledesktop` process running inside the workspace
- Adds the plumbing to make the above possible

There's a follow up frontend PR here:
https://github.com/coder/coder/pull/23006
2026-03-13 19:49:34 +01:00

1.3 KiB
Generated

Chats

Archive a chat

Code samples

# Example request using curl
curl -X POST http://coder-server:8080/api/v2/chats/{chat}/archive

POST /chats/{chat}/archive

Responses

Status Meaning Description Schema
204 No Content No Content

Watch chat desktop

Code samples

# Example request using curl
curl -X GET http://coder-server:8080/api/v2/chats/{chat}/desktop \
  -H 'Coder-Session-Token: API_KEY'

GET /chats/{chat}/desktop

Parameters

Name In Type Required Description
chat path string(uuid) true Chat ID

Responses

Status Meaning Description Schema
101 Switching Protocols Switching Protocols

To perform this operation, you must be authenticated. Learn more.