Sign in

v97

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-31135175384.2 KB
Managed Auth

Get auth connection event timeline

Returns a chronological timeline of events for an auth connection — login attempts, automatic re-auth attempts, and health checks. Events are returned newest-first.

get/auth/connections/{id}/timeline

Path parameters

idstring required

Auth connection ID

Query parameters

type'login' | 'reauth' | 'health_check'

Filter the timeline to a single event type.

limitinteger

Maximum number of events to return

offsetinteger

Number of events to skip

Response

Event timeline for the auth connection

type'login' | 'reauth' | 'health_check' required

The kind of event. "login" and "reauth" are authentication attempts; "health_check" is a periodic session-validity check.

idstring required

Identifier of the underlying login/reauth session or health check.

timestampstring date-time required

When the event occurred.

status'IN_PROGRESS' | 'SUCCESS' | 'EXPIRED' | 'CANCELED' | 'FAILED' | 'AUTHENTICATED' | 'NEEDS_AUTH' required

Outcome of the event. For login/reauth events this is the flow status (IN_PROGRESS, SUCCESS, EXPIRED, CANCELED, FAILED). For health_check events it is the observed session state (AUTHENTICATED, NEEDS_AUTH).

previous_status'AUTHENTICATED' | 'NEEDS_AUTH'

The session state observed before this event. Present for health_check events that recorded a prior state.

step'INITIALIZED' | 'DISCOVERING' | 'AWAITING_INPUT' | 'AWAITING_EXTERNAL_ACTION' | 'AWAITING_HUMAN_INTERVENTION' | 'SUBMITTING' | 'COMPLETED' | 'EXPIRED'

The step the flow reached. Present for login/reauth events.

error_codestring

Machine-readable error code. Present when a login/reauth event failed.

error_messagestring

Human-readable error message. Present when a login/reauth event failed.

website_errorstring

Visible error message from the website (e.g., 'Incorrect password'). Present when the website displayed an error during the attempt.

browser_session_idstring

Browser session that produced the event, if one was created.

replay_idstring

Replay recording ID for the event's browser session, if session recording was enabled.

telemetry_capturedboolean

Whether browser telemetry capture started for this event's browser session.

updated_atstring date-time

When the event was last updated. Present for login/reauth events.