Submit field values
Submits field values for the login form. Poll the auth connection to track progress and get results.
/auth/connections/{id}/submitSubmits field values for the login form. Poll the auth connection to track progress and get results.
Authorization
bearerAuth In: header
Path Parameters
Auth connection ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request to submit field values, click an SSO button, select an MFA method, or select a sign-in option. Prefer canonical selected_choice_id/field_values when the API returns fields/choices; legacy fields/sso_button_selector/sso_provider/mfa_option_id/sign_in_option_id remain supported during deprecation.
Response
Submission accepted for processing
Response from submitting field values
curl -X POST "https://example.com/auth/connections/string/submit" \ -H "Content-Type: application/json" \ -d '{}'{ "accepted": true}{ "code": "string", "message": "string", "details": [ { "code": "string", "message": "string" } ], "inner_error": { "code": "string", "message": "string" }}{ "code": "string", "message": "string", "details": [ { "code": "string", "message": "string" } ], "inner_error": { "code": "string", "message": "string" }}{ "code": "string", "message": "string", "details": [ { "code": "string", "message": "string" } ], "inner_error": { "code": "string", "message": "string" }}{ "code": "string", "message": "string", "details": [ { "code": "string", "message": "string" } ], "inner_error": { "code": "string", "message": "string" }}{ "code": "string", "message": "string", "details": [ { "code": "string", "message": "string" } ], "inner_error": { "code": "string", "message": "string" }}postStart login flow
Starts a login flow for the auth connection. Returns immediately with a hosted URL for the user to complete authentication, or triggers automatic re-auth if credentials are stored.
getStream login flow events via SSE
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).