NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2950 most downloaded on Packagist
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.
Latest stable
5.1.0
Last release 1 years ago
15 Aug 2025
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 45 of 47 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
48 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
add support for Asset ingest progress
video_cdn_trace and array filtersfix: add audio-only enum option in resolution_tier for Static Rendition responses
audio-only enum option in resolution_tier for Static Rendition responsesYour coding agent can read these notes before it upgrades. Set up the MCP server →
Replaces input on CreateAssetRequest with inputs, which accepts the same type, and added deprecation notices
input on CreateAssetRequest with inputs, which accepts the same type, and added deprecation noticesplayback_policy on CreateAssetRequest with playback_policies, which accepts the same type, and added deprecation noticesnew_asset_settings in to be a CreateAssetRequest, which exposes the correct set of fields to control asset creation[breaking] Deprecate mp4_support and associated APIs. Utilize the new Static Rendition APIs instead.
static-renditions APIspassthrough to each static_rendition objectvideo_quality on live streamsAssetStaticRenditionsFiles type directly, but just in case this has been replaced with StaticRendition for the object, and CreateStaticRenditionRequest for the request with the new static-renditions APIsmp4_support and associated APIs. Utilize the new Static Rendition APIs instead.Remove ad_watch_time and view_content_watch_time, metrics which do not exist.
ad_watch_time and view_content_watch_time, metrics which do not exist.Note: The above change may be considered breaking; if you were accessing either field on a base Video View, that will no longer work. It is highly likely that your code was not using those fields, however. Additionally, those metrics are no longer allowed in the metrics API.
Deprecate encoding_tier and add support for video_quality to replace it
encoding_tier and add support for video_quality to replace itpremium video qualitymaster_access settings on Live Streamsview_dropped and view_dropped_percentagesupport video_quality setting in place of deprecated encoding_tier. Read more
prepare for upcoming feature release
Add support for User Agent restrictions within PlaybackRestriction
PlaybackRestrictionencoding_tier field to DeliveryReportAdds updated MP4 generation options.
Adds APIs for retroactive caption generation
ingest_type field on Assetsactive_ingest_protocol, error_severity,player_error_code, starting_up_viewers, playback_failure_error_type_id, playback_business_exception_error_type_id, video_startup_business_exception_error_type_id, error_severityadd support for metric filters for all Data routes
primary on the Track modelAdditional documentation for optional fields
Adds generated_vod to text_source enum
encoding_tiergenerated_vod to text_source enumDeprecated max_stored_resolution, replaced with resolution_tier
General:
Mux Video:
Mux Data:
This release adds parameters to the response of some of the API calls (to better match our implementation), and improves the unit test for exercising
This release adds parameters to the response of some of the API calls (to better match our implementation), and improves the unit test for exercising the signing key routes. This release also includes a few documentation updates as well.
This release adds support for reporting the delivered seconds by resolution, as well as using the crop layout for Space broadcasts.
This release adds support for reporting the delivered seconds by resolution, as well as using the crop layout for Space broadcasts.
Please note that we've dropped support for PHP 7.4 and 8.0, as they have been declared "end of life" by the PHP project.
This release supports the recently updated changes to the Mux Data Monitoring API.
This release supports the recently updated changes to the Mux Data Monitoring API.
In previous releases, the documentation generated from our OpenAPI specification would imply that the SDK wanted JSON strings for parameters to many o
This release fixes two issues:
Model or an associative array.mixed return types in some methods. This has been fixed in this release, and this release should be compatible with PHP 7.4.x.require Guzzle 7.4.5, due to security vulnerabilities in earlier versions of Guzzle
Reconnect Window with slates is now available in public beta. Check out the blog post for more information.
Changed Operations • adds reconnect_slate_url and use_slates_for_standard_latecy parameters for creating and updating Live Streams • require Guzzle 7.4.5, due to security vulnerabilities in earlier versions of Guzzle
Transcription vocabularies are live! Check out the docs for an in-depth guide.
Transcription vocabularies are live! Check out the docs for an in-depth guide.
Changed Operations
New Operations
Fixed API URLs for Spaces calls. You may now Space at your leisure.
…(bug in our backing specification). This is a breaking change, but we have elected to release it as a patch because it's a breaking change to somethin…
get-realtime-breakdown: fixed timestamp definition to correctly reflect that it's an integral timestamp (bug in our backing specification). This is a breaking change, but we have elected to release it as a patch because it's a breaking change to something that never worked correctly and should have extremely minimal disruption to existing operations.Mux Real-Time Video is live! As discussed at TMI, we're so happy to announce Mux's solution to real-time video. Learn more about Mux Spaces here and c
PlaybackRestrictionResponse and ListPlaybackRestrictionResponse models are now correct.
PlaybackRestrictionResponse and ListPlaybackRestrictionResponse models are now correct.No changed operations.
No new operations.
For more information, consult the API reference at https://docs.mux.com/api-reference/video .
Thanks for using Mux!
added live_stream_status query to list-live-streams
live_stream_status query to list-live-streamsNo new operations.
For more information, consult the API reference at https://docs.mux.com/api-reference/video .
Thanks for using Mux!
added embedded_subtitles to LiveStreamResponse
embedded_subtitles to LiveStreamResponselive_stream_id to list-delivery-usageupdate-live-streamupdate-assetcreate-playback-restrictionlist-playback-restrictionsdelete-playback-restrictionget-playback-restrictionupdate-referrer-domain-restrictionFor more information, consult the API reference at https://docs.mux.com/api-reference/video .
Thanks for using Mux!
Added group_by to get_metric_timeseries_data.
group_by to get_metric_timeseries_data.breaking change: the max_channel_layout field of Track was an enum and is now an open string, as our internal implementation couldn't realistically an…
max_channel_layout field of Track was an enum and is now an open string, as our internal implementation couldn't realistically and exhaustively enumerate all possible options. This should be a very small change that applies only to projects ingesting media with multi-channel, non-stereo audio (5.1, 7.1, etc.).minor doc updates; check the API reference for more
Minor API documentation fixes; consult the API reference for full details.
added operation get-live-stream-playback-id; consult https://docs.mux.com/api-reference for up-to-date details on our API
get-live-stream-playback-id; consult https://docs.mux.com/api-reference for up-to-date details on our APIFixed typo in RealTimeBreakdownValue such that concurrent_viewers is correctly represented. Thanks to @catlina71 for the report.
RealTimeBreakdownValue such that concurrent_viewers is correctly represented. Thanks to @catlina71 for the report.Low latency (public beta) has landed! https://docs.mux.com/guides/video/reduce-live-stream-latency#lower-latency-options
additional endpoint coverage; all docs at https://docs.mux.com/api-reference/
1.0.0-rc.1new SDK generation mechanism! Templates now in the SDK repository for public contribution.
Added support for get-asset-by-playback-id
get-asset-by-playback-iddep to go modDeprecated Filters in lieu of Dimensions
Maxed Stored Resolution into an enumNothing published for this version
Adds support for recording_times on Assets created from Live Streams
recording_times on Assets created from Live Streamsnon_standard_input_reasons on Assetsenable and disable calls for Live StreamsAdd support for Simulcast Targets
Add support for test assets, live streams, and direct uploads
test assets, live streams, and direct uploadsdemo fieldAdds support for master-access.
Adds support for master-access.
Add support for Captions & Subtitles on asset create, as well as later via direct track creation
Support Captions and Subtitles
type on assetsAdds support for Delivery Usage
Minor release.
Features:
Bugfixes:
reduced_latency and/or reconnect_windowmaster_access on Asset creationreconnect_windowSupport reduced latency live streaming: https://mux.com/blog/reduced-latency-for-mux-live-streaming-now-available/
Support reduced latency live streaming: https://mux.com/blog/reduced-latency-for-mux-live-streaming-now-available/
Fixes behaviour for passthrough on live streams.
Fixes behaviour for passthrough on live streams.
Nothing published for this version
One column per quarter.