v1.17.0 (#22)

* add support for static-renditions API * v1.17.0 and other minor tweaks
muxinc · Feb 13, 2025 · c872555 · c872555
1 parent 859d706
commit c872555
Show file tree

Hide file tree

Showing 25 changed files with 2,402 additions and 69 deletions.
diff --git a/.openapi-generator/FILES b/.openapi-generator/FILES
@@ -10,7 +10,6 @@ docs/AssetNonStandardInputReasons.md
 docs/AssetRecordingTimes.md
 docs/AssetResponse.md
 docs/AssetStaticRenditions.md
-docs/AssetStaticRenditionsFiles.md
 docs/AssetsApi.md
 docs/BreakdownValue.md
 docs/Broadcast.md
@@ -26,6 +25,8 @@ docs/CreatePlaybackIDResponse.md
 docs/CreatePlaybackRestrictionRequest.md
 docs/CreateSimulcastTargetRequest.md
 docs/CreateSpaceRequest.md
+docs/CreateStaticRenditionRequest.md
+docs/CreateStaticRenditionResponse.md
 docs/CreateTrackRequest.md
 docs/CreateTrackResponse.md
 docs/CreateTranscriptionVocabularyRequest.md
@@ -157,6 +158,7 @@ docs/SpaceStatus.md
 docs/SpaceType.md
 docs/SpacesApi.md
 docs/StartSpaceBroadcastResponse.md
+docs/StaticRendition.md
 docs/StopSpaceBroadcastResponse.md
 docs/Track.md
 docs/TranscriptionVocabulariesApi.md
@@ -168,6 +170,7 @@ docs/UpdateAssetRequest.md
 docs/UpdateLiveStreamEmbeddedSubtitlesRequest.md
 docs/UpdateLiveStreamGeneratedSubtitlesRequest.md
 docs/UpdateLiveStreamNewAssetSettings.md
+docs/UpdateLiveStreamNewAssetSettingsStaticRenditionsRequest.md
 docs/UpdateLiveStreamRequest.md
 docs/UpdateReferrerDomainRestrictionRequest.md
 docs/UpdateTranscriptionVocabularyRequest.md
@@ -239,7 +242,6 @@ src/main/java/com/mux/sdk/models/AssetNonStandardInputReasons.java
 src/main/java/com/mux/sdk/models/AssetRecordingTimes.java
 src/main/java/com/mux/sdk/models/AssetResponse.java
 src/main/java/com/mux/sdk/models/AssetStaticRenditions.java
-src/main/java/com/mux/sdk/models/AssetStaticRenditionsFiles.java
 src/main/java/com/mux/sdk/models/BreakdownValue.java
 src/main/java/com/mux/sdk/models/Broadcast.java
 src/main/java/com/mux/sdk/models/BroadcastLayout.java
@@ -254,6 +256,8 @@ src/main/java/com/mux/sdk/models/CreatePlaybackIDResponse.java
 src/main/java/com/mux/sdk/models/CreatePlaybackRestrictionRequest.java
 src/main/java/com/mux/sdk/models/CreateSimulcastTargetRequest.java
 src/main/java/com/mux/sdk/models/CreateSpaceRequest.java
+src/main/java/com/mux/sdk/models/CreateStaticRenditionRequest.java
+src/main/java/com/mux/sdk/models/CreateStaticRenditionResponse.java
 src/main/java/com/mux/sdk/models/CreateTrackRequest.java
 src/main/java/com/mux/sdk/models/CreateTrackResponse.java
 src/main/java/com/mux/sdk/models/CreateTranscriptionVocabularyRequest.java
@@ -369,6 +373,7 @@ src/main/java/com/mux/sdk/models/SpaceResponse.java
 src/main/java/com/mux/sdk/models/SpaceStatus.java
 src/main/java/com/mux/sdk/models/SpaceType.java
 src/main/java/com/mux/sdk/models/StartSpaceBroadcastResponse.java
+src/main/java/com/mux/sdk/models/StaticRendition.java
 src/main/java/com/mux/sdk/models/StopSpaceBroadcastResponse.java
 src/main/java/com/mux/sdk/models/Track.java
 src/main/java/com/mux/sdk/models/TranscriptionVocabulary.java
@@ -379,6 +384,7 @@ src/main/java/com/mux/sdk/models/UpdateAssetRequest.java
 src/main/java/com/mux/sdk/models/UpdateLiveStreamEmbeddedSubtitlesRequest.java
 src/main/java/com/mux/sdk/models/UpdateLiveStreamGeneratedSubtitlesRequest.java
 src/main/java/com/mux/sdk/models/UpdateLiveStreamNewAssetSettings.java
+src/main/java/com/mux/sdk/models/UpdateLiveStreamNewAssetSettingsStaticRenditionsRequest.java
 src/main/java/com/mux/sdk/models/UpdateLiveStreamRequest.java
 src/main/java/com/mux/sdk/models/UpdateReferrerDomainRestrictionRequest.java
 src/main/java/com/mux/sdk/models/UpdateTranscriptionVocabularyRequest.java

diff --git a/README.md b/README.md
@@ -52,7 +52,7 @@ Add this dependency to your project's POM:
 <dependency>
   <groupId>com.mux</groupId>
   <artifactId>mux-sdk-java</artifactId>
-  <version>0.16.0</version>
+  <version>0.17.0</version>
   <scope>compile</scope>
 </dependency>
 ```
@@ -62,7 +62,7 @@ Add this dependency to your project's POM:
 Add this dependency to your project's build file:
 
 ```groovy
-compile "com.mux:mux-sdk-java:0.16.0"
+compile "com.mux:mux-sdk-java:0.17.0"
 ```
 
 ### Others
@@ -75,7 +75,7 @@ mvn clean package
 
 Then manually install the following JARs:
 
-* `target/mux-sdk-java-0.16.0.jar`
+* `target/mux-sdk-java-0.17.0.jar`
 * `target/lib/*.jar`
 
 ## Getting Started
@@ -128,9 +128,11 @@ Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
 *AssetsApi* | [**createAsset**](docs/AssetsApi.md#createAsset) | **POST** /video/v1/assets | Create an asset
 *AssetsApi* | [**createAssetPlaybackId**](docs/AssetsApi.md#createAssetPlaybackId) | **POST** /video/v1/assets/{ASSET_ID}/playback-ids | Create a playback ID
+*AssetsApi* | [**createAssetStaticRendition**](docs/AssetsApi.md#createAssetStaticRendition) | **POST** /video/v1/assets/{ASSET_ID}/static-renditions | Create a static rendition for an asset
 *AssetsApi* | [**createAssetTrack**](docs/AssetsApi.md#createAssetTrack) | **POST** /video/v1/assets/{ASSET_ID}/tracks | Create an asset track
 *AssetsApi* | [**deleteAsset**](docs/AssetsApi.md#deleteAsset) | **DELETE** /video/v1/assets/{ASSET_ID} | Delete an asset
 *AssetsApi* | [**deleteAssetPlaybackId**](docs/AssetsApi.md#deleteAssetPlaybackId) | **DELETE** /video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID} | Delete a playback ID
+*AssetsApi* | [**deleteAssetStaticRendition**](docs/AssetsApi.md#deleteAssetStaticRendition) | **DELETE** /video/v1/assets/{ASSET_ID}/static-renditions/{STATIC_RENDITION_ID} | Delete a single static rendition for an asset
 *AssetsApi* | [**deleteAssetTrack**](docs/AssetsApi.md#deleteAssetTrack) | **DELETE** /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID} | Delete an asset track
 *AssetsApi* | [**generateAssetTrackSubtitles**](docs/AssetsApi.md#generateAssetTrackSubtitles) | **POST** /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID}/generate-subtitles | Generate track subtitles
 *AssetsApi* | [**getAsset**](docs/AssetsApi.md#getAsset) | **GET** /video/v1/assets/{ASSET_ID} | Retrieve an asset
@@ -163,6 +165,7 @@ Class | Method | HTTP request | Description
 *LiveStreamsApi* | [**deleteLiveStream**](docs/LiveStreamsApi.md#deleteLiveStream) | **DELETE** /video/v1/live-streams/{LIVE_STREAM_ID} | Delete a live stream
 *LiveStreamsApi* | [**deleteLiveStreamPlaybackId**](docs/LiveStreamsApi.md#deleteLiveStreamPlaybackId) | **DELETE** /video/v1/live-streams/{LIVE_STREAM_ID}/playback-ids/{PLAYBACK_ID} | Delete a live stream playback ID
 *LiveStreamsApi* | [**deleteLiveStreamSimulcastTarget**](docs/LiveStreamsApi.md#deleteLiveStreamSimulcastTarget) | **DELETE** /video/v1/live-streams/{LIVE_STREAM_ID}/simulcast-targets/{SIMULCAST_TARGET_ID} | Delete a live stream simulcast target
+*LiveStreamsApi* | [**deleteLiveStreamStaticRenditions**](docs/LiveStreamsApi.md#deleteLiveStreamStaticRenditions) | **DELETE** /video/v1/live-streams/{LIVE_STREAM_ID}/new-asset-settings/static-renditions | Delete a live stream&#39;s static renditions setting for new assets
 *LiveStreamsApi* | [**disableLiveStream**](docs/LiveStreamsApi.md#disableLiveStream) | **PUT** /video/v1/live-streams/{LIVE_STREAM_ID}/disable | Disable a live stream
 *LiveStreamsApi* | [**enableLiveStream**](docs/LiveStreamsApi.md#enableLiveStream) | **PUT** /video/v1/live-streams/{LIVE_STREAM_ID}/enable | Enable a live stream
 *LiveStreamsApi* | [**getLiveStream**](docs/LiveStreamsApi.md#getLiveStream) | **GET** /video/v1/live-streams/{LIVE_STREAM_ID} | Retrieve a live stream
@@ -174,6 +177,7 @@ Class | Method | HTTP request | Description
 *LiveStreamsApi* | [**updateLiveStream**](docs/LiveStreamsApi.md#updateLiveStream) | **PATCH** /video/v1/live-streams/{LIVE_STREAM_ID} | Update a live stream
 *LiveStreamsApi* | [**updateLiveStreamEmbeddedSubtitles**](docs/LiveStreamsApi.md#updateLiveStreamEmbeddedSubtitles) | **PUT** /video/v1/live-streams/{LIVE_STREAM_ID}/embedded-subtitles | Update a live stream&#39;s embedded subtitles
 *LiveStreamsApi* | [**updateLiveStreamGeneratedSubtitles**](docs/LiveStreamsApi.md#updateLiveStreamGeneratedSubtitles) | **PUT** /video/v1/live-streams/{LIVE_STREAM_ID}/generated-subtitles | Update a live stream&#39;s generated subtitles
+*LiveStreamsApi* | [**updateLiveStreamStaticRenditions**](docs/LiveStreamsApi.md#updateLiveStreamStaticRenditions) | **PUT** /video/v1/live-streams/{LIVE_STREAM_ID}/new-asset-settings/static-renditions | Update live stream static renditions for new assets
 *MetricsApi* | [**getMetricTimeseriesData**](docs/MetricsApi.md#getMetricTimeseriesData) | **GET** /data/v1/metrics/{METRIC_ID}/timeseries | Get metric timeseries data
 *MetricsApi* | [**getOverallValues**](docs/MetricsApi.md#getOverallValues) | **GET** /data/v1/metrics/{METRIC_ID}/overall | Get Overall values
 *MetricsApi* | [**listAllMetricValues**](docs/MetricsApi.md#listAllMetricValues) | **GET** /data/v1/metrics/comparison | List all metric values
@@ -242,7 +246,6 @@ Class | Method | HTTP request | Description
  - [AssetRecordingTimes](docs/AssetRecordingTimes.md)
  - [AssetResponse](docs/AssetResponse.md)
  - [AssetStaticRenditions](docs/AssetStaticRenditions.md)
- - [AssetStaticRenditionsFiles](docs/AssetStaticRenditionsFiles.md)
  - [BreakdownValue](docs/BreakdownValue.md)
  - [Broadcast](docs/Broadcast.md)
  - [BroadcastLayout](docs/BroadcastLayout.md)
@@ -257,6 +260,8 @@ Class | Method | HTTP request | Description
  - [CreatePlaybackRestrictionRequest](docs/CreatePlaybackRestrictionRequest.md)
  - [CreateSimulcastTargetRequest](docs/CreateSimulcastTargetRequest.md)
  - [CreateSpaceRequest](docs/CreateSpaceRequest.md)
+ - [CreateStaticRenditionRequest](docs/CreateStaticRenditionRequest.md)
+ - [CreateStaticRenditionResponse](docs/CreateStaticRenditionResponse.md)
  - [CreateTrackRequest](docs/CreateTrackRequest.md)
  - [CreateTrackResponse](docs/CreateTrackResponse.md)
  - [CreateTranscriptionVocabularyRequest](docs/CreateTranscriptionVocabularyRequest.md)
@@ -372,6 +377,7 @@ Class | Method | HTTP request | Description
  - [SpaceStatus](docs/SpaceStatus.md)
  - [SpaceType](docs/SpaceType.md)
  - [StartSpaceBroadcastResponse](docs/StartSpaceBroadcastResponse.md)
+ - [StaticRendition](docs/StaticRendition.md)
  - [StopSpaceBroadcastResponse](docs/StopSpaceBroadcastResponse.md)
  - [Track](docs/Track.md)
  - [TranscriptionVocabulary](docs/TranscriptionVocabulary.md)
@@ -382,6 +388,7 @@ Class | Method | HTTP request | Description
  - [UpdateLiveStreamEmbeddedSubtitlesRequest](docs/UpdateLiveStreamEmbeddedSubtitlesRequest.md)
  - [UpdateLiveStreamGeneratedSubtitlesRequest](docs/UpdateLiveStreamGeneratedSubtitlesRequest.md)
  - [UpdateLiveStreamNewAssetSettings](docs/UpdateLiveStreamNewAssetSettings.md)
+ - [UpdateLiveStreamNewAssetSettingsStaticRenditionsRequest](docs/UpdateLiveStreamNewAssetSettingsStaticRenditionsRequest.md)
  - [UpdateLiveStreamRequest](docs/UpdateLiveStreamRequest.md)
  - [UpdateReferrerDomainRestrictionRequest](docs/UpdateReferrerDomainRestrictionRequest.md)
  - [UpdateTranscriptionVocabularyRequest](docs/UpdateTranscriptionVocabularyRequest.md)

diff --git a/build.gradle b/build.gradle
@@ -16,7 +16,7 @@ plugins {
 }
 
 group = 'com.mux'
-version = '0.16.0'
+version = '0.17.0'
 
 repositories {
     mavenCentral()

diff --git a/docs/AssetStaticRenditions.md b/docs/AssetStaticRenditions.md
@@ -7,8 +7,8 @@ An object containing the current status of any static renditions (mp4s). The obj
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**status** | [**StatusEnum**](#StatusEnum) | Indicates the status of downloadable MP4 versions of this asset. |  [optional]
-**files** | [**java.util.List&lt;AssetStaticRenditionsFiles&gt;**](AssetStaticRenditionsFiles.md) | Array of file objects. |  [optional]
+**status** | [**StatusEnum**](#StatusEnum) | Indicates the status of downloadable MP4 versions of this asset. This field is only valid when &#x60;mp4_support&#x60; is enabled |  [optional]
+**files** | [**java.util.List&lt;StaticRendition&gt;**](StaticRendition.md) | Array of file objects. |  [optional]
 
 
 

diff --git a/docs/AssetStaticRenditionsFiles.md b/docs/AssetStaticRenditionsFiles.md
diff --git a/docs/AssetsApi.md b/docs/AssetsApi.md
@@ -6,9 +6,11 @@ Method | HTTP request | Description
 ------------- | ------------- | -------------
 [**createAsset**](AssetsApi.md#createAsset) | **POST** /video/v1/assets | Create an asset
 [**createAssetPlaybackId**](AssetsApi.md#createAssetPlaybackId) | **POST** /video/v1/assets/{ASSET_ID}/playback-ids | Create a playback ID
+[**createAssetStaticRendition**](AssetsApi.md#createAssetStaticRendition) | **POST** /video/v1/assets/{ASSET_ID}/static-renditions | Create a static rendition for an asset
 [**createAssetTrack**](AssetsApi.md#createAssetTrack) | **POST** /video/v1/assets/{ASSET_ID}/tracks | Create an asset track
 [**deleteAsset**](AssetsApi.md#deleteAsset) | **DELETE** /video/v1/assets/{ASSET_ID} | Delete an asset
 [**deleteAssetPlaybackId**](AssetsApi.md#deleteAssetPlaybackId) | **DELETE** /video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID} | Delete a playback ID
+[**deleteAssetStaticRendition**](AssetsApi.md#deleteAssetStaticRendition) | **DELETE** /video/v1/assets/{ASSET_ID}/static-renditions/{STATIC_RENDITION_ID} | Delete a single static rendition for an asset
 [**deleteAssetTrack**](AssetsApi.md#deleteAssetTrack) | **DELETE** /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID} | Delete an asset track
 [**generateAssetTrackSubtitles**](AssetsApi.md#generateAssetTrackSubtitles) | **POST** /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID}/generate-subtitles | Generate track subtitles
 [**getAsset**](AssetsApi.md#getAsset) | **GET** /video/v1/assets/{ASSET_ID} | Retrieve an asset
@@ -160,6 +162,77 @@ Name | Type | Description  | Notes
 |-------------|-------------|------------------|
 **201** | Created |  -  |
 
+<a name="createAssetStaticRendition"></a>
+# **createAssetStaticRendition**
+> CreateStaticRenditionResponse createAssetStaticRendition(ASSET_ID, createStaticRenditionRequest).execute();
+
+Create a static rendition for an asset
+
+Creates a static rendition (i.e. MP4) for an asset
+
+### Example
+```java
+// Import classes:
+import com.mux.ApiClient;
+import com.mux.ApiException;
+import com.mux.Configuration;
+import com.mux.auth.*;
+import com.mux.models.*;
+import com.mux.sdk.AssetsApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("https://api.mux.com");
+
+    // Configure HTTP basic authorization: accessToken
+    HttpBasicAuth accessToken = (HttpBasicAuth) defaultClient.getAuthentication("accessToken");
+    accessToken.setUsername("YOUR USERNAME");
+    accessToken.setPassword("YOUR PASSWORD");
+
+    AssetsApi apiInstance = new AssetsApi(defaultClient);
+    String ASSET_ID = "ASSET_ID_example"; // String | The asset ID.
+    CreateStaticRenditionRequest createStaticRenditionRequest = {"resolution":"highest"}; // CreateStaticRenditionRequest | 
+    try {
+      CreateStaticRenditionResponse result = apiInstance.createAssetStaticRendition(ASSET_ID, createStaticRenditionRequest)
+            .execute();
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling AssetsApi#createAssetStaticRendition");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **ASSET_ID** | **String**| The asset ID. |
+ **createStaticRenditionRequest** | [**CreateStaticRenditionRequest**](CreateStaticRenditionRequest.md)|  |
+
+### Return type
+
+[**CreateStaticRenditionResponse**](CreateStaticRenditionResponse.md)
+
+### Authorization
+
+[accessToken](../README.md#accessToken)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**201** | Created |  -  |
+
 <a name="createAssetTrack"></a>
 # **createAssetTrack**
 > CreateTrackResponse createAssetTrack(ASSET_ID, createTrackRequest).execute();
@@ -369,6 +442,76 @@ null (empty response body)
 |-------------|-------------|------------------|
 **204** | No Content |  -  |
 
+<a name="deleteAssetStaticRendition"></a>
+# **deleteAssetStaticRendition**
+> deleteAssetStaticRendition(ASSET_ID, STATIC_RENDITION_ID).execute();
+
+Delete a single static rendition for an asset
+
+Deletes a single static rendition for an asset
+
+### Example
+```java
+// Import classes:
+import com.mux.ApiClient;
+import com.mux.ApiException;
+import com.mux.Configuration;
+import com.mux.auth.*;
+import com.mux.models.*;
+import com.mux.sdk.AssetsApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("https://api.mux.com");
+
+    // Configure HTTP basic authorization: accessToken
+    HttpBasicAuth accessToken = (HttpBasicAuth) defaultClient.getAuthentication("accessToken");
+    accessToken.setUsername("YOUR USERNAME");
+    accessToken.setPassword("YOUR PASSWORD");
+
+    AssetsApi apiInstance = new AssetsApi(defaultClient);
+    String ASSET_ID = "ASSET_ID_example"; // String | The asset ID.
+    String STATIC_RENDITION_ID = "STATIC_RENDITION_ID_example"; // String | The static rendition ID.
+    try {
+      apiInstance.deleteAssetStaticRendition(ASSET_ID, STATIC_RENDITION_ID)
+            .execute();
+    } catch (ApiException e) {
+      System.err.println("Exception when calling AssetsApi#deleteAssetStaticRendition");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **ASSET_ID** | **String**| The asset ID. |
+ **STATIC_RENDITION_ID** | **String**| The static rendition ID. |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+[accessToken](../README.md#accessToken)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**204** | No Content |  -  |
+
 <a name="deleteAssetTrack"></a>
 # **deleteAssetTrack**
 > deleteAssetTrack(ASSET_ID, TRACK_ID).execute();