---
title: "Create a static rendition for an asset"
method: POST
path: "/video/v1/assets/{ASSET_ID}/static-renditions"
tags: ["Assets"]
---

# Create a static rendition for an asset

`POST /video/v1/assets/{ASSET_ID}/static-renditions`

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/video/v1/assets/{ASSET_ID}/static-renditions`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Creates a static rendition (i.e. MP4) for an asset

## Path parameters

- `ASSET_ID` string, required

## Request body

- CreateStaticRenditionRequest
  - `resolution` 'highest' | 'audio-only' | '2160p' | '1440p' | '1080p' | '720p' | '540p' | '480p' | '360p' | '270p', required
  - `passthrough` string: Arbitrary user-supplied metadata set for the static rendition. Max 255 characters.

## Response `201`

Created

- CreateStaticRenditionResponse
  - `data` StaticRendition, required
    - `name` 'low.mp4' | 'medium.mp4' | 'high.mp4' | 'highest.mp4' | 'audio.m4a' | 'capped-1080p.mp4' | '2160p.mp4' | '1440p.mp4' | '1080p.mp4' | '720p.mp4' | '540p.mp4' | '480p.mp4' | '360p.mp4' | '270p.mp4': Name of the static rendition file
    - `ext` 'mp4' | 'm4a': Extension of the static rendition file
    - `height` integer: The height of the static rendition's file in pixels
    - `width` integer: The width of the static rendition's file in pixels
    - `bitrate` integer: The bitrate in bits per second
    - `filesize` string, int64: The file size in bytes
    - `type` 'standard' | 'advanced': Indicates the static rendition type of this specific MP4 version of this asset. Only present for static renditions created with the Static Renditions API. Not set for renditions created with the deprecated `mp4_support` option.
    - `status` 'ready' | 'preparing' | 'skipped' | 'errored': Indicates the status of this specific MP4 version of this asset. Only present for static renditions created with the Static Renditions API. Not set for renditions created with the deprecated `mp4_support` option. For `mp4_support` renditions, see the top-level `static_renditions.status` field on the asset instead. * `ready` indicates the MP4 has been generated and is ready for download * `preparing` indicates the asset has not been ingested or the static rendition is still being generated after an asset is ready * `skipped` indicates the static rendition will not be generated because the requested resolution conflicts with the asset attributes after the asset has been ingested * `errored` indicates the static rendition cannot be generated. For example, an asset could not be ingested
    - `resolution_tier` '2160p' | '1440p' | '1080p' | '720p' | 'audio-only': Indicates the resolution tier of this specific MP4 version of this asset. Only present for static renditions created with the Static Renditions API. Not set for renditions created with the deprecated `mp4_support` option.
    - `resolution` 'highest' | 'audio-only' | '2160p' | '1440p' | '1080p' | '720p' | '540p' | '480p' | '360p' | '270p': Indicates the resolution of this specific MP4 version of this asset. Only present for static renditions created with the Static Renditions API. Not set for renditions created with the deprecated `mp4_support` option.
    - `id` string: The ID of this static rendition, used in managing this static rendition. Only present for static renditions created with the Static Renditions API. Not set for renditions created with the deprecated `mp4_support` option.
    - `passthrough` string: Arbitrary user-supplied metadata set for the static rendition. Max 255 characters.

## Changes

- **2025-08-05** `ba7ebfd893a1`: 1 info
  - the endpoint scheme security `authorizationToken` was added to the API
- **2025-07-02** `d4d7fca3b738`: 1 info
  - the endpoint scheme security `accessToken` was added to the API
- **2025-04-15** `7f3ef26966f0`: 1 warning
  - added the new `audio-only` enum value to the `data/resolution_tier` response property for the response status `201`
- **2025-02-25** `2eec862e7514`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/video/v1/assets/:ASSET_ID/static-renditions/post.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) - [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/75b4251a1d96?raw)