Submit client-side event
Submits telemetry or fingerprint data from the frontend. Does not advance the state machine. Used for risk evaluation.
Submits telemetry or fingerprint data from the frontend. Does not advance the state machine. Used for risk evaluation.
Path Parameters
Flow ID returned by POST /flow or the latest POST /flow/{id}/submit.
Used to look up the correct flow state from the encrypted cookie,
which can hold multiple concurrent flows. May change between responses
when a flow pivot or pop occurs — always use the id from the latest response.
Cookie Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/flow/flow_01H8Z/event" \ --cookie "_zflow=string" \ -H "Content-Type: application/json" \ -d '{ "type": "fingerprint" }'{ "code": "string", "message": "string", "details": {}}{ "code": "string", "message": "string", "details": {}}{ "code": "string", "message": "string", "details": {}}Submit step data and advance POST
Submits user input for the current step. The server validates, processes (e.g., verifies a credential), advances the state machine through any invisible steps, and returns the next visible step. The response sets an updated encrypted `HttpOnly` cookie (`_zflow`) with the new flow state. The server is stateless — all orchestration state is carried in this cookie between requests. **Important:** The `id` in the response may differ from the `id` used in the request. This happens when a flow pivots (pushes a new flow onto the stack) or when a stacked flow completes (auto-pops to the parent flow). Always use the `id` from the latest response for the next request. ## Flow completion When `step.type` is `complete`, the flow is terminal. The `step.behavior` field tells the frontend what to do: | `behavior` | Action | |------------- |------------------------------------------------------------| | `redirect` | Navigate to `redirect_uri` (OIDC/SAML auth request done). | | `show` | Render the step as a success screen (e.g., registration). | A `complete` step is only returned when the **entire flow stack** is done. If a stacked flow (e.g., recovery pivoted from login) finishes, the server auto-pops to the parent flow and returns the parent's next step — the frontend never sees a `complete` for intermediate flows.
Authentication Attempts
OpenAPI operations for the authentication attempt state machine.