Read a session's status
GET
/sessions/{id}/status
const url = 'https://api.canopyhq.dev/sessions/000000000000000000000000000000000000000000000000000000000000000000000000/status';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.canopyhq.dev/sessions/000000000000000000000000000000000000000000000000000000000000000000000000/status \ --header 'Authorization: Bearer <token>'The session’s current position and work, read under its session token.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
A stream id: 72 hex chars, the shard then the owner digest.
string
The session to inspect.
Responses
Section titled “Responses”The session’s head, active turn, and measured context.
Media typeapplication/json
object
archived
required
boolean
context
One of:
null
What the last completed inference was told, against the threshold this
session’s option compacts at. A compaction leaves tokens standing
until the next completion; at against head is what says so.
object
at
required
Monotonic per-stream position, minted at the single point of intake. Producers never carry or assert one.
integer format: int64
compact_at
required
integer format: int64
tokens
required
integer format: int64
head
required
Monotonic per-stream position, minted at the single point of intake. Producers never carry or assert one.
integer format: int64
id
required
A stream id: 72 hex chars, the shard then the owner digest.
string
Example
{ "id": "000000000000000000000000000000000000000000000000000000000000000000000000", "live": { "phase": "thinking" }}No valid session token.
The token does not read every public session record.