Commit Wizard Session

Validate a wizard session and create a draft booking.

Method

POST /v1/bookings/wizard/:id/commit

Path Parameters

id · uuid · required

Wizard session ID to commit.

Headers

Authorization · string

Bearer token (requires bookings:write).

Request Example

cURL

curl -X POST "https://api.voyantcloud.com/v1/bookings/wizard/wzd_01J0C6ZFWN6JQM4TP7A1ZA6X0M/commit" \
  -H "Authorization: Bearer $VOYANT_API_KEY"

Response Fields

ok · boolean

true when the booking was created successfully.

bookingId · uuid

Identifier of the newly created (or reused) booking.

reused · boolean

Only present when an existing booking was already linked to the session.

Response Example

200 OK

{ "ok": true, "bookingId": "bk_01J0C8BES5X40MNW873RG6DTDR" }

The commit endpoint validates workspace-configured billing and passenger forms. If validation fails, the response contains a detailed issues array describing invalid fields.