Skip to main content

​
Method

POST /v1/bookings/wizard/session

​
Body Parameters

​
Headers

​
Authorization
string
Bearer token (requires bookings:write).
​
content-type
string
application/json

​
Request Example

curl -X POST "https://api.voyantcloud.com/v1/bookings/wizard/session" \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "id": "wzd_01J0C6ZFWN6JQM4TP7A1ZA6X0M",
    "language": "en",
    "currency": "EUR",
    "step": 2,
    "data": {
      "step_1": { "productId": "prod_123", "departureId": "dep_456" },
      "step_2": {
        "departureId": "dep_456",
        "rooms": [{ "categoryKey": "double", "occupancy": 2, "quantity": 1 }]
      }
    }
  }'

​
Response Fields

​
id
uuid
required
Wizard session identifier.
​
created
boolean
Returned when a new session record was inserted.
​
upserted
boolean
Returned when an existing session was merged.

​
Response Example

{ "id": "wzd_01J0C6ZFWN6JQM4TP7A1ZA6X0M", "upserted": true }
When id references a consumed or completed session, the API creates a fresh session and returns the new identifier.