Get session
Reads a session back. connect_url is always null here by design, because connect tokens are minted on demand and never stored. Use /connect to obtain one.
Authorizations
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
Response
Successful Response
The session id, used in every session-scoped call.
starting, ready, closing, or dead.
ephemeral or persistent.
The account that owns the session.
The region the session runs in, or null for the default.
Internal placement identifier. May be null.
A ready-to-use CDP endpoint. Populated only by session create and /connect; always null when a session is read back.
Seconds until connect_url stops working. 300 on create; null when a session is read back.