Skip to main content
GET
Get Session
The Sessions API is in preview. Keep the returned conversationToken private and send it as X-Assist-Token for guest continuations. Account-connected work and sensitive actions still require authorization.
Read a saved Navigator session using its stable ID. Current access is checked on every read. With guest access, send the original conversationToken as X-Assist-Token; an account or API key is not required. A session ID alone is insufficient. An agent participating in the conversation does not own the session or grant anyone access. Use conversation history for earlier messages and live events to resume after disconnection. Operation instances keep their own IDs under the same parent session. Existing operation-session IDs remain supported.

Authorizations

x-api-key
string
header
required

Headers

X-Assist-Token
string

Guest Navigate session token.

Path Parameters

sessionId
string
required
Minimum string length: 1

Query Parameters

before
string

Navigate turn pagination cursor.

cursor
string

Act event pagination cursor.

limit
integer

Act page size.

Required range: 1 <= x <= 100
audience
enum<string>
default:agent

Presentation consumer. Agent returns Markdown and structured facts; human also receives DarwinUI. This does not change identity, permissions or approvals.

Available options:
human,
agent

Response

Current session state.

conversationId
string
required
Pattern: ^asst_[a-f0-9-]{36}$
status
enum<string>
required
Available options:
planning,
ready,
running,
paused,
completed,
cancelled
goal
string
required
messages
object[]
required
revisions
object[]
required
Maximum array length: 32
latestRevisionId
string | null
required
Pattern: ^arev_[a-f0-9-]{36}$
quote
object | null
required
funding
object | null
required
run
object | null
required
previousRuns
object[]
required
Maximum array length: 32
createdAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
updatedAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
threadId
string

Deprecated alias for sessionId.

Pattern: ^asst_[a-f0-9-]{36}$
delivery
object
sessionId
string
Pattern: ^asst_[a-f0-9-]{36}$
threadBrief
string
Maximum string length: 4000
threadTitle
string
conversation
object
agents
object[]
conversationToken
string

Private guest token. Send as X-Assist-Token for subsequent requests.

Last modified on November 15, 2026