API ReferenceAPI ReferencePersonas

Bind the session’s seat-member roster

Binds a session's declared seat-member roster: for each member, the server derives the authoritative age tier from the declared (coarse, un-trusted) age band and stores a profile keyed by airline, session, seat, and member slot. An unknown or blank age band resolves to the most-restrictive tier, never a permissive default. The response echoes the server-resolved tiers for seatback display only — every later serve/suggest/enrich call re-resolves the tier from the stored profile, never trusts this echo back. An optional per-member archetypeId associates a starting persona.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

X-Session-IdstringRequired

The passenger-session locator (a within-tenant locator, never a trust assertion). A missing or key-unsafe value is rejected 400 before this handler runs.

Request

This endpoint expects an object.
memberslist of objectsRequired
flightInstanceIdstring or nullOptional

Optional flight binding: the flight-instance identifier this session belongs to, matching an identifier registered through the flight-context write endpoint. When present, the session is bound to that flight and flight-aware reads (remaining flight time, the flight’s active catalog) resolve through the binding, replacing whatever flight the session was bound to before. When omitted, the session is left with NO flight context: any binding an earlier call made for this session is removed, and reads behave as they do for a session that never named a flight. Each call therefore sets the session’s flight context in full — it is never merged with an earlier call’s. At most 128 characters, and control characters are rejected; a rejected value is never echoed back in the error. Check flightBindingApplied on the response to confirm the binding took effect.

Response

OK
correlationIdstring
boundMembersinteger or string
ageTierslist of enums

The server-resolved tiers, in the same order as the request’s members — echoed for display only, never trusted back.

flightBindingAppliedboolean

Whether the flight-context outcome this request asked for is now in effect. True when the session is bound to the flightInstanceId the request supplied — or, when the request omitted it, when any binding an earlier call left on this session was removed. False means the flight step did NOT take effect and the session’s flight context is unchanged from before this call: results are not narrowed to the flight you named, or a flight bound by an earlier call may still narrow them. The seat roster above is bound either way — a flight-context failure never fails the request — so repeat the call to re-apply it.

schemaVersionstringOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error