Sign in
flight-booking

Update Flight Booking Session

Patch an existing flight-booking session.

patch/flight-booking/sessions/{session_id}

Path parameters

session_idstring uuid required

Request body

checkout_step'info' | 'ancillaries' | 'payment' | 'processing' | 'confirmed' | 'failed' nullable
status'active' | 'awaiting_payment' | 'processing' | 'completed' | 'failed' | 'abandoned' | 'manual_recovery_required' nullable
payloadobject nullable
booking_idstring nullable
operator_task_idstring uuid nullable
payment_method_idstring nullable
stripe_customer_idstring nullable
payment_intent_idstring nullable
charged_amount_centsinteger nullable
currencystring nullable
payment_statusstring nullable
failure_reasonstring nullable
idempotency_keystring nullable
hotel_intent'yes' | 'no' nullable

FAC-942 staying declaration. 'yes' re-prices the session to the bundle tier (server-derived, unconditional, never re-raises) and guarantees a post-booking stays text; 'no' suppresses hotel-offer wakes for the trip. Price is never accepted from the client.

Response

Successful Response

idstring uuid required
user_idstring uuid required
observation_idstring uuid required
checkout_step'info' | 'ancillaries' | 'payment' | 'processing' | 'confirmed' | 'failed' required
status'active' | 'awaiting_payment' | 'processing' | 'completed' | 'failed' | 'abandoned' | 'manual_recovery_required' required
payloadobject required
fare_family_namestring nullable required
fare_family_sourcestring nullable
fare_family_idstring nullable
booking_idstring nullable required
operator_task_idstring uuid nullable required
expires_atstring date-time required
payment_method_idstring nullable required
stripe_customer_idstring nullable required
payment_intent_idstring nullable required
charged_amount_centsinteger nullable required
currencystring nullable required
payment_statusstring nullable required
failure_reasonstring nullable required
idempotency_keystring nullable required
discount_tier'flight_only' | 'bundle'

Pricing tier this session is priced at (FAC-942). A 'yes' staying declaration cuts a 'bundle'-tier successor session; the tier never downgrades. Nothing hotel-shaped is persisted on the session — the declaration's 'why' lives in trip_facts.hotel_intent.

traveler_namesstring[]

Resolved passenger names from traveler_profile_ids in payload

required_traveler_fieldsTravelerField[]

Traveler profile fields the client must collect before payment.

adult_gate_exemptboolean

True when the session owner is on the legal-approved allowlist exempt from the 18+ accompanying-adult gate. Clients must skip their traveler-form adult-age check when set; the server-side payment gate applies the same allowlist.

optional_traveler_fieldsTravelerField[]

Traveler-identity fields the client may offer for this flight (e.g. KTN, loyalty). Never blocks payment, distinct from required_traveler_fields.

purchase_intent_idstring uuid nullable

Durable single-use purchase commitment this session belongs to (ENG-24229). None for sessions created before the intent rollout.

purchase_intent_status'open' | 'committing' | 'booked' nullable

Current lifecycle of the session's purchase intent. 'booked' means the commitment was already consumed — clients must render the existing booking instead of a payment surface.

purchase_intent_booking_idstring nullable

Booking that consumed the purchase intent. May belong to a sibling session of the same commitment.

created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this endpoint across all 2 revisions of this API.