Chats
Chats are your conversations with the PM agent. List your chats, read one with its messages, start a new one, and stop a reply that is still being written. When the assistant has handed a chat over to a coding session, release the chat so your next message goes to the assistant again. See Finding your way around.
Stop the assistant's in-flight reply
Asks the agent to cancel the conversation's streaming turn — the agent itself, not just the stream. The run ends on its own stream with a run:error whose errorType is UserCancelled, and what arrived is kept as a user_stopped turn. stopped: false means the agent could not be asked, and the run finishes normally. Owner only.
path Parameters
workspaceIdWorkspace UUID
idChat UUID
Stop the assistant's in-flight reply › Responses
Whether the agent could be asked to stop
Release a conversation's coding-session latch
After a handoff the conversation is latched to the coding session it created (assistant sends are refused while it runs). Detaching releases the latch so the next message routes to the assistant again — "continue with the assistant". The session keeps its place in the transcript. Owner only.
path Parameters
workspaceIdWorkspace UUID
idChat UUID
Release a conversation's coding-session latch › Responses
The conversation, unlatched
List recently active chats
Returns the most recently updated AI chat conversations.
path Parameters
workspaceIdWorkspace UUID
List recently active chats › Responses
Recent chats
List AI chats
Returns the AI chat conversations in this workspace that the authenticated user can see: their own, plus conversations shared with the workspace. An empty conversation is not listed. Paginated, most recently created first by default; pass sortBy=updatedAt for the most recently active first. Returns: id, title, messageCount, createdAt, updatedAt.
path Parameters
workspaceIdWorkspace UUID
query Parameters
pagePage number (1-indexed, default 1)
limitItems per page (default 50)
sortByField to sort by
sortOrderSort direction (default desc)
searchFull-text search across searchable fields
List AI chats › Responses
List of chats
Create a new AI chat
Start a new AI chat conversation, optionally linked to a workspace for context. Pass clientChatId, a UUID the client minted, to know the conversation's id before the request answers: a repeat with the same clientChatId creates nothing and returns the conversation already made, with a 200.
path Parameters
workspaceIdWorkspace UUID
Create a new AI chat › Request Body
titleinitialMessageagentIdclientChatId^([0-9a-fA-F]{8}-[0-…An id the client minted for this conversation before creating it. The chat is stored under chatIdFor(workspaceId, userId, clientChatId), so the client knows its id at once, and a repeated create returns the conversation already made.
Create a new AI chat › Responses
The conversation already created under this clientChatId
Get a chat by ID with messages
Retrieve a single chat conversation including all its messages.
path Parameters
workspaceIdWorkspace UUID
idChat UUID
Get a chat by ID with messages › Responses
Chat with messages