Skip to main content

recordingsList

Returns a cursor-paged recordings feed for one site with watch state and per-recording permissions. Use order for sorted matches, including watched or short recordings excluded by recordingsDataForAi. Cursors are opaque and accumulate previously seen ids. Requires recordings view access.

recordingsList(
  site: Int!
  filters: String!
  cursor: String
  limit: Int
  order: RecordingsListOrder!
): RecordingsListMeta

Arguments​

recordingsList.site ● Int! non-null scalar​

Site id from sites; the site must be accessible to the current viewer.

recordingsList.filters ● String! non-null scalar​

JSON-encoded string. Envelope: {"version":2,"operator":"AND","conditions":[...]}, where operator is uppercase AND or OR and conditions is a non-empty list of nested groups or leaves. A leaf has criteria, comparison only when the criterion takes one, and value or values (plus multiple_values where required). Call recordingsCriteriaDefinition for the criteria catalog; the recordings-filter skill is the long-form reference. Example: {"version":2,"operator":"AND","conditions":[{"criteria":"date_range","value":{"special":"last 30 days"}}]}

recordingsList.cursor ● String scalar​

Opaque nextPageCursor from recordingsList; omit or pass null to start. Accumulates seen ids.

recordingsList.limit ● Int scalar​

Page size from 1 to 200; defaults to 50.

recordingsList.order ● RecordingsListOrder! non-null input​

Sort descriptor; pass {} for newest first. Recorded time breaks ties for other sort fields.

Type​

RecordingsListMeta object​

Cursor-paged recording feed metadata returned by recordingsList; nextPageCursor is opaque and accumulates previously seen ids for infinite-scroll pagination.