GET
Get session

Authorizations

Authorization
string
header
required

Every request carries a bearer API key, which looks like ph_live_.... Keep keys server-side, because a key grants full control of your sessions. A missing header returns 401; an invalid or revoked key currently returns 403, so treat the two together as authentication failure.

Path Parameters

session_id
string
required

Response

Successful Response

session_id
string
required

The session id, used in every session-scoped call.

state
string
required

starting, ready, closing, or dead.

mode
string
required

ephemeral or persistent.

owner
string
required

The account that owns the session.

region
string | null

The region the session runs in, or null for the default.

worker_id
string | null

Internal placement identifier. May be null.

connect_url
string | null

A ready-to-use CDP endpoint. Populated only by session create and /connect; always null when a session is read back.

connect_expires_in
integer | null

Seconds until connect_url stops working. 300 on create; null when a session is read back.