Skip to main content
POST
Fork chat

Authorizations

Authorization
string
header
required

Organization or personal API key from Settings → API Keys.

Headers

X-Replicas-Api-Version
enum<string>

API version. 2026-10-07 returns snake_case responses. See versioning.

Available options:
2026-10-07

Path Parameters

id
string<uuid>
required

Replica ID

chat_id
string
required

Chat ID

Body

application/json

Request body for continuing an existing chat on another coding agent harness

provider
enum<string>
required

Harness to continue the chat on. It must have credentials connected in the workspace.

Available options:
claude,
codex,
cursor,
opencode,
pi
model
string

Model for the forked chat. Defaults to the harness default.

thinking_level
enum<string>

Reasoning effort for the forked chat

Available options:
low,
medium,
high,
xhigh,
max,
ultra,
ultracode
title
string

Title for the forked chat. Defaults to a title derived from the source chat.

message
string

Optional first instruction for the new harness, sent alongside the inherited context. Empty or whitespace-only values preserve the default continuation behavior.

id
string<uuid>

Optional client-generated chat ID.

client_request_id
string

Opaque client-chosen id echoed back in the chat.created event

enable_interactive_tools
boolean

Allow the forked chat's first turn to use interactive tools

Response

Created

chat
object
required