The session's current position and work, read under its session token.

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>'

Authorizations

session_token

Parameters

Path Parameters

required

A stream id: 72 hex chars, the shard then the owner digest.

string

The session to inspect.

Responses

200

The session’s head and active turn.

application/json

object

archived

required

boolean

head

required

Monotonic per-stream position, minted at the single point of intake. Producers never carry or assert one.

integer format: int64

required

A stream id: 72 hex chars, the shard then the owner digest.

string

live

One of:

null
object

null

Example

{
  "id": "000000000000000000000000000000000000000000000000000000000000000000000000",
  "live": {
    "phase": "thinking"
  }
}

401

No valid session token.

403

The token does not read every public session record.