Skip to main content

recordingsGroups

Returns cursor-paged groups keyed by normalized first or last page, ordered by recording count descending and then latest recording descending. Use recordingsInGroup for the recordings inside one group; includeFirst can prepend a matching group on the first request. Cursors are opaque and accumulate seen group ids. Requires recordings view access.

recordingsGroups(
  site: Int!
  groupBy: RecordingGroupBy!
  filters: String!
  cursor: String
  limit: Int
  includeFirst: String
): RecordingsGroupsMeta

Arguments​

recordingsGroups.site ● Int! non-null scalar​

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

recordingsGroups.groupBy ● RecordingGroupBy! non-null enum​

Group on normalized first page (FIRST) or last page (LAST); use the same choice for group lookup.

recordingsGroups.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"}}]}

recordingsGroups.cursor ● String scalar​

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

recordingsGroups.limit ● Int scalar​

Page size from 1 to 200; defaults to 50.

recordingsGroups.includeFirst ● String scalar​

Group id from recordingsGroups to prepend if it matches on the first request; counts toward limit. Ignored with a cursor.

Type​

RecordingsGroupsMeta object​

Cursor-paged normalized page groups with counts and thumbnails derived from a representative URL for each group. Returned by recordingsGroups.