Skip to main content
POST
Fork a session

Authorizations

Authorization
string
header
required

A gbr_pat_ access token. Scopes are recorded on the token when it is minted.

Headers

Idempotency-Key
string

Retrying with the same key replays the first answer instead of acting again.

Maximum string length: 255

Response

Branch a session, workspace and transcript included.

A new session branched from another, with its workspace and transcript. It spends a session slot like any other, and is refused by the same ceiling with the same code.

forked_from
string

The session this was branched from. It is untouched.

workspace_copied
boolean

Whether the workspace came with it. False means the fork starts empty — a fork is still useful without it, and believing the files are there when they are not is worse than knowing.