Mux Video View Drilldown

arazzo: 1.0.1
info:
  title: Mux Video View Drilldown
  summary: List recent video views in a timeframe, then fetch the full detail of the first matching view.
  description: >-
    The standard Mux Data investigation pattern for debugging a viewer
    experience. The workflow lists video views within a timeframe and optional
    filters, captures the id of the first view in the result set, and then
    fetches the full video view detail including playback events, errors, and
    device context. Every step spells out its request inline so the flow can be
    read and executed without opening the underlying OpenAPI description.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-3770.10
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-3770.10
      capability_name: Viewership Data Capture
      spec: mux-com-video-views-api-openapi.yml
      confidence: 0.7
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: videoViewsApi
  url: ../openapi/mux-com-video-views-api-openapi.yml
  type: openapi
workflows:
- workflowId: video-view-drilldown
  summary: List video views and drill into the first view's full detail.
  description: >-
    Lists video views within a timeframe, then reads the full detail of the
    first returned view.
  inputs:
    type: object
    required:
    - timeframe
    properties:
      timeframe:
        type: array
        description: Timeframe window for the views (e.g. ["7:days"] or two epoch timestamps).
        items:
          type: string
      filters:
        type: array
        description: Optional key:value filter clauses to narrow the views (e.g. ["country:US"]).
        items:
          type: string
      limit:
        type: integer
        description: Maximum number of views to return.
        default: 25
  steps:
  - stepId: listViews
    description: >-
      List video views within the supplied timeframe and filters, ordered by
      most recent.
    operationId: list-video-views
    parameters:
    - name: timeframe[]
      in: query
      value: $inputs.timeframe
    - name: filters[]
      in: query
      value: $inputs.filters
    - name: limit
      in: query
      value: $inputs.limit
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      views: $response.body#/data
      firstViewId: $response.body#/data/0/id
      totalRowCount: $response.body#/total_row_count
  - stepId: getViewDetail
    description: >-
      Fetch the full detail of the first returned video view, including its
      playback events and any errors.
    operationId: get-video-view
    parameters:
    - name: VIDEO_VIEW_ID
      in: path
      value: $steps.listViews.outputs.firstViewId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      view: $response.body#/data
  outputs:
    views: $steps.listViews.outputs.views
    firstViewId: $steps.listViews.outputs.firstViewId
    view: $steps.getViewDetail.outputs.view