Sign in

v1

latestOpenAPI 3.1.02026-07-22100167210.7 KB
Replica

Create Chat

Creates a new chat session for a replica.

post/v1/replica/{id}/chats

Path parameters

idstring uuid required

The unique identifier of the replica

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 created successfully

idstring required

Unique identifier for the chat

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

Coding agent provider for this chat

titlestring required

Chat title

created_atstring date-time required

When the chat was created

updated_atstring date-time required

When the chat was last updated

processingboolean required

Whether the chat is currently doing work — either processing a foreground message or running background/spawned-agent tasks