v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-275867561.6 MB
fleet auth

Start an authorization session

Initiates an OAuth flow for the caller. If the user is already authorized, returns a completed session that references an existing token. Otherwise, returns a pending session containing a verification URL the user must visit to complete authorization.

post/v1/fleet/auth-sessions

Request body

agent_idstring
is_defaultboolean
provider_idstring
scopesstring[]
strategy'REUSE' | 'CREATE'
token_idstring

Response

Existing token reused; no new session created.

idstring
metadataobject
provider_idstring
status'PENDING' | 'COMPLETED' | 'CONNECTION_REQUIRED' | 'TOKEN_EXPIRED'
tokenstring
verification_urlstring