Skip to main content
GET
Get Session

Authorizations

Authorization
string
header
required

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

Path Parameters

session_id
string
required

Session ID

Response

Successful Response

Response for retrieving session metadata.

Attributes: session_id: Session identifier namespace_id: Namespace identifier internal_id: Organization internal ID user_id: Optional user identifier session_name: Auto-generated session name (null until first message) agent_config: Agent configuration user_memory: User memory/preferences status: Session status message_count: Total messages in session stats: Session statistics created_at: Creation timestamp updated_at: Last update timestamp last_activity_at: Last activity timestamp expires_at: Expiration timestamp

Example: python response = GetSessionResponse( session_id="ses_abc123", namespace_id="ns_xyz789", internal_id="int_abc123", session_name="Video search for ML tutorials", agent_config=AgentConfig(...), status="active", message_count=10, stats=SessionStats(...) )

session_id
string
required

Session identifier

namespace_id
string
required

Namespace identifier

internal_id
string
required

Organization internal ID

agent_config
AgentConfig · object
required

Agent configuration

Examples:
status
enum<string>
required

Session status

Available options:
active,
idle,
archived,
terminated
message_count
integer
required

Total messages in session

stats
SessionStats · object
required

Session statistics

created_at
string<date-time>
required

Creation timestamp

updated_at
string<date-time>
required

Last update timestamp

last_activity_at
string<date-time>
required

Last activity timestamp

expires_at
string<date-time>
required

Expiration timestamp

user_id
string | null

User identifier

session_name
string | null

Auto-generated session name based on first conversation

user_memory
User Memory · object

User memory/preferences