List chats
chat:read
Start a chat
multipart/form-data instead of JSON. Use the same fields and add the file parts.
Required scope: chat:write
Get a chat
chat:read
Send a message
"cancel_current": true.
message can be omitted for a control-only request when either cancel_current or stop_agent is true. cancel_current cancels the in-flight turn; stop_agent parks the target agent and its descendants:
chat:write
Export workspace files
Chat artifacts live under/workspace in the running agent sandbox.
List exportable files:
413.
Download one file. The API accepts either an absolute path under /workspace
or a convenient relative path such as report.md; relative paths resolve from
/workspace. Traversal and absolute paths outside /workspace are rejected.
An individual export is limited to 50 MiB.
404, and oversized listings or files return 413. Invalid listing, export, or file data from the sandbox returns 502; an unavailable, unready, or timed-out sandbox returns 503. A file read failure or actual-byte overflow fails the stream instead of returning a valid-looking partial ZIP.
Required scope: chat:read
The CLI adds safe file handling and refuses to replace an existing output unless --force is explicit:
Create a share link
chat:write