Skip to main content
POST
TypeScript SDK

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
source
string
required

Application the chat is imported from.

Allowed value: "conductor"
externalId
string
required

Chat ID in the source application. Importing the same chat again returns the existing session.

Required string length: 1 - 200
title
string
required

Title of the chat.

Required string length: 1 - 500
messages
object[]
required

Chat messages in the order they were sent.

Required array length: 1 - 10000 elements

Response

Import a chat as a session

agent
string | null
required
agentId
string<uuid> | null
required
artifactType
enum<string> | null
required
Available options:
PullRequest,
ToolCall,
Plan,
Response,
File,
Service,
Source,
null
baseBranch
string | null
required
branchName
string | null
required
createdAt
string<date-time>
required
externalId
string | null
required
externalUrl
string | null
required
id
string<uuid>
required
kind
string
required
lastQueuedAt
string<date-time> | null
required
lastSeenAt
string<date-time>
required
level
integer
required
mode
enum<string>
default:normal
required
Available options:
normal,
planning
parentSessionId
string<uuid> | null
required

The session whose agent created this session.

projectId
string | null
required
sandboxSize
enum<string> | null
required
Available options:
nano,
micro,
small,
medium,
large,
xl,
xxl,
ultra,
null
sessionType
enum<string>
default:Chat
required
Available options:
Chat,
Terminal
targetBranch
string | null
required
title
string
required
updatedAt
string<date-time>
required
visibility
enum<string>
default:public
required
Available options:
public,
private
artifacts
object[]
required
automaticSizing
boolean
required

Whether the session VM is sized automatically.

description
string | null
required
diffSummary
object | null
required
htmlUrl
string<uri>
required
isPinned
boolean
required
project
object | null
required
sessionSource
object
required
sourcePullRequest
object | null
required
state
object
required