Skip to main content
GET
TypeScript SDK
The response carries the session’s status and metadata, including any actions waiting on you. To read a session’s messages and agent thinking, use Query session events.

Authorizations

Authorization
string
header
required

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

Headers

Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Path Parameters

session_id
string
required

The ID of the session to retrieve.

Response

object
string
required

Always session

Allowed value: "session"
id
string
required
agent_id
string
required
title
string
required
status
enum<string>
required

One of: queued, in_progress, requires_action, completed, failed, canceled, terminated

Available options:
queued,
in_progress,
requires_action,
completed,
failed,
canceled,
terminated
created_at
string<date-time>
required
updated_at
string<date-time>
required
created_by
object
required
agent_version
object | null
required
models
object
required
required_actions
object[]
error
object
trigger_type
string
type_labels
string[] | null
chat_user_emails
string[] | null
tool_types
string[] | null
tool_call_count
integer | null
Required range: x >= 0
credits_used
number | null
runs_completed
integer | null
Required range: x >= 0
message_count
integer | null
Required range: x >= 0