Get an authorization session

Returns the current status of an in-flight authorization session. The optional wait_seconds query param (1-25, default 1) keeps the request open up to that many seconds, returning early if the session completes. Poll until status is COMPLETED.

GET /v1/fleet/auth-sessions/{session_id}

Error

A valid request URL is required to generate request examples

200

{
  "id": "<string>"
}

Authorizations

API KeyTenant IDBearer Auth

X-API-Key · string · header · required

Path Parameters

session_id · string · required

Authorization session ID

Query Parameters

wait_seconds · integer

Long-poll window in seconds (1-25, default 1)

Response

200

application/json

OK

id · string

status · enum<string>

Available options: PENDING, COMPLETED, CONNECTION_REQUIRED, TOKEN_EXPIRED