Mux Account Delivery Usage Audit

arazzo: 1.0.1
info:
  title: Mux Account Delivery Usage Audit
  summary: Confirm the active environment with whoami, then list per-asset delivery usage for a timeframe to audit billed delivery.
  description: >-
    A billing and reporting pattern that grounds a delivery usage pull in the
    correct Mux environment. The workflow reads the whoami details to confirm the
    organization and environment the access token belongs to, then lists per-asset
    delivery usage over a timeframe so billed seconds of delivery can be audited
    against expectations. 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
sourceDescriptions:
- name: deliveryUsageApi
  url: ../openapi/mux-com-delivery-usage-api-openapi.yml
  type: openapi
- name: utilitiesApi
  url: ../openapi/mux-com-utilities-api-openapi.yml
  type: openapi
workflows:
- workflowId: account-delivery-usage
  summary: Confirm the environment, then list delivery usage for a timeframe.
  description: >-
    Reads whoami to confirm the environment, then lists per-asset delivery usage
    over the supplied timeframe.
  inputs:
    type: object
    properties:
      timeframe:
        type: array
        description: Time window for delivery usage as two epoch second timestamps (start, end).
        items:
          type: integer
      limit:
        type: integer
        description: Maximum number of delivery usage rows to return.
        default: 100
  steps:
  - stepId: whoami
    description: >-
      Read the whoami details to confirm the organization and environment the
      access token belongs to before pulling usage.
    operationId: get-whoami
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      environmentName: $response.body#/data/environment_name
      organizationName: $response.body#/data/organization_name
  - stepId: listDeliveryUsage
    description: >-
      List per-asset delivery usage over the timeframe so billed delivery seconds
      can be audited.
    operationId: list-delivery-usage
    parameters:
    - name: timeframe[]
      in: query
      value: $inputs.timeframe
    - name: limit
      in: query
      value: $inputs.limit
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      usage: $response.body#/data
      totalRowCount: $response.body#/total_row_count
  outputs:
    environmentName: $steps.whoami.outputs.environmentName
    organizationName: $steps.whoami.outputs.organizationName
    usage: $steps.listDeliveryUsage.outputs.usage