API ReferenceAPI ReferenceFlights

Replace a flight's active catalog by external id

Fully replaces the set of titles actually loaded on a flight, given their external ids in a source-system namespace. Designed for the short boarding window: ids only — nothing is embedded or re-ingested here, so the call is fast and retry-safe. The flight must already be registered (else 404). Ids that cannot be resolved to a known platform title are reported back verbatim in unresolvedExternalIds and are NEVER guessed — resolve them by ingesting those titles centrally first. Once set, a flight's active catalog only ever NARROWS what a session bound to that flight sees; it never overrides age gating.

Authentication

AuthorizationBearer

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

Path parameters

flightInstanceIdstringRequired

Request

This endpoint expects an object.
sourceSystemstringRequired

The id-namespace token the externalTitleIds belong to — the same sourceSystem value used when the titles were centrally ingested.

externalTitleIdslist of stringsRequired

The external ids of every title loaded on this flight — at least 1, at most 10,000 per request.

Response

OK
activeCountinteger or string

The number of titles now in this flight’s active set: the count of DISTINCT titles the submitted ids resolved to. Several external ids can name the same title (for example separate ids for two encodes of one film), so this can be lower than the number of ids that resolved — it always equals the size of the set the flight now carries.

schemaVersionstring
unresolvedExternalIdslist of strings

Submitted ids with no known platform title, echoed verbatim. Empty = every id resolved.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error