Submit field values and an action for the current step

Advances the session by submitting user input. Requires an Idempotency-Key header (max 256 chars) to prevent duplicate processing. stateVersion provides optimistic concurrency control — must match the current version.

If the step declares a payment field, the X-Payment header must contain a base64-encoded x402 Permit2 payment proof. On successful settlement the response includes paymentReceipt and a X-Payment-Response header.

Path Params
string
required
length ≥ 1
string
required
length ≥ 1
Body Params
fieldValues
object
required

Key–value map of field IDs to submitted values

string
required
length ≥ 1

Action ID from the StepSpec's actions array

integer
required
≥ 1

Must match the current session state version (optimistic lock)

Headers
string
required
length between 1 and 256

Unique key for idempotent submission. Cached per session.

string

Base64-encoded x402 Permit2 payment proof (required when step has payment)

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json