Skip to main content
POST
Create Chat

Authorizations

Authorization
string
header
required

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

id
string<uuid>
required

The unique identifier of the replica

Body

application/json

Request body for creating a new chat

provider
enum<string>
required

Coding agent provider for this chat

Available options:
claude,
codex,
cursor,
opencode,
pi
id
string<uuid>

Optional client-generated chat ID.

createdAt
string<date-time>

Optional client-generated creation time.

title
string

Title for the chat

parentChatId
string<uuid>

Optional parent chat ID.

clientRequestId
string

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

id
string
required

Unique identifier for the chat

provider
enum<string>
required

Coding agent provider for this chat

Available options:
claude,
codex,
cursor,
opencode,
pi
title
string
required

Chat title

created_at
string<date-time>
required

When the chat was created

updated_at
string<date-time>
required

When the chat was last updated

processing
boolean
required

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