Create Chat
Creates a new chat session for a replica.
Authorizations
API key authentication. Obtain your API key from the Replicas dashboard under Organization → Settings → API Keys. User-session JWTs are not accepted by /v1/replica endpoints.
Path Parameters
The unique identifier of the replica
Body
Request body for creating a new chat
Coding agent provider for this chat
claude, codex, cursor, opencode, pi Optional client-generated chat ID.
Optional client-generated creation time.
Title for the chat
Optional parent chat ID.
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
A chat session within a replica
Unique identifier for the chat
Coding agent provider for this chat
claude, codex, cursor, opencode, pi Chat title
When the chat was created
When the chat was last updated
Whether the chat is currently doing work — either processing a foreground message or running background/spawned-agent tasks