Reference
HTTP API
Sessions, messages, and schedules over HTTP. Message turns are a server-sent event stream.
Sessions
| Method | Path | Returns |
|---|---|---|
GET | /devchat/health | {status, service} |
GET | /devchat/sessions | Session list |
POST | /devchat/sessions | Creates a session |
GET | /devchat/sessions/:id | Session and messages |
PATCH | /devchat/sessions/:id | Renames a session |
DELETE | /devchat/sessions/:id | Deletes a session |
POST | /devchat/sessions/:id/messages | SSE stream for one turn |
POST | /devchat/sessions/:id/stop | Stops the current turn |
Stream events
The message endpoint responds with text/event-stream. The client grows one assistant bubble from the deltas. The last event is always done.
user_saved
claude_session
assistant_delta
tool_use
tool_result
result
error
doneSchedules
GET and POST /devchat/schedules list and create tasks. PATCH and DELETE address /devchat/schedules/:id. POST /devchat/schedules/:id/run starts one immediately.
Terminals
The Rust engine serves these routes. POST /devchat/terminals opens a shell. GET /devchat/terminals/:id/stream is the session event stream. POST …/launch submits one command, POST …/reset soft-resets the terminal, and POST …/resume reattaches a session left on disk. GET and PUT /devchat/terminals/settings store clipboard, contrast, shell, and theme choices. GET and POST /devchat/terminals/commands list and save quick commands; DELETE /devchat/terminals/commands/:id removes one. POST /devchat/terminals/import/ghostty reads the Ghostty config. GET and POST /devchat/terminals/import/warp list and apply a Warp theme. Behavior is on the Terminal page. The Brompter CLI calls the open, read, send, and close routes from a shell.