action britbox_get_item_media_files {
  label: "getItemMediaFiles"
  description: "Get the video files associated with an item given maximum resolution, device type\nand one or more delivery types.\n\nThis endpoint accepts an Account Catalog token, however if when requesting\nplayback files you receive an *403 status code with error code 1* then the file\nyou're requesting is classification restricted. This means you should switch\nto target the `/account/items/{id}/videos-guarded` endpoint, passing it an Account\nPlayback token. If not already obtained, this token can be requested via the\n`/itv/pinauthorization` endpoint with an account level pin.\n\nFor convenience you may also access free / public files through this endpoint\ninstead of the /items/{id}/videos endpoint, when authenticated.\n\nReturns an array of video file objects which each include a url to a video.\n\nThe first entry in the array contains what is predicted to be the best match.\nThe remainder of the entries, if any, may contain resolutions below what was\nrequests. For example if you request HD-720 the response may also contain\nSD entries.\n\nIf you specify multiple delivery types, then the response array will insert\ntypes in the order you specify them in the query. For example `stream,progressive`\nwould return an array with 0 or more stream files followed by 0 or more progressive files.\n\nIf no files are found a 404 is returned.\n"
  provider: britbox
  method: GET
  path: "/account/items/{id}/videos"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "string"
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      type: "object"
      required: ["name", "deliveryType", "url", "drm", "format", "resolution", "width", "height", "language"]
      properties: {
        channels: {
          type: "integer"
          format: "int32"
          description: "The number of audio channels."
        }
        deliveryType: {
          type: "string"
          description: "The way in which the media file is delivered."
          enum: ["Stream", "Progressive", "Download"]
        }
        drm: {
          type: "string"
          description: "The type of drm used to encrypt the media. 'None' if unencrypted."
        }
        format: {
          type: "string"
          description: "The format the media was encoded in."
        }
        height: {
          type: "integer"
          format: "int32"
          description: "The height of the video media."
        }
        language: {
          type: "string"
          description: "The language code for the media, e.g. 'en'."
        }
        name: {
          type: "string"
          description: "The name of the media file."
        }
        resolution: {
          type: "string"
          description: "The resolution of the video media."
          enum: ["SD", "HD-720", "HD-1080", "HD-4K", "External", "Unknown"]
        }
        url: {
          type: "string"
          format: "uri"
          description: "The url to access the media file."
        }
        width: {
          type: "integer"
          format: "int32"
          description: "The width of the video media."
        }
      }
      additionalProperties: false
    }
  }
}