Mux Assets API

openapi: 3.1.0
info:
  title: Mux Animated Images Assets API
  description: Mux is how developers build online video. This API encompasses both Mux Video and Mux Data functionality to help you build your video-related projects better and faster than ever before.
  version: v1
  contact:
    name: Mux DevEx
    url: https://docs.mux.com
    email: devex@mux.com
servers:
- url: https://api.mux.com
  description: Mux Production API
- url: https://image.mux.com
- url: https://stream.mux.com
- url: https://stats.mux.com
tags:
- name: Assets
  description: 'An asset refers to a piece of media content that is stored or is being live streamed through the Mux system. An asset always has a duration and one or more tracks (audio, video, and text data).


    The media content of an asset cannot be updated once created, however an asset can be used to create another asset, and can be modified within that process.'
  x-displayName: Assets
paths:
  /video/v1/assets:
    post:
      tags:
      - Assets
      summary: Create an Asset
      description: Create a new Mux Video asset.
      operationId: create-asset
      servers:
      - url: https://api.mux.com
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAssetRequest'
            example:
              inputs:
              - url: https://muxed.s3.amazonaws.com/leds.mp4
              playback_policies:
              - public
              video_quality: basic
      responses:
        '201':
          description: Asset Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetResponse'
              example:
                data:
                  status: preparing
                  playback_ids:
                  - policy: public
                    id: uNbxnGLKJ00yfbijDO8COxTOyVKT01xpxW
                  master_access: none
                  id: SqQnqz6s5MBuXGvJaUWdXuXM93J9Q2yv
                  encoding_tier: baseline
                  video_quality: basic
                  created_at: '1607452572'
                  max_resolution_tier: 1080p
                  progress:
                    state: ingesting
                    progress: 0
      security:
      - accessToken: []
      - authorizationToken: []
    get:
      tags:
      - Assets
      summary: List Assets
      description: List all Mux assets.
      operationId: list-assets
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/cursor'
      - $ref: '#/components/parameters/list_asset_live_stream_id'
      - $ref: '#/components/parameters/list_asset_upload_id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAssetsResponse'
              example:
                next_cursor: tF601CUtCLmnYuHW01Vwl6BWcWTNv001uoaiK4C01jqk1acX802plAjZhTQ
                data:
                - tracks:
                  - type: video
                    max_width: 1920
                    max_height: 800
                    max_frame_rate: 24
                    id: HK01Bq7FrEQmIu3QpRiZZ98HQOOZjm6BYyg17eEunlyo
                    duration: 734.166667
                  - type: audio
                    max_channels: 2
                    id: nNKHJqw2G9cE019AoK16CJr3O27gGnbtW4w525hJWqWw
                    duration: 734.143991
                  status: ready
                  playback_ids:
                  - policy: public
                    id: 85g23gYz7NmQu02YsY81ihuod6cZMxCp017ZrfglyLCKc
                  max_stored_resolution: HD
                  resolution_tier: 1080p
                  max_stored_frame_rate: 24
                  master_access: none
                  id: 8jd7M77xQgf2NzuocJRPYdSdEfY5dLlcRwFARtgQqU4
                  encoding_tier: baseline
                  video_quality: basic
                  duration: 734.25
                  created_at: '1609869152'
                  aspect_ratio: '12:5'
                  max_resolution_tier: 1080p
                  progress:
                    state: completed
                    progress: 100
                - tracks:
                  - type: video
                    max_width: 1920
                    max_height: 1080
                    max_frame_rate: 29.97
                    id: RiyQPM31a1SPtfI802bEP2zD02F5FQVNL801FRHeE5t01G4
                    duration: 23.8238
                  - type: audio
                    max_channels: 2
                    id: LvINTciHVoC017knMCH01y9pSi5OrDLCRaBPNDAoNJcmg
                    duration: 23.823792
                  status: ready
                  playback_ids:
                  - policy: public
                    id: vAFLI2eKFFicXX00iHBS2vqt5JjJGg5HV6fQ4Xijgt1I
                  max_stored_resolution: HD
                  resolution_tier: 1080p
                  max_stored_frame_rate: 29.97
                  master_access: none
                  id: lJ4bGGsp7ZlPf02nMg015W02iHQLN9XnuuLRBsPS00xqd68
                  encoding_tier: smart
                  video_quality: plus
                  duration: 23.857167
                  created_at: '1609868768'
                  aspect_ratio: '16:9'
                  max_resolution_tier: 1080p
                  progress:
                    state: completed
                    progress: 100
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}:
    get:
      tags:
      - Assets
      summary: Retrieve an Asset
      description: Retrieves the details of an asset that has previously been created. Supply the unique asset ID that was returned from your previous request, and Mux will return the corresponding asset information. The same information is returned when creating an asset.
      operationId: get-asset
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetResponse'
              example:
                data:
                  tracks:
                  - type: video
                    max_width: 1920
                    max_height: 1080
                    max_frame_rate: 29.97
                    id: RiyQPM31a1SPtfI802bEP2zD02F5FQVNL801FRHeE5t01G4
                    duration: 23.8238
                  - type: audio
                    max_channels: 2
                    id: LvINTciHVoC017knMCH01y9pSi5OrDLCRaBPNDAoNJcmg
                    duration: 23.823792
                  status: ready
                  resolution_tier: 1080p
                  playback_ids:
                  - policy: public
                    id: vAFLI2eKFFicXX00iHBS2vqt5JjJGg5HV6fQ4Xijgt1I
                  passthrough: example
                  max_stored_resolution: HD
                  max_stored_frame_rate: 29.97
                  max_resolution_tier: 1080p
                  progress:
                    state: completed
                    progress: 100
                  master_access: none
                  id: lJ4bGGsp7ZlPf02nMg015W02iHQLN9XnuuLRBsPS00xqd68
                  encoding_tier: baseline
                  video_quality: basic
                  duration: 23.857167
                  created_at: '1609868768'
                  aspect_ratio: '16:9'
      security:
      - accessToken: []
      - authorizationToken: []
    delete:
      tags:
      - Assets
      summary: Delete an Asset
      description: Deletes a video asset and all its data.
      operationId: delete-asset
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      responses:
        '204':
          description: No Content
      security:
      - accessToken: []
      - authorizationToken: []
    patch:
      tags:
      - Assets
      summary: Update an Asset
      description: Updates the details of an existing Asset with the provided Asset ID. This API currently only supports the `passthrough` and `meta` fields.
      operationId: update-asset
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAssetRequest'
            example:
              passthrough: Example
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetResponse'
              example:
                data:
                  tracks:
                  - type: video
                    max_width: 1920
                    max_height: 1080
                    max_frame_rate: 29.97
                    id: RiyQPM31a1SPtfI802bEP2zD02F5FQVNL801FRHeE5t01G4
                    duration: 23.8238
                  - type: audio
                    max_channels: 2
                    id: LvINTciHVoC017knMCH01y9pSi5OrDLCRaBPNDAoNJcmg
                    duration: 23.823792
                  status: ready
                  playback_ids:
                  - policy: public
                    id: vAFLI2eKFFicXX00iHBS2vqt5JjJGg5HV6fQ4Xijgt1I
                  max_stored_resolution: HD
                  resolution_tier: 1080p
                  max_stored_frame_rate: 29.97
                  master_access: none
                  id: lJ4bGGsp7ZlPf02nMg015W02iHQLN9XnuuLRBsPS00xqd68
                  encoding_tier: baseline
                  video_quality: basic
                  duration: 23.857167
                  created_at: '1609868768'
                  updated_at: '1609869000'
                  aspect_ratio: '16:9'
                  passthrough: Example
                  max_resolution_tier: 1080p
                  progress:
                    state: completed
                    progress: 100
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}/input-info:
    get:
      tags:
      - Assets
      summary: Retrieve Asset Input Info
      description: Returns a list of the input objects that were used to create the asset along with any settings that were applied to each input.
      operationId: get-asset-input-info
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAssetInputInfoResponse'
              example:
                data:
                - settings:
                    url: https://muxed.s3.amazonaws.com/leds.mp4
                  file:
                    container_format: mp4
                    tracks:
                    - type: video
                      duration: 120
                      width: 1280
                      height: 720
                      frame_rate: 30
                      encoding: h.264
                    - type: audio
                      duration: 120
                      sample_rate: 16000
                      sample_size: 24
                      encoding: aac
                - settings:
                    url: https://example.com/myVideo_en.srt
                  file:
                    container_format: srt
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}/playback-ids:
    post:
      tags:
      - Assets
      summary: Create a Playback ID
      description: Creates a playback ID that can be used to stream the asset to a viewer.
      operationId: create-asset-playback-id
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePlaybackIDRequest'
            example:
              policy: public
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePlaybackIDResponse'
              example:
                data:
                  policy: public
                  id: Lj02VZDorh9hCV00flNqPli8fmwf6KEppug01w8zDEYVlQ
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID}:
    get:
      tags:
      - Assets
      summary: Retrieve a Playback ID
      description: Retrieves information about the specified playback ID.
      operationId: get-asset-playback-id
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      - $ref: '#/components/parameters/playback_id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAssetPlaybackIDResponse'
              example:
                data:
                  policy: public
                  id: vAFLI2eKFFicXX00iHBS2vqt5JjJGg5HV6fQ4Xijgt1I
      security:
      - accessToken: []
      - authorizationToken: []
    delete:
      tags:
      - Assets
      summary: Delete a Playback ID
      description: Deletes a playback ID, rendering it nonfunctional for viewing an asset's video content. Please note that deleting the playback ID removes access to the underlying asset; a viewer who started playback before the playback ID was deleted may be able to watch the entire video for a limited duration.
      operationId: delete-asset-playback-id
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      - $ref: '#/components/parameters/playback_id'
      responses:
        '204':
          description: No Content
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}/mp4-support:
    put:
      tags:
      - Assets
      summary: Update MP4 Support
      operationId: update-asset-mp4-support
      servers:
      - url: https://api.mux.com
      deprecated: true
      description: 'This method has been deprecated. Please see the [Static Rendition API](https://www.mux.com/docs/guides/enable-static-mp4-renditions#after-asset-creation).

        Allows you to add or remove mp4 support for assets that were created without it. The values supported are `capped-1080p`, `audio-only`, `audio-only,capped-1080p`, `standard`(deprecated),  and `none`. `none` means that an asset *does not* have mp4 support, so submitting a request with `mp4_support` set to `none` will delete the mp4 assets from the asset in question.

        '
      parameters:
      - $ref: '#/components/parameters/asset_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAssetMP4SupportRequest'
            example:
              mp4_support: capped-1080p
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetResponse'
              example:
                data:
                  tracks:
                  - type: video
                    max_width: 1920
                    max_height: 1080
                    max_frame_rate: 29.97
                    id: RiyQPM31a1SPtfI802bEP2zD02F5FQVNL801FRHeE5t01G4
                    duration: 23.8238
                  - type: audio
                    max_channels: 2
                    id: LvINTciHVoC017knMCH01y9pSi5OrDLCRaBPNDAoNJcmg
                    duration: 23.823792
                  status: ready
                  static_renditions:
                    status: preparing
                  playback_ids:
                  - policy: public
                    id: Lj02VZDorh9hCV00flNqPli8fmwf6KEppug01w8zDEYVlQ
                  mp4_support: capped-1080p
                  max_stored_resolution: HD
                  resolution_tier: 1080p
                  max_stored_frame_rate: 29.97
                  master_access: none
                  id: lJ4bGGsp7ZlPf02nMg015W02iHQLN9XnuuLRBsPS00xqd68
                  encoding_tier: smart
                  video_quality: plus
                  duration: 23.857167
                  created_at: '1609868768'
                  aspect_ratio: '16:9'
                  max_resolution_tier: 1080p
                  progress:
                    state: completed
                    progress: 100
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}/master-access:
    put:
      tags:
      - Assets
      summary: Update Master Access
      operationId: update-asset-master-access
      servers:
      - url: https://api.mux.com
      description: 'Allows you to add temporary access to the master (highest-quality) version of the asset in MP4 format. A URL will be created that can be used to download the master version for 24 hours. After 24 hours Master Access will revert to "none".

        This master version is not optimized for web and not meant to be streamed, only downloaded for purposes like archiving or editing the video offline.'
      parameters:
      - $ref: '#/components/parameters/asset_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAssetMasterAccessRequest'
            example:
              master_access: temporary
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetResponse'
              example:
                data:
                  tracks:
                  - type: video
                    max_width: 1920
                    max_height: 1080
                    max_frame_rate: 29.97
                    id: RiyQPM31a1SPtfI802bEP2zD02F5FQVNL801FRHeE5t01G4
                    duration: 23.8238
                  - type: audio
                    max_channels: 2
                    id: LvINTciHVoC017knMCH01y9pSi5OrDLCRaBPNDAoNJcmg
                    duration: 23.823792
                  status: ready
                  playback_ids:
                  - policy: public
                    id: Lj02VZDorh9hCV00flNqPli8fmwf6KEppug01w8zDEYVlQ
                  max_stored_resolution: HD
                  resolution_tier: 1080p
                  max_stored_frame_rate: 29.97
                  master_access: temporary
                  master:
                    status: preparing
                  id: lJ4bGGsp7ZlPf02nMg015W02iHQLN9XnuuLRBsPS00xqd68
                  encoding_tier: baseline
                  video_quality: basic
                  duration: 23.857167
                  created_at: '1609868768'
                  aspect_ratio: '16:9'
                  max_resolution_tier: 1080p
                  progress:
                    state: completed
                    progress: 100
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}/static-renditions:
    post:
      tags:
      - Assets
      summary: Create a Static Rendition for an Asset
      description: Creates a static rendition (i.e. MP4) for an asset
      operationId: create-asset-static-rendition
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateStaticRenditionRequest'
            example:
              resolution: highest
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateStaticRenditionResponse'
              example:
                data:
                  id: lJ4bGGsp7ZlPf02nMg015W02iHQLN9XnuuLRBsPS00xqd68
                  type: standard
                  ext: mp4
                  status: preparing
                  resolution: highest
                  name: highest.mp4
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}/static-renditions/{STATIC_RENDITION_ID}:
    delete:
      tags:
      - Assets
      summary: Delete a Single Static Rendition for an Asset
      description: Deletes a single static rendition for an asset
      operationId: delete-asset-static-rendition
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      - $ref: '#/components/parameters/static_rendition_id'
      responses:
        '204':
          description: No Content
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}/tracks:
    post:
      tags:
      - Assets
      summary: Create an Asset Track
      description: Adds an asset track (for example, subtitles, or an alternate audio track) to an asset. Assets must be in the `ready` state before tracks can be added.
      operationId: create-asset-track
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateTrackRequest'
            example:
              url: https://example.com/myVideo_en.srt
              type: text
              text_type: subtitles
              language_code: en-US
              name: English
              closed_captions: true
              passthrough: English
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateTrackResponse'
              example:
                data:
                  type: text
                  text_type: subtitles
                  status: preparing
                  passthrough: English
                  name: English
                  language_code: en-US
                  id: xBe7u01029ipxBLQhYzZCJ1cke01zCkuUsgnYtH0017nNzbpv2YcsoMDmw
                  closed_captions: true
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID}:
    delete:
      tags:
      - Assets
      summary: Delete an Asset Track
      description: Removes a text or additional audio track from an asset. Neither video nor the primary audio track can be removed.
      operationId: delete-asset-track
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      - $ref: '#/components/parameters/track_id'
      responses:
        '204':
          description: No Content
      security:
      - accessToken: []
      - authorizationToken: []
    patch:
      tags:
      - Assets
      summary: Update an Asset Track
      description: Updates the details of an existing Asset Track with the provided Asset ID and Track ID.
      operationId: update-asset-track
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      - $ref: '#/components/parameters/track_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAssetTrackRequest'
            example:
              language_code: en-US
              name: English
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateAssetTrackResponse'
              example:
                data:
                  type: text
                  text_type: subtitles
                  status: ready
                  passthrough: passthrough value
                  name: English
                  language_code: en-US
                  id: xBe7u01029ipxBLQhYzZCJ1cke01zCkuUsgnYtH0017nNzbpv2YcsoMDmw
                  closed_captions: true
      security:
      - accessToken: []
      - authorizationToken: []
  /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID}/generate-subtitles:
    post:
      tags:
      - Assets
      summary: Generate Track Subtitles
      description: Generates subtitles (captions) for a given audio track. [See docs for more information.](https://mux.com/docs/guides/add-autogenerated-captions-and-use-transcripts#retroactively-enable-auto-generated-captions)
      operationId: generate-asset-track-subtitles
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/asset_id'
      - $ref: '#/components/parameters/track_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerateTrackSubtitlesRequest'
            example:
              generated_subtitles:
              - language_code: en
                name: English (generated)
                passthrough: English (generated)
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenerateTrackSubtitlesResponse'
              example:
                data:
                - type: text
                  text_type: subtitles
                  status: preparing
                  passthrough: English (generated)
                  name: English (generated)
                  language_code: en
                  id: hXhnqUq0054k9SBFB5aczHhj6xMbOTlriTG7gqRn8kikv101lkFUgKNw
      security:
      - accessToken: []
      - authorizationToken: []
components:
  schemas:
    InputFile:
      type: object
      properties:
        container_format:
          type: string
        tracks:
          type: array
          items:
            $ref: '#/components/schemas/InputTrack'
    CreateAssetRequest:
      allOf:
      - $ref: '#/components/schemas/AssetOptions'
      - required:
        - inputs
    ListAssetsResponse:
      type: object
      required:
      - data
      - next_cursor
      properties:
        next_cursor:
          type: string
          description: If there are more pages of data, this field will contain a string that can be used with the `cursor` querystring parameter to fetch the next page of data.
          nullable: true
        data:
          type: array
          items:
            $ref: '#/components/schemas/Asset'
    CreateTrackRequest:
      type: object
      required:
      - url
      - type
      - language_code
      properties:
        url:
          type: string
          description: 'The URL of the file that Mux should download and use.

            * For `audio` tracks, the URL is the location of the audio file for Mux to download, for example an M4A, WAV, or MP3 file. Mux supports most audio file formats and codecs, but for fastest processing, you should [use standard inputs wherever possible](https://docs.mux.com/guides/minimize-processing-time).

            * For `text` tracks, the URL is the location of subtitle/captions file. Mux supports [SubRip Text (SRT)](https://en.wikipedia.org/wiki/SubRip) and [Web Video Text Tracks](https://www.w3.org/TR/webvtt1/) formats for ingesting Subtitles and Closed Captions.

            '
        type:
          type: string
          enum:
          - text
          - audio
        text_type:
          type: string
          enum:
          - subtitles
        language_code:
          type: string
          description: The language code of this track. The value must be a valid BCP 47 specification compliant value. For example, en for English or en-US for the US version of English.
        name:
          type: string
          description: The name of the track containing a human-readable description. This value must be unique within each group of `text` or `audio` track types. The HLS manifest will associate the `text` or `audio` track with this value. For example, set the value to "English" for subtitles text track with `language_code` as en-US. If this parameter is not included, Mux will auto-populate a value based on the `language_code` value.
        closed_captions:
          type: boolean
          description: Indicates the track provides Subtitles for the Deaf or Hard-of-hearing (SDH).
        passthrough:
          type: string
          description: Arbitrary user-supplied metadata set for the track either when creating the asset or track.
    GetAssetPlaybackIDResponse:
      type: object
      required:
      - data
      properties:
        data:
          $ref: '#/components/schemas/PlaybackID'
    Asset:
      type: object
      required:
      - id
      - created_at
      - status
      - max_resolution_tier
      - encoding_tier
      - master_access
      - progress
      properties:
        id:
          type: string
          description: Unique identifier for the Asset. Max 255 characters.
        created_at:
          type: string
          format: int64
          description: Time the Asset was created, defined as a Unix timestamp (seconds since epoch).
        status:
          type: string
          enum:
          - preparing
          - ready
          - errored
          description: The status of the asset.
        duration:
          type: number
          format: double
          description: The duration of the asset in seconds (max duration for a single asset is 12 hours).
        max_stored_resolution:
          type: string
          enum:
          - Audio only
          - SD
          - HD
          - FHD
          - UHD
          description: This field is deprecated. Please use `resolution_tier` instead. The maximum resolution that has been stored for the asset. The asset may be delivered at lower resolutions depending on the device and bandwidth, however it cannot be delivered at a higher value than is stored.
          deprecated: true
        resolution_tier:
          type: string
          enum:
          - audio-only
          - 720p
          - 1080p
          - 1440p
          - 2160p
          description: The resolution tier that the asset was ingested at, affecting billing for ingest & storage. This field also represents the highest resolution tier that the content can be delivered at, however the actual resolution may be lower depending on the device, bandwidth, and exact resolution of the uploaded asset.
        max_resolution_tier:
          type: string
          enum:
          - 1080p
          - 1440p
          - 2160p
          description: Max resolution tier can be used to control the maximum `resolution_tier` your asset is encoded, stored, and streamed at. If not set, this defaults to `1080p`.
        encoding_tier:
          type: string
          deprecated: true
          enum:
          - smart
          - baseline
          - premium
          description: This field is deprecated. Please use `video_quality` instead. The encoding tier informs the cost, quality, and available platform features for the asset. The default encoding tier for an account can be set in the Mux Dashboard. [See the video quality guide for more details.](https://docs.mux.com/guides/use-video-quality-levels)
        video_quality:
          type: string
          enum:
          - basic
          - plus
          - premium
          description: The video quality controls the cost, quality, and available platform features for the asset. The default video quality for an account can be set in the Mux Dashboard. This field replaces the deprecated `encoding_tier` value. [See the video quality guide for more details.](https://docs.mux.com/guides/use-video-quality-levels)
        max_stored_frame_rate:
          type: number
          format: double
          description: The maximum frame rate that has been stored for the asset. The asset may be delivered at lower frame rates depending on the device and bandwidth, however it cannot be de

# --- truncated at 32 KB (78 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mux-com/refs/heads/main/openapi/mux-com-assets-api-openapi.yml