Update Summary endpoints

.openapi-generator/oas_apivideo.yaml-defaut-cli.sha256

@@ -1 +1 @@
-589578120105165c9f58683fbe2fb917dabfaf9392187865f30956f8e4964d5a
+f2258a85e4233a4243aa1514697cbb72ab9568d8bc147a0ba046e979c1e7bcf9

CHANGELOG.md

@@ -1,6 +1,9 @@
 # Changelog
 All changes to this project will be documented in this file.
 
+## [1.6.7] - 2024-11-06
+- AI summary updates
+
 ## [1.6.6] - 2024-11-04
 - Analytics updates (ccv, views, ...)
 

docs/SummariesApi.md

@@ -17,7 +17,7 @@ Method | HTTP request | Description
 
 Generate video summary
 
-Generate a title, abstract, and key takeaways for a video.
+Generate an abstract and key takeaways for a video.
 
 ### Example
 ```csharp
@@ -84,7 +84,7 @@ Name | Type | Description  | Notes
 
 Update summary details
 
-Update details for a summary. Note that this operation is only allowed for summary objects where `sourceStatus` is `missing`.
+Update details for a summary.
 
 ### Example
 ```csharp

docs/SummaryCreationPayload.md

@@ -6,6 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **VideoId** | **string** | Create a summary of a video using the video ID. | 
 **Origin** | **string** | Use this parameter to define how the API generates the summary. The only allowed value is `auto`, which means that the API generates a summary automatically.  If you do not set this parameter, **the API will not generate a summary automatically**.  In this case, `sourceStatus` will return `missing`, and you have to manually add a summary using the `PATCH /summaries/{summaryId}/source` endpoint operation. | [optional] 
+**Attributes** | **List<string>** | Use this parameter to define the elements of a summary that you want to generate. If you do not define this parameter, the API generates a full summary with all attributes. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/SummarySource.md

@@ -4,7 +4,6 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**Title** | **string** | A video title, based on the contents of the video. | [optional] 
 **Abstract** | **string** | A short outline of the contents of the video. The length of an `abstract` depends on the amount of content in a video that can be transcribed. The API condenses the contents into minimum 20, maximum 300 words. | [optional] 
 **Takeaways** | **List<string>** | A list of 3 key points from the video, in chronological order. | [optional] 
 

docs/SummaryUpdatePayload.md

@@ -4,7 +4,6 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**Title** | **string** | A video title, based on the contents of the video. | [optional] 
 **Abstract** | **string** | A short outline of the contents of the video. | [optional] 
 **Takeaways** | **List<string>** | A list of 3 key points from the video, in chronological order. | [optional] 
 

docs/VideoCreationPayload.md

@@ -18,6 +18,7 @@ Name | Type | Description | Notes
 **Language** | **string** | Use this parameter to set the language of the video. When this parameter is set, the API creates a transcript of the video using the language you specify. You must use the [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.  `language` is a permanent attribute of the video. You can update it to another language using the [`PATCH /videos/{videoId}`](https://docs.api.video/reference/api/Videos#update-a-video-object) operation. This triggers the API to generate a new transcript using a different language. | [optional] 
 **Transcript** | **bool** | Use this parameter to enable transcription.   - When `true`, the API generates a transcript for the video. - The default value is `false`. - If you define a video language using the `language` parameter, the API uses that language to transcribe the video. If you do not define a language, the API detects it based on the video.  - When the API generates a transcript, it will be available as a caption for the video. | [optional] 
 **TranscriptSummary** | **bool** | Use this parameter to enable summarization. We recommend using this parameter together with `transcript: true`.  - When `true`, the API generates a summary for the video, based on the transcription. - The default value is `false`. - If you define a video language using the `language` parameter, the API uses that language to summarize the video. If you do not define a language, the API detects it based on the video. | [optional] 
+**TranscriptSummaryAttributes** | **List<string>** | Use this parameter to define the elements of a summary that you want to generate. If you do not define this parameter, the API generates a full summary with all attributes. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/VideoUpdatePayload.md

@@ -15,6 +15,7 @@ Name | Type | Description | Notes
 **Language** | **string** | Use this parameter to set the language of the video. When this parameter is set, the API creates a transcript of the video using the language you specify. You must use the [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.  `language` is a permanent attribute of the video. You can update it to another language using the [`PATCH /videos/{videoId}`](https://docs.api.video/reference/api/Videos#update-a-video-object) operation. This triggers the API to generate a new transcript using a different language. | [optional] 
 **Transcript** | **bool** | Use this parameter to enable transcription.   - When `true`, the API generates a transcript for the video. - The default value is `false`. - If you define a video language using the `language` parameter, the API uses that language to transcribe the video. If you do not define a language, the API detects it based on the video.  - When the API generates a transcript, it will be available as a caption for the video. | [optional] 
 **TranscriptSummary** | **bool** | Use this parameter to enable summarization.   - When `true`, the API generates a summary for the video, based on the transcription. - The default value is `false`. - If you define a video language using the `language` parameter, the API uses that language to summarize the video. If you do not define a language, the API detects it based on the video. | [optional] 
+**TranscriptSummaryAttributes** | **List<string>** | Use this parameter to define the elements of a summary that you want to generate. If you do not define this parameter, the API generates a full summary with all attributes. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

src/Api/SummariesApi.cs

@@ -41,7 +41,7 @@ public SummariesApi(ApiClient apiClient)
         }
 
         /// <summary>
-        /// Generate video summary Generate a title, abstract, and key takeaways for a video.
+        /// Generate video summary Generate an abstract and key takeaways for a video.
         /// </summary>
         /// <exception cref="ApiVideo.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation. (optional)</param>
@@ -56,7 +56,7 @@ public Task<Summary> createAsync(SummaryCreationPayload summaryCreationPayload,
         }
 
         /// <summary>
-        /// Generate video summary Generate a title, abstract, and key takeaways for a video.
+        /// Generate video summary Generate an abstract and key takeaways for a video.
         /// </summary>
         /// <exception cref="ApiVideo.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="summaryCreationPayload"></param>
@@ -70,7 +70,7 @@ public Summary create(SummaryCreationPayload summaryCreationPayload)
 
 
         /// <summary>
-        /// Generate video summary Generate a title, abstract, and key takeaways for a video.
+        /// Generate video summary Generate an abstract and key takeaways for a video.
         /// </summary>
         /// <exception cref="ApiVideo.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation. (optional)</param>
@@ -85,7 +85,7 @@ public Task<ApiResponse<Summary>> createWithHttpInfoAsync(SummaryCreationPayload
             if (summaryCreationPayload != null && summaryCreationPayload.videoid == null) {
                 throw new ApiException(400,"Missing required parameter 'summaryCreationPayload.VideoId' when calling SummariesApi->create");
             }
-
+                                    
             // verify the required parameter 'summaryCreationPayload' is set
             if (summaryCreationPayload == null)
                 throw new ApiException(400, "Missing required parameter 'summaryCreationPayload' when calling SummariesApi->create");
@@ -143,7 +143,7 @@ public Task<ApiResponse<Summary>> createWithHttpInfoAsync(SummaryCreationPayload
 
 
         /// <summary>
-        /// Generate video summary Generate a title, abstract, and key takeaways for a video.
+        /// Generate video summary Generate an abstract and key takeaways for a video.
         /// </summary>
         /// <exception cref="ApiVideo.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="summaryCreationPayload"></param>
@@ -157,7 +157,7 @@ public ApiResponse<Summary> createWithHttpInfo(SummaryCreationPayload summaryCre
             if (summaryCreationPayload != null && summaryCreationPayload.videoid == null) {
                 throw new ApiException(400,"Missing required parameter 'summaryCreationPayload.VideoId' when calling SummariesApi->create");
             }
-
+                                    
             // verify the required parameter 'summaryCreationPayload' is set
             if (summaryCreationPayload == null)
                 throw new ApiException(400, "Missing required parameter 'summaryCreationPayload' when calling SummariesApi->create");
@@ -211,7 +211,7 @@ public ApiResponse<Summary> createWithHttpInfo(SummaryCreationPayload summaryCre
 
 
         /// <summary>
-        /// Update summary details Update details for a summary. Note that this operation is only allowed for summary objects where &#x60;sourceStatus&#x60; is &#x60;missing&#x60;.
+        /// Update summary details Update details for a summary.
         /// </summary>
         /// <exception cref="ApiVideo.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation. (optional)</param>
@@ -227,7 +227,7 @@ public Task<SummarySource> updateAsync(string summaryId, SummaryUpdatePayload su
         }
 
         /// <summary>
-        /// Update summary details Update details for a summary. Note that this operation is only allowed for summary objects where &#x60;sourceStatus&#x60; is &#x60;missing&#x60;.
+        /// Update summary details Update details for a summary.
         /// </summary>
         /// <exception cref="ApiVideo.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="summaryId">The unique identifier of the summary source you want to update.</param>
@@ -242,7 +242,7 @@ public SummarySource update(string summaryId, SummaryUpdatePayload summaryUpdate
 
 
         /// <summary>
-        /// Update summary details Update details for a summary. Note that this operation is only allowed for summary objects where &#x60;sourceStatus&#x60; is &#x60;missing&#x60;.
+        /// Update summary details Update details for a summary.
         /// </summary>
         /// <exception cref="ApiVideo.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation. (optional)</param>
@@ -255,11 +255,11 @@ public Task<ApiResponse<SummarySource>> updateWithHttpInfoAsync(string summaryId
             if (summaryUpdatePayload == null) 
                 throw new ApiException(400,"Missing required parameter 'summaryUpdatePayload' when calling SummariesApi->update");
 
-                                    
+
             if (summaryUpdatePayload == null) 
                 throw new ApiException(400,"Missing required parameter 'summaryUpdatePayload' when calling SummariesApi->update");
 
-                                    
+
             // verify the required parameter 'summaryId' is set
             if (summaryId == null)
                 throw new ApiException(400, "Missing required parameter 'summaryId' when calling SummariesApi->update");
@@ -321,7 +321,7 @@ public Task<ApiResponse<SummarySource>> updateWithHttpInfoAsync(string summaryId
 
 
         /// <summary>
-        /// Update summary details Update details for a summary. Note that this operation is only allowed for summary objects where &#x60;sourceStatus&#x60; is &#x60;missing&#x60;.
+        /// Update summary details Update details for a summary.
         /// </summary>
         /// <exception cref="ApiVideo.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="summaryId">The unique identifier of the summary source you want to update.</param>
@@ -333,11 +333,11 @@ public ApiResponse<SummarySource> updateWithHttpInfo(string summaryId, SummaryUp
             if (summaryUpdatePayload == null) 
                 throw new ApiException(400,"Missing required parameter 'summaryUpdatePayload' when calling SummariesApi->update");
 
-                                    
+
             if (summaryUpdatePayload == null) 
                 throw new ApiException(400,"Missing required parameter 'summaryUpdatePayload' when calling SummariesApi->update");
 
-                                    
+
             // verify the required parameter 'summaryId' is set
             if (summaryId == null)
                 throw new ApiException(400, "Missing required parameter 'summaryId' when calling SummariesApi->update");

src/Api/VideosApi.cs

@@ -85,7 +85,7 @@
             if (videoCreationPayload != null && videoCreationPayload.title == null) {
                 throw new ApiException(400,"Missing required parameter 'videoCreationPayload.Title' when calling VideosApi->create");
             }
-
+                                                                                                                                                                                    
             // verify the required parameter 'videoCreationPayload' is set
             if (videoCreationPayload == null)
                 throw new ApiException(400, "Missing required parameter 'videoCreationPayload' when calling VideosApi->create");
@@ -157,7 +157,7 @@
             if (videoCreationPayload != null && videoCreationPayload.title == null) {
                 throw new ApiException(400,"Missing required parameter 'videoCreationPayload.Title' when calling VideosApi->create");
             }
-
+                                                                                                                                                                                    
             // verify the required parameter 'videoCreationPayload' is set
             if (videoCreationPayload == null)
                 throw new ApiException(400, "Missing required parameter 'videoCreationPayload' when calling VideosApi->create");
@@ -559,7 +559,7 @@
             }
         }
 
          public ApiResponse<Video> uploadPartWithHttpInfo(string videoId, System.IO.Stream file, int part, bool isLast) {
 
 
             // verify the required parameter 'videoId' is set
@@ -624,27 +624,27 @@
         }
 
 
         public class UploadProgressiveSession {
             private int partNum = 1;
 
 
             private string videoId;
             private VideosApi videosApi;
 
             public UploadProgressiveSession(VideosApi videosApi, string videoId) {
                 this.videoId = videoId;
                 this.videosApi = videosApi;
             }
 
             public Video uploadPart(System.IO.Stream part) {
                 return uploadPart(part, false);
             }
 
             public Video uploadLastPart(System.IO.Stream part) {
                 return uploadPart(part, true);
             }
 
             public Video uploadPart(System.IO.Stream part, bool isLastPart) {
                 int lastPartNum = partNum;
                 partNum++;
                 ApiResponse<Video> localVarResp = this.videosApi.uploadPartWithHttpInfo(this.videoId, part, lastPartNum, isLastPart);
@@ -1242,11 +1242,11 @@
             if (videoUpdatePayload == null) 
                 throw new ApiException(400,"Missing required parameter 'videoUpdatePayload' when calling VideosApi->update");
 
-
+                                                                                                                                                
             if (videoUpdatePayload == null) 
                 throw new ApiException(400,"Missing required parameter 'videoUpdatePayload' when calling VideosApi->update");
 
-
+                                                                                                                                                
             // verify the required parameter 'videoId' is set
             if (videoId == null)
                 throw new ApiException(400, "Missing required parameter 'videoId' when calling VideosApi->update");
@@ -1326,11 +1326,11 @@
             if (videoUpdatePayload == null) 
                 throw new ApiException(400,"Missing required parameter 'videoUpdatePayload' when calling VideosApi->update");
 
-
+                                                                                                                                                
             if (videoUpdatePayload == null) 
                 throw new ApiException(400,"Missing required parameter 'videoUpdatePayload' when calling VideosApi->update");
 
-
+                                                                                                                                                
             // verify the required parameter 'videoId' is set
             if (videoId == null)
                 throw new ApiException(400, "Missing required parameter 'videoId' when calling VideosApi->update");

src/ApiVideo.csproj

@@ -13,7 +13,7 @@ The version of the OpenAPI document: 1
     <OutputType>Library</OutputType>
     <PackOnBuild>true</PackOnBuild>
     <PackageId>ApiVideo</PackageId>
-    <PackageVersion>1.6.6</PackageVersion>
+    <PackageVersion>1.6.7</PackageVersion>
     <Authors>api.video</Authors>
     <Description>api.video csharp API client</Description>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>

src/Client/ApiClient.cs

@@ -95,7 +95,7 @@
         private void Initialize(IRestClient client)
         {
             this.RestClient = client;
-            setName("AV-Origin-Client", "csharp", "1.6.6");
+            setName("AV-Origin-Client", "csharp", "1.6.7");
         }
 
         /// <summary>
@@ -298,10 +298,10 @@
 
         class ApiExceptionResponse
         {
             public string type;
             public string title;
             public string name;
             public int status;
         }
 
         /// <summary>