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. A session the token can’t read returns 404. See session access rules.

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

Premium AI credits this session consumed. Values of 0.01 or more have at most two decimal places, and values below 0.01 have at most two significant figures. Both round down.

runs_completed
integer | null
Required range: x >= 0
message_count
integer | null
Required range: x >= 0