Skip to content

Commit 8d1a20b

Browse files
jsanford8jsanford8
authored
4.0.0 (#88)
 - add support for `static-renditions` APIs - add `passthrough` to each `static_rendition` object - add support for additional standard dimensions in Mux Data - allow updating `video_quality` on live streams - [breaking] It is very unlikely that you were using the `AssetStaticRenditionsFiles` 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` APIs - [breaking] Deprecate `mp4_support` and associated APIs. [Utilize the new Static Rendition APIs instead.](https://www.mux.com/docs/changelog/static-renditions-api-for-creating-mp4-and-m4a-renditions-now-available) - [breaking] Remove Spaces APIs and routes
1 parent a1c7026 commit 8d1a20b

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

47 files changed

+2574
-931
lines changed

‎.openapi-generator/FILES

+8-32
Original file line numberDiff line numberDiff line change
@@ -10,22 +10,16 @@ docs/AssetNonStandardInputReasons.md
1010
docs/AssetRecordingTimes.md
1111
docs/AssetResponse.md
1212
docs/AssetStaticRenditions.md
13-
docs/AssetStaticRenditionsFiles.md
1413
docs/AssetsApi.md
1514
docs/BreakdownValue.md
16-
docs/Broadcast.md
17-
docs/BroadcastLayout.md
18-
docs/BroadcastResolution.md
19-
docs/BroadcastResponse.md
20-
docs/BroadcastStatus.md
2115
docs/CreateAssetRequest.md
22-
docs/CreateBroadcastRequest.md
2316
docs/CreateLiveStreamRequest.md
2417
docs/CreatePlaybackIDRequest.md
2518
docs/CreatePlaybackIDResponse.md
2619
docs/CreatePlaybackRestrictionRequest.md
2720
docs/CreateSimulcastTargetRequest.md
28-
docs/CreateSpaceRequest.md
21+
docs/CreateStaticRenditionRequest.md
22+
docs/CreateStaticRenditionResponse.md
2923
docs/CreateTrackRequest.md
3024
docs/CreateTrackResponse.md
3125
docs/CreateTranscriptionVocabularyRequest.md
@@ -105,7 +99,6 @@ docs/ListRealTimeDimensionsResponse.md
10599
docs/ListRealTimeMetricsResponse.md
106100
docs/ListRelatedIncidentsResponse.md
107101
docs/ListSigningKeysResponse.md
108-
docs/ListSpacesResponse.md
109102
docs/ListTranscriptionVocabulariesResponse.md
110103
docs/ListUploadsResponse.md
111104
docs/ListVideoViewExportsResponse.md
@@ -151,13 +144,7 @@ docs/SigningKeyResponse.md
151144
docs/SigningKeysApi.md
152145
docs/SimulcastTarget.md
153146
docs/SimulcastTargetResponse.md
154-
docs/Space.md
155-
docs/SpaceResponse.md
156-
docs/SpaceStatus.md
157-
docs/SpaceType.md
158-
docs/SpacesApi.md
159-
docs/StartSpaceBroadcastResponse.md
160-
docs/StopSpaceBroadcastResponse.md
147+
docs/StaticRendition.md
161148
docs/Track.md
162149
docs/TranscriptionVocabulariesApi.md
163150
docs/TranscriptionVocabulary.md
@@ -169,6 +156,7 @@ docs/UpdateAssetRequest.md
169156
docs/UpdateLiveStreamEmbeddedSubtitlesRequest.md
170157
docs/UpdateLiveStreamGeneratedSubtitlesRequest.md
171158
docs/UpdateLiveStreamNewAssetSettings.md
159+
docs/UpdateLiveStreamNewAssetSettingsStaticRenditionsRequest.md
172160
docs/UpdateLiveStreamRequest.md
173161
docs/UpdateReferrerDomainRestrictionRequest.md
174162
docs/UpdateTranscriptionVocabularyRequest.md
@@ -204,7 +192,6 @@ mux_python/api/playback_id_api.py
204192
mux_python/api/playback_restrictions_api.py
205193
mux_python/api/real_time_api.py
206194
mux_python/api/signing_keys_api.py
207-
mux_python/api/spaces_api.py
208195
mux_python/api/transcription_vocabularies_api.py
209196
mux_python/api/url_signing_keys_api.py
210197
mux_python/api/video_views_api.py
@@ -222,21 +209,15 @@ mux_python/models/asset_non_standard_input_reasons.py
222209
mux_python/models/asset_recording_times.py
223210
mux_python/models/asset_response.py
224211
mux_python/models/asset_static_renditions.py
225-
mux_python/models/asset_static_renditions_files.py
226212
mux_python/models/breakdown_value.py
227-
mux_python/models/broadcast.py
228-
mux_python/models/broadcast_layout.py
229-
mux_python/models/broadcast_resolution.py
230-
mux_python/models/broadcast_response.py
231-
mux_python/models/broadcast_status.py
232213
mux_python/models/create_asset_request.py
233-
mux_python/models/create_broadcast_request.py
234214
mux_python/models/create_live_stream_request.py
235215
mux_python/models/create_playback_id_request.py
236216
mux_python/models/create_playback_id_response.py
237217
mux_python/models/create_playback_restriction_request.py
238218
mux_python/models/create_simulcast_target_request.py
239-
mux_python/models/create_space_request.py
219+
mux_python/models/create_static_rendition_request.py
220+
mux_python/models/create_static_rendition_response.py
240221
mux_python/models/create_track_request.py
241222
mux_python/models/create_track_response.py
242223
mux_python/models/create_transcription_vocabulary_request.py
@@ -308,7 +289,6 @@ mux_python/models/list_real_time_dimensions_response.py
308289
mux_python/models/list_real_time_metrics_response.py
309290
mux_python/models/list_related_incidents_response.py
310291
mux_python/models/list_signing_keys_response.py
311-
mux_python/models/list_spaces_response.py
312292
mux_python/models/list_transcription_vocabularies_response.py
313293
mux_python/models/list_uploads_response.py
314294
mux_python/models/list_video_view_exports_response.py
@@ -347,12 +327,7 @@ mux_python/models/signing_key.py
347327
mux_python/models/signing_key_response.py
348328
mux_python/models/simulcast_target.py
349329
mux_python/models/simulcast_target_response.py
350-
mux_python/models/space.py
351-
mux_python/models/space_response.py
352-
mux_python/models/space_status.py
353-
mux_python/models/space_type.py
354-
mux_python/models/start_space_broadcast_response.py
355-
mux_python/models/stop_space_broadcast_response.py
330+
mux_python/models/static_rendition.py
356331
mux_python/models/track.py
357332
mux_python/models/transcription_vocabulary.py
358333
mux_python/models/transcription_vocabulary_response.py
@@ -362,6 +337,7 @@ mux_python/models/update_asset_request.py
362337
mux_python/models/update_live_stream_embedded_subtitles_request.py
363338
mux_python/models/update_live_stream_generated_subtitles_request.py
364339
mux_python/models/update_live_stream_new_asset_settings.py
340+
mux_python/models/update_live_stream_new_asset_settings_static_renditions_request.py
365341
mux_python/models/update_live_stream_request.py
366342
mux_python/models/update_referrer_domain_restriction_request.py
367343
mux_python/models/update_transcription_vocabulary_request.py

‎docs/AssetStaticRenditions.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ An object containing the current status of any static renditions (mp4s). The obj
44
## Properties
55
Name | Type | Description | Notes
66
------------ | ------------- | ------------- | -------------
7-
**status** | **str** | Indicates the status of downloadable MP4 versions of this asset. | [optional] [default to 'disabled']
8-
**files** | [**list[AssetStaticRenditionsFiles]**](AssetStaticRenditionsFiles.md) | Array of file objects. | [optional]
7+
**status** | **str** | Indicates the status of downloadable MP4 versions of this asset. This field is only valid when `mp4_support` is enabled | [optional] [default to 'disabled']
8+
**files** | [**list[StaticRendition]**](StaticRendition.md) | Array of file objects. | [optional]
99

1010
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
1111

‎docs/AssetStaticRenditionsFiles.md

-15
This file was deleted.

‎docs/AssetsApi.md

+152-1
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,11 @@ Method | HTTP request | Description
66
------------- | ------------- | -------------
77
[**create_asset**](AssetsApi.md#create_asset) | **POST** /video/v1/assets | Create an asset
88
[**create_asset_playback_id**](AssetsApi.md#create_asset_playback_id) | **POST** /video/v1/assets/{ASSET_ID}/playback-ids | Create a playback ID
9+
[**create_asset_static_rendition**](AssetsApi.md#create_asset_static_rendition) | **POST** /video/v1/assets/{ASSET_ID}/static-renditions | Create a static rendition for an asset
910
[**create_asset_track**](AssetsApi.md#create_asset_track) | **POST** /video/v1/assets/{ASSET_ID}/tracks | Create an asset track
1011
[**delete_asset**](AssetsApi.md#delete_asset) | **DELETE** /video/v1/assets/{ASSET_ID} | Delete an asset
1112
[**delete_asset_playback_id**](AssetsApi.md#delete_asset_playback_id) | **DELETE** /video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID} | Delete a playback ID
13+
[**delete_asset_static_rendition**](AssetsApi.md#delete_asset_static_rendition) | **DELETE** /video/v1/assets/{ASSET_ID}/static-renditions/{STATIC_RENDITION_ID} | Delete a single static rendition for an asset
1214
[**delete_asset_track**](AssetsApi.md#delete_asset_track) | **DELETE** /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID} | Delete an asset track
1315
[**generate_asset_track_subtitles**](AssetsApi.md#generate_asset_track_subtitles) | **POST** /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID}/generate-subtitles | Generate track subtitles
1416
[**get_asset**](AssetsApi.md#get_asset) | **GET** /video/v1/assets/{ASSET_ID} | Retrieve an asset
@@ -168,6 +170,81 @@ Name | Type | Description | Notes
168170

169171
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
170172

173+
# **create_asset_static_rendition**
174+
> CreateStaticRenditionResponse create_asset_static_rendition(asset_id, create_static_rendition_request)
175+
176+
Create a static rendition for an asset
177+
178+
Creates a static rendition (i.e. MP4) for an asset
179+
180+
### Example
181+
182+
* Basic Authentication (accessToken):
183+
```python
184+
from __future__ import print_function
185+
import time
186+
import mux_python
187+
from mux_python.rest import ApiException
188+
from pprint import pprint
189+
# Defining the host is optional and defaults to https://api.mux.com
190+
# See configuration.py for a list of all supported configuration parameters.
191+
configuration = mux_python.Configuration(
192+
host = "https://api.mux.com"
193+
)
194+
195+
# The client must configure the authentication and authorization parameters
196+
# in accordance with the API server security policy.
197+
# Examples for each auth method are provided below, use the example that
198+
# satisfies your auth use case.
199+
200+
# Configure HTTP basic authorization: accessToken
201+
configuration = mux_python.Configuration(
202+
username = 'YOUR_USERNAME',
203+
password = 'YOUR_PASSWORD'
204+
)
205+
206+
# Enter a context with an instance of the API client
207+
with mux_python.ApiClient(configuration) as api_client:
208+
# Create an instance of the API class
209+
api_instance = mux_python.AssetsApi(api_client)
210+
asset_id = 'asset_id_example' # str | The asset ID.
211+
create_static_rendition_request = {"resolution":"highest"} # CreateStaticRenditionRequest |
212+
213+
try:
214+
# Create a static rendition for an asset
215+
api_response = api_instance.create_asset_static_rendition(asset_id, create_static_rendition_request)
216+
pprint(api_response)
217+
except ApiException as e:
218+
print("Exception when calling AssetsApi->create_asset_static_rendition: %s\n" % e)
219+
```
220+
221+
### Parameters
222+
223+
Name | Type | Description | Notes
224+
------------- | ------------- | ------------- | -------------
225+
**asset_id** | **str**| The asset ID. |
226+
**create_static_rendition_request** | [**CreateStaticRenditionRequest**](CreateStaticRenditionRequest.md)| |
227+
228+
### Return type
229+
230+
[**CreateStaticRenditionResponse**](CreateStaticRenditionResponse.md)
231+
232+
### Authorization
233+
234+
[accessToken](../README.md#accessToken)
235+
236+
### HTTP request headers
237+
238+
- **Content-Type**: application/json
239+
- **Accept**: application/json
240+
241+
### HTTP response details
242+
| Status code | Description | Response headers |
243+
|-------------|-------------|------------------|
244+
**201** | Created | - |
245+
246+
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
247+
171248
# **create_asset_track**
172249
> CreateTrackResponse create_asset_track(asset_id, create_track_request)
173250
@@ -389,6 +466,80 @@ void (empty response body)
389466

390467
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
391468

469+
# **delete_asset_static_rendition**
470+
> delete_asset_static_rendition(asset_id, static_rendition_id)
471+
472+
Delete a single static rendition for an asset
473+
474+
Deletes a single static rendition for an asset
475+
476+
### Example
477+
478+
* Basic Authentication (accessToken):
479+
```python
480+
from __future__ import print_function
481+
import time
482+
import mux_python
483+
from mux_python.rest import ApiException
484+
from pprint import pprint
485+
# Defining the host is optional and defaults to https://api.mux.com
486+
# See configuration.py for a list of all supported configuration parameters.
487+
configuration = mux_python.Configuration(
488+
host = "https://api.mux.com"
489+
)
490+
491+
# The client must configure the authentication and authorization parameters
492+
# in accordance with the API server security policy.
493+
# Examples for each auth method are provided below, use the example that
494+
# satisfies your auth use case.
495+
496+
# Configure HTTP basic authorization: accessToken
497+
configuration = mux_python.Configuration(
498+
username = 'YOUR_USERNAME',
499+
password = 'YOUR_PASSWORD'
500+
)
501+
502+
# Enter a context with an instance of the API client
503+
with mux_python.ApiClient(configuration) as api_client:
504+
# Create an instance of the API class
505+
api_instance = mux_python.AssetsApi(api_client)
506+
asset_id = 'asset_id_example' # str | The asset ID.
507+
static_rendition_id = 'static_rendition_id_example' # str | The static rendition ID.
508+
509+
try:
510+
# Delete a single static rendition for an asset
511+
api_instance.delete_asset_static_rendition(asset_id, static_rendition_id)
512+
except ApiException as e:
513+
print("Exception when calling AssetsApi->delete_asset_static_rendition: %s\n" % e)
514+
```
515+
516+
### Parameters
517+
518+
Name | Type | Description | Notes
519+
------------- | ------------- | ------------- | -------------
520+
**asset_id** | **str**| The asset ID. |
521+
**static_rendition_id** | **str**| The static rendition ID. |
522+
523+
### Return type
524+
525+
void (empty response body)
526+
527+
### Authorization
528+
529+
[accessToken](../README.md#accessToken)
530+
531+
### HTTP request headers
532+
533+
- **Content-Type**: Not defined
534+
- **Accept**: Not defined
535+
536+
### HTTP response details
537+
| Status code | Description | Response headers |
538+
|-------------|-------------|------------------|
539+
**204** | No Content | - |
540+
541+
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
542+
392543
# **delete_asset_track**
393544
> delete_asset_track(asset_id, track_id)
394545
@@ -995,7 +1146,7 @@ Name | Type | Description | Notes
9951146
9961147
Update MP4 support
9971148

998-
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.
1149+
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.
9991150

10001151
### Example
10011152

‎docs/Broadcast.md

-16
This file was deleted.

‎docs/BroadcastLayout.md

-10
This file was deleted.

‎docs/BroadcastResolution.md

-10
This file was deleted.

0 commit comments

Comments
 (0)