v1

latestOpenAPI 3.1.02026-07-22100167210.7 KB

Replica

Create Workspace Chat

Creates a chat immediately. For preparing or sleeping workspaces, the chat stays visible and is created in the engine after startup completes. Archived and error workspaces return 409.

post/v1/workspaces/{workspaceId}/chats

Path parameters

workspaceIdstring uuid required

Request body

provider'claude' | 'codex' | 'cursor' | 'opencode' | 'pi' required

Coding agent provider for this chat

idstring uuid

Optional client-generated chat ID.

createdAtstring date-time

Optional client-generated creation time.

titlestring

Title for the chat

parentChatIdstring uuid

Optional parent chat ID.

clientRequestIdstring

Opaque client-chosen id echoed back in the chat.created event, so clients doing optimistic UI can recognize their own create

Response

Chat accepted