Customer roster completion on the checkout page (warm carts)

POST

/p/{token}/riders

curl --request POST \
  --url https://quikstik-core.fly.dev/p/example/riders \
  --header 'Content-Type: application/json' \
  --data '{ "riders": [ { "display_name": "example", "email": "example", "height_cm": 1, "height_trait_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" } ] }'

• Production

Replace the pending proposal’s rider list. The capability token IS the authorization, exactly like the pay leg. Riders are stamped source: customer server-side — the page cannot claim staff provenance. Roster may be partial (blanks stay honest); it may never exceed the proposal’s units. 409 once the proposal is finalized or expired: a late edit never rewrites a booked roster.

Parameters

Path Parameters

token

required

string

Request Body^required

Media typeapplication/json

object

riders

required

Array<object>

object

display_name

string

email

string

nullable

height_cm

integer

nullable

height_trait_id

string format: uuid

nullable

Example ^generated

{
  "riders": [
    {
      "display_name": "example",
      "email": "example",
      "height_cm": 1,
      "height_trait_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
    }
  ]
}

Responses

204

Roster replaced.

404

Unknown token.

409

No longer pending.

422

Riders exceed units.

503

Checkout backend unavailable.