DashboardChangelogCareersSign up
GuidesAPI ReferenceCLIMCP
GET/auth/connections/{id}/events

Establishes a Server-Sent Events (SSE) stream that delivers real-time login flow state updates. The stream terminates automatically once the flow reaches a terminal state (SUCCESS, FAILED, EXPIRED, CANCELED).

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id*string

The auth connection ID to follow.

Response Body

text/event-stream

application/json

application/json

application/json

curl -X GET "https://example.com/auth/connections/string/events"
{  "event": "managed_auth_state",  "timestamp": "2019-08-24T14:15:22Z",  "flow_status": "IN_PROGRESS",  "flow_step": "DISCOVERING",  "flow_type": "LOGIN",  "fields": [    {      "id": "string",      "ref": "string",      "type": "identifier",      "label": "string",      "required": true,      "observed_selector": "string"    }  ],  "choices": [    {      "id": "string",      "type": "mfa_method",      "label": "string",      "description": "string",      "observed_selector": "string"    }  ],  "discovered_fields": [    {      "name": "string",      "type": "text",      "label": "string",      "placeholder": "string",      "required": true,      "selector": "string",      "linked_mfa_type": "sms",      "hint": "string"    }  ],  "mfa_options": [    {      "type": "sms",      "label": "string",      "target": "string",      "description": "string"    }  ],  "sign_in_options": [    {      "id": "string",      "label": "string",      "description": "string"    }  ],  "pending_sso_buttons": [    {      "selector": "string",      "provider": "string",      "label": "string"    }  ],  "external_action_message": "string",  "website_error": "string",  "error_message": "string",  "error_code": "string",  "post_login_url": "http://example.com",  "live_view_url": "http://example.com",  "hosted_url": "http://example.com"}

Submit field values POST

Submits field values for the login form. Poll the auth connection to track progress and get results.

Get auth connection event timeline GET

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