REreplicas
Chats

Fork chat

Starts a new chat that continues from this chat's history, optionally on another coding agent and with a first message. The replica must be active.

post/v1/replica/{id}/chats/{chat_id}/fork

Request

  • Base URL
    https://api.replicas.dev
  • URL
    https://api.replicas.dev/v1/replica/{id}/chats/{chat_id}/fork
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

Replica ID

chat_idstring required

Chat ID

Headers

X-Replicas-Api-Version'2026-10-07'

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

Request body

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

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

modelstring

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

thinking_level'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'ultra' | 'ultracode'

Reasoning effort for the forked chat

titlestring

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

messagestring

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

idstring uuid

Optional client-generated chat ID.

client_request_idstring

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

enable_interactive_toolsboolean

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

Response

Created

Changes

No recorded changes to this operation across all 1 revision of this API.