Skip to main content
GET
Get Session Detail

Authorizations

x-api-key
string
header
required

Path Parameters

session_id
string<uuid>
required

Response

Successful Response

id
string<uuid>
required
title
string | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
usage
SessionUsage · object
required

Per-chat token + cost totals, summed across the session's messages.

messages
MessageResponse · object[]
required
messages_next_cursor
string | null
has_more_messages
boolean
default:false
pending_approvals
PendingApproval · object[]
budget
BudgetStatus · object | null

Daily org spend-budget snapshot for the client's soft-warning banner.

near_limit is set once spend crosses ask_feather_daily_org_budget_alert_ratio of the budget; reset_at is epoch seconds of the next UTC midnight.

active_turn
ActiveTurn · object | null

The session's current in-flight turn, so a client that lost its turn_id (page refresh, new tab, dropped connection) can rediscover it and re-subscribe to …/turns/{turn_id}/stream (ENG-860 Phase 4). None on session-detail when the latest turn is terminal (nothing to reconnect to).