twelvelabs-js 1.2.2 → 1.2.4

package/api/resources/analyzeAsync/resources/tasks/client/Client.js

@@ -71,7 +71,11 @@ class Tasks {
      *     await client.analyzeAsync.tasks.list({
      *         page: 1,
      *         pageLimit: 10,
-     *         status: "queued"
+     *         status: "queued",
+     *         videoUrl: "https://example.com/video.mp4",
+     *         assetId: "69abc123def456789012abcd",
+     *         videoId: "6298d673f1090f1100476d4c",
+     *         analysisMode: "general"
      *     })
      */
     list(request = {}, requestOptions) {
@@ -80,7 +84,7 @@ class Tasks {
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b;
-            const { page, pageLimit, status } = request;
+            const { page, pageLimit, status, videoUrl, assetId, videoId, analysisMode } = request;
             const _queryParams = {};
             if (page != null) {
                 _queryParams["page"] = page.toString();
@@ -93,14 +97,26 @@ class Tasks {
                     unrecognizedObjectKeys: "strip",
                 });
             }
+            if (videoUrl != null) {
+                _queryParams["video_url"] = videoUrl;
+            }
+            if (assetId != null) {
+                _queryParams["asset_id"] = assetId;
+            }
+            if (videoId != null) {
+                _queryParams["video_id"] = videoId;
+            }
+            if (analysisMode != null) {
+                _queryParams["analysis_mode"] = serializers.analyzeAsync.TasksListRequestAnalysisMode.jsonOrThrow(analysisMode, { unrecognizedObjectKeys: "strip" });
+            }
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, "analyze/tasks"),
                 method: "GET",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.4", "User-Agent": "twelvelabs-js/1.2.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
@@ -145,7 +161,7 @@ class Tasks {
         });
     }
     /**
-     * This method asynchronously analyzes your videos and generates fully customizable text based on your prompts.
+     * This method asynchronously analyzes your videos. It supports two analysis modes: general analysis (prompt-based text generation) and video segmentation with custom segment definitions. Video segmentation requires Pegasus 1.5.
      *
      * <Accordion title="Input requirements">
      * - Minimum duration: 4 seconds
@@ -156,6 +172,8 @@ class Tasks {
      * </Accordion>
      *
      * **When to use this method**:
+     * - Generate custom text from your video using a prompt (general analysis)
+     * - Extract timestamped metadata with custom segment definitions from your video (Pegasus 1.5 only)
      * - Analyze videos longer than 1 hour
      * - Process videos asynchronously without blocking your application
      *
@@ -180,6 +198,7 @@ class Tasks {
      *
      * @example
      *     await client.analyzeAsync.tasks.create({
+     *         customId: "prod-segment-analysis-42",
      *         video: {
      *             type: "url",
      *             url: "https://example.com/video.mp4"
@@ -188,6 +207,93 @@ class Tasks {
      *         temperature: 0.2,
      *         maxTokens: 1000
      *     })
+     *
+     * @example
+     *     await client.analyzeAsync.tasks.create({
+     *         modelName: "pegasus1.5",
+     *         video: {
+     *             type: "url",
+     *             url: "https://example.com/video.mp4"
+     *         },
+     *         analysisMode: "time_based_metadata",
+     *         responseFormat: {
+     *             type: "segment_definitions",
+     *             segmentDefinitions: [{
+     *                     id: "scene",
+     *                     description: "A distinct scene or setting change in the video",
+     *                     fields: [{
+     *                             name: "sentiment",
+     *                             type: "string",
+     *                             description: "The emotional tone of this segment",
+     *                             enum: ["positive", "negative", "neutral"]
+     *                         }, {
+     *                             name: "key_objects",
+     *                             type: "array",
+     *                             description: "Notable objects visible in this segment",
+     *                             items: {
+     *                                 type: "string"
+     *                             }
+     *                         }]
+     *                 }]
+     *         },
+     *         minSegmentDuration: 5,
+     *         maxSegmentDuration: 30
+     *     })
+     *
+     * @example
+     *     await client.analyzeAsync.tasks.create({
+     *         modelName: "pegasus1.5",
+     *         video: {
+     *             type: "url",
+     *             url: "https://example.com/video.mp4"
+     *         },
+     *         prompt: "Summarize the key events in this clip.",
+     *         maxTokens: 4096,
+     *         startTime: 10,
+     *         endTime: 60
+     *     })
+     *
+     * @example
+     *     await client.analyzeAsync.tasks.create({
+     *         modelName: "pegasus1.5",
+     *         video: {
+     *             type: "url",
+     *             url: "https://example.com/video.mp4"
+     *         },
+     *         analysisMode: "time_based_metadata",
+     *         responseFormat: {
+     *             type: "segment_definitions",
+     *             segmentDefinitions: [{
+     *                     id: "scenes",
+     *                     description: "Scene changes.",
+     *                     timeRanges: [{
+     *                             startTime: 0,
+     *                             endTime: 4
+     *                         }, {
+     *                             startTime: 10,
+     *                             endTime: 14
+     *                         }]
+     *                 }]
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.analyzeAsync.tasks.create({
+     *         modelName: "pegasus1.5",
+     *         video: {
+     *             type: "url",
+     *             url: "https://example.com/video.mp4"
+     *         },
+     *         promptV2: {
+     *             inputText: "Is there a <@tiger-1> in the video?",
+     *             mediaSources: [{
+     *                     name: "tiger-1",
+     *                     mediaType: "image",
+     *                     url: "https://example.com/tiger.jpg"
+     *                 }]
+     *         },
+     *         maxTokens: 4096
+     *     })
      */
     create(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
@@ -198,13 +304,13 @@ class Tasks {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, "analyze/tasks"),
                 method: "POST",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.4", "User-Agent": "twelvelabs-js/1.2.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.analyzeAsync.CreateAsyncAnalyzeRequest.jsonOrThrow(request, {
                     unrecognizedObjectKeys: "strip",
                 }),
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
@@ -279,10 +385,10 @@ class Tasks {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `analyze/tasks/${encodeURIComponent(taskId)}`),
                 method: "GET",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.4", "User-Agent": "twelvelabs-js/1.2.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
@@ -347,10 +453,10 @@ class Tasks {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `analyze/tasks/${encodeURIComponent(taskId)}`),
                 method: "DELETE",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.4", "User-Agent": "twelvelabs-js/1.2.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
@@ -362,12 +468,7 @@ class Tasks {
                     case 404:
                         throw new TwelvelabsApi.NotFoundError(_response.error.body, _response.rawResponse);
                     case 409:
-                        throw new TwelvelabsApi.ConflictError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
+                        throw new TwelvelabsApi.ConflictError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.TwelvelabsApiError({
                             statusCode: _response.error.statusCode,

package/api/resources/analyzeAsync/resources/tasks/client/requests/CreateAsyncAnalyzeRequest.d.ts

@@ -5,6 +5,7 @@ import * as TwelvelabsApi from "../../../../../../index";
 /**
  * @example
  *     {
+ *         customId: "prod-segment-analysis-42",
  *         video: {
  *             type: "url",
  *             url: "https://example.com/video.mp4"
@@ -13,11 +14,183 @@ import * as TwelvelabsApi from "../../../../../../index";
  *         temperature: 0.2,
  *         maxTokens: 1000
  *     }
+ *
+ * @example
+ *     {
+ *         modelName: "pegasus1.5",
+ *         video: {
+ *             type: "url",
+ *             url: "https://example.com/video.mp4"
+ *         },
+ *         analysisMode: "time_based_metadata",
+ *         responseFormat: {
+ *             type: "segment_definitions",
+ *             segmentDefinitions: [{
+ *                     id: "scene",
+ *                     description: "A distinct scene or setting change in the video",
+ *                     fields: [{
+ *                             name: "sentiment",
+ *                             type: "string",
+ *                             description: "The emotional tone of this segment",
+ *                             enum: ["positive", "negative", "neutral"]
+ *                         }, {
+ *                             name: "key_objects",
+ *                             type: "array",
+ *                             description: "Notable objects visible in this segment",
+ *                             items: {
+ *                                 type: "string"
+ *                             }
+ *                         }]
+ *                 }]
+ *         },
+ *         minSegmentDuration: 5,
+ *         maxSegmentDuration: 30
+ *     }
+ *
+ * @example
+ *     {
+ *         modelName: "pegasus1.5",
+ *         video: {
+ *             type: "url",
+ *             url: "https://example.com/video.mp4"
+ *         },
+ *         prompt: "Summarize the key events in this clip.",
+ *         maxTokens: 4096,
+ *         startTime: 10,
+ *         endTime: 60
+ *     }
+ *
+ * @example
+ *     {
+ *         modelName: "pegasus1.5",
+ *         video: {
+ *             type: "url",
+ *             url: "https://example.com/video.mp4"
+ *         },
+ *         analysisMode: "time_based_metadata",
+ *         responseFormat: {
+ *             type: "segment_definitions",
+ *             segmentDefinitions: [{
+ *                     id: "scenes",
+ *                     description: "Scene changes.",
+ *                     timeRanges: [{
+ *                             startTime: 0,
+ *                             endTime: 4
+ *                         }, {
+ *                             startTime: 10,
+ *                             endTime: 14
+ *                         }]
+ *                 }]
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         modelName: "pegasus1.5",
+ *         video: {
+ *             type: "url",
+ *             url: "https://example.com/video.mp4"
+ *         },
+ *         promptV2: {
+ *             inputText: "Is there a <@tiger-1> in the video?",
+ *             mediaSources: [{
+ *                     name: "tiger-1",
+ *                     mediaType: "image",
+ *                     url: "https://example.com/tiger.jpg"
+ *                 }]
+ *         },
+ *         maxTokens: 4096
+ *     }
  */
 export interface CreateAsyncAnalyzeRequest {
+    /**
+     * The video understanding model to use for analysis.
+     * - `pegasus1.2`: General analysis (prompt-based text generation).
+     * - `pegasus1.5`: General analysis (prompt-based text generation) with video clipping, structured prompts with reference images, extended token limits, and video segmentation.
+     *
+     * **Default:** `pegasus1.2`
+     */
+    modelName?: TwelvelabsApi.analyzeAsync.CreateAsyncAnalyzeRequestModelName;
+    /**
+     * An optional identifier that you set when you create the task. Use this field to correlate tasks across responses, for example, to distinguish tasks by type or environment.
+     *
+     * The platform stores this value unchanged and returns it in the following responses:
+     * - The [`GET`](/v1.3/api-reference/analyze-videos/retrieve-analysis-task-status-results) method of the `/analyze/tasks/{task_id}` endpoint
+     * - The [`GET`](/v1.3/api-reference/analyze-videos/list-async-analysis-tasks) method of the `/analyze/tasks` endpoint
+     * - The `analyze.task.ready` and `analyze.task.failed` webhook payloads
+     *
+     * **Format**: 1–64 characters. Alphanumeric, hyphens (`-`), and underscores (`_`) only. An empty string is rejected with a `400 Bad Request`.
+     *
+     * This field does not enforce uniqueness. You can submit multiple tasks with the same `custom_id`. To prevent duplicate task creation, use an `Idempotency-Key` header instead.
+     */
+    customId?: string;
     video: TwelvelabsApi.VideoContext;
-    prompt: TwelvelabsApi.AnalyzeTextPrompt;
+    /**
+     * Natural-language instructions for analyzing the video. Required for general analysis (prompt-based text generation). Not supported when `analysis_mode` is `time_based_metadata`. To include reference images in your prompt, use the `prompt_v2` parameter instead (Pegasus 1.5 only). Mutually exclusive with the `prompt_v2` parameter.
+     *
+     * <Note title="Notes">
+     * - Even though the model behind this endpoint is trained to a high degree of accuracy, the preciseness of the generated text may vary based on the nature and quality of the video and the clarity of the prompt.
+     * - Your prompts can be instructive or descriptive, or you can also phrase them as questions.
+     * - The maximum length of a prompt is 2,000 tokens.
+     * </Note>
+     *
+     * **Examples**:
+     *
+     * - Based on this video, I want to generate five keywords for SEO (Search Engine Optimization).
+     * - I want to generate a description for my video with the following format: Title of the video, followed by a summary in 2-3 sentences, highlighting the main topic, key events, and concluding remarks.
+     */
+    prompt?: string;
+    promptV2?: TwelvelabsApi.AnalyzePromptV2;
+    /**
+     * The analysis approach for this task.
+     * - `general`: Analyze the video and generate a response based on your prompt. Supports both free-form text and structured output via `response_format`.
+     * - `time_based_metadata`: Segment the video into time-based intervals and extract custom metadata for each segment. Requires `model_name` set to `pegasus1.5` and `response_format.type` set to `segment_definitions`.
+     *
+     * **Default:** `general`
+     */
+    analysisMode?: TwelvelabsApi.analyzeAsync.CreateAsyncAnalyzeRequestAnalysisMode;
     temperature?: TwelvelabsApi.AnalyzeTemperature;
-    maxTokens?: TwelvelabsApi.AnalyzeMaxTokens;
-    responseFormat?: TwelvelabsApi.ResponseFormat;
+    /**
+     * The maximum number of tokens to generate. The allowed range depends on the model and analysis mode:
+     *
+     * | Model | Mode | Min | Max | Default |
+     * |-------|------|-----|-----|---------|
+     * | Pegasus 1.2 | — | 1 | 4,096 | 4096 |
+     * | Pegasus 1.5 | `general` | 512 | 65,536 | 4,096 |
+     * | Pegasus 1.5 | `time_based_metadata` | 2,048 | 65,536 | 32,768 |
+     */
+    maxTokens?: number;
+    responseFormat?: TwelvelabsApi.AsyncResponseFormat;
+    /**
+     * Minimum duration for each extracted segment, in seconds. Set this value to enforce a minimum segment length. Requires `model_name` set to `pegasus1.5` and `analysis_mode` set to `time_based_metadata`. Mutually exclusive with `response_format.segment_definitions[].time_ranges`.
+     *
+     * **Min:** 2
+     */
+    minSegmentDuration?: number;
+    /**
+     * Maximum duration for each extracted segment, in seconds. Set this value to split long continuous sections into shorter segments. Must be greater than or equal to `min_segment_duration`. Requires `model_name` set to `pegasus1.5` and `analysis_mode` set to `time_based_metadata`. Mutually exclusive with `response_format.segment_definitions[].time_ranges`.
+     *
+     * **Min:** 2
+     */
+    maxSegmentDuration?: number;
+    /**
+     * Start of the analysis window, in seconds. Use with `end_time` to analyze only a portion of the video. Requires `model_name` set to `pegasus1.5`.
+     *
+     * <Note title="Notes">
+     * - If omitted, defaults to `0`.
+     * - Must be less than `end_time` and less than the video duration. The clip (`end_time - start_time`) must be at least `4` seconds.
+     * - Mutually exclusive with `response_format.segment_definitions[].time_ranges`.
+     * </Note>
+     */
+    startTime?: number;
+    /**
+     * End of the analysis window, in seconds. Use with `start_time` to analyze only a portion of the video. Requires `model_name` set to `pegasus1.5`.
+     *
+     * <Note title="Notes">
+     * - If omitted, defaults to the video duration.
+     * - Must be greater than `start_time` and less than or equal to the video duration. The clip (`end_time - start_time`) must be at least `4` seconds.
+     * - Mutually exclusive with `response_format.segment_definitions[].time_ranges`.
+     * </Note>
+     */
+    endTime?: number;
 }

package/api/resources/analyzeAsync/resources/tasks/client/requests/TasksListRequest.d.ts

@@ -7,7 +7,22 @@ import * as TwelvelabsApi from "../../../../../../index";
  *     {
  *         page: 1,
  *         pageLimit: 10,
- *         status: "queued"
+ *         status: "queued",
+ *         videoUrl: "https://example.com/video.mp4",
+ *         assetId: "69abc123def456789012abcd",
+ *         videoId: "6298d673f1090f1100476d4c",
+ *         analysisMode: "general"
+ *     }
+ *
+ * @example
+ *     {
+ *         page: 1,
+ *         pageLimit: 10,
+ *         status: "queued",
+ *         videoUrl: "https://example.com/video.mp4",
+ *         assetId: "69abc123def456789012abcd",
+ *         videoId: "6298d673f1090f1100476d4c",
+ *         analysisMode: "general"
  *     }
  */
 export interface TasksListRequest {
@@ -29,4 +44,20 @@ export interface TasksListRequest {
      * Possible values: `queued`, `pending`, `processing`, `ready`, `failed`.
      */
     status?: TwelvelabsApi.AnalyzeTaskStatus;
+    /**
+     * Filter tasks by exact video source URL.
+     */
+    videoUrl?: string;
+    /**
+     * Filter tasks by asset ID.
+     */
+    assetId?: string;
+    /**
+     * Filter tasks by video ID for pre-indexed videos (Pegasus 1.2 only). Deprecated — use `asset_id` instead.
+     */
+    videoId?: string;
+    /**
+     * Filter tasks by the analysis mode used when creating the task.
+     */
+    analysisMode?: TwelvelabsApi.analyzeAsync.TasksListRequestAnalysisMode;
 }

package/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestAnalysisMode.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * The analysis approach for this task.
+ * - `general`: Analyze the video and generate a response based on your prompt. Supports both free-form text and structured output via `response_format`.
+ * - `time_based_metadata`: Segment the video into time-based intervals and extract custom metadata for each segment. Requires `model_name` set to `pegasus1.5` and `response_format.type` set to `segment_definitions`.
+ *
+ * **Default:** `general`
+ */
+export type CreateAsyncAnalyzeRequestAnalysisMode = "general" | "time_based_metadata";
+export declare const CreateAsyncAnalyzeRequestAnalysisMode: {
+    readonly General: "general";
+    readonly TimeBasedMetadata: "time_based_metadata";
+};

package/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestAnalysisMode.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateAsyncAnalyzeRequestAnalysisMode = void 0;
+exports.CreateAsyncAnalyzeRequestAnalysisMode = {
+    General: "general",
+    TimeBasedMetadata: "time_based_metadata",
+};

package/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestModelName.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * The video understanding model to use for analysis.
+ * - `pegasus1.2`: General analysis (prompt-based text generation).
+ * - `pegasus1.5`: General analysis (prompt-based text generation) with video clipping, structured prompts with reference images, extended token limits, and video segmentation.
+ *
+ * **Default:** `pegasus1.2`
+ */
+export type CreateAsyncAnalyzeRequestModelName = "pegasus1.2" | "pegasus1.5";
+export declare const CreateAsyncAnalyzeRequestModelName: {
+    readonly Pegasus12: "pegasus1.2";
+    readonly Pegasus15: "pegasus1.5";
+};

package/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestModelName.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateAsyncAnalyzeRequestModelName = void 0;
+exports.CreateAsyncAnalyzeRequestModelName = {
+    Pegasus12: "pegasus1.2",
+    Pegasus15: "pegasus1.5",
+};

package/api/resources/analyzeAsync/resources/tasks/types/TasksListRequestAnalysisMode.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type TasksListRequestAnalysisMode = "general" | "time_based_metadata";
+export declare const TasksListRequestAnalysisMode: {
+    readonly General: "general";
+    readonly TimeBasedMetadata: "time_based_metadata";
+};

package/api/resources/analyzeAsync/resources/tasks/types/TasksListRequestAnalysisMode.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TasksListRequestAnalysisMode = void 0;
+exports.TasksListRequestAnalysisMode = {
+    General: "general",
+    TimeBasedMetadata: "time_based_metadata",
+};

package/api/resources/analyzeAsync/resources/tasks/types/index.d.ts

@@ -1 +1,4 @@
+export * from "./TasksListRequestAnalysisMode";
 export * from "./TasksListResponse";
+export * from "./CreateAsyncAnalyzeRequestModelName";
+export * from "./CreateAsyncAnalyzeRequestAnalysisMode";

package/api/resources/analyzeAsync/resources/tasks/types/index.js

@@ -14,4 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./TasksListRequestAnalysisMode"), exports);
 __exportStar(require("./TasksListResponse"), exports);
+__exportStar(require("./CreateAsyncAnalyzeRequestModelName"), exports);
+__exportStar(require("./CreateAsyncAnalyzeRequestAnalysisMode"), exports);

package/api/resources/assets/client/Client.d.ts

@@ -38,10 +38,11 @@ export declare class Assets {
      * @example
      *     await client.assets.list({
      *         page: 1,
-     *         pageLimit: 10
+     *         pageLimit: 10,
+     *         filename: "meeting"
      *     })
      */
-    list(request?: TwelvelabsApi.AssetsListRequest, requestOptions?: Assets.RequestOptions): Promise<core.Page<TwelvelabsApi.Asset>>;
+    list(request?: TwelvelabsApi.AssetsListRequest, requestOptions?: Assets.RequestOptions): Promise<core.Page<TwelvelabsApi.AssetDetail>>;
     /**
      * This method creates an asset by uploading a file to the platform. Assets are media files that you can use in downstream workflows, including indexing, analyzing video content, and creating entities.
      *
@@ -51,7 +52,10 @@ export declare class Assets {
      * - **Local file**: Set the `method` parameter to `direct` and use the `file` parameter to specify the file.
      * - **Publicly accessible URL**: Set the `method` parameter to `url` and use the `url` parameter to specify the URL of your file.
      *
-     * **File size**: 200MB maximum for local file uploads, 4GB maximum for URL uploads.
+     * **Upload limits**:
+     * - **Video and audio, local files**: Up to 200 MB
+     * - **Video and audio, public URLs**: Up to 4 GB
+     * - **Images**: Up to 5 MB
      *
      * **Additional requirements** depend on your workflow:
      * - **Search**: [Marengo requirements](/v1.3/docs/concepts/models/marengo#video-file-requirements)
@@ -86,20 +90,30 @@ export declare class Assets {
      * @example
      *     await client.assets.retrieve("6298d673f1090f1100476d4c")
      */
-    retrieve(assetId: string, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<TwelvelabsApi.Asset>;
+    retrieve(assetId: string, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<TwelvelabsApi.AssetDetail>;
     private __retrieve;
     /**
      * This method deletes the specified asset. This action cannot be undone.
      *
+     * By default, the platform checks whether any indexed assets reference the asset. If references exist, the platform rejects the request with a `409 Conflict` error. To skip this check and delete the asset anyway, set the `force` query parameter to `true`. The platform unlinks any entity associations.
+     *
+     * Before deleting, you can inspect existing references:
+     * - [`GET`](/v1.3/api-reference/index-content/list-indexed-assets-by-asset) `/assets/{asset_id}/indexed-assets` returns a list of the indexed assets that will block deletion unless the `force` query parameter is set to `true`.
+     * - [`GET`](/v1.3/api-reference/entities/list-entities-by-asset) `/assets/{asset_id}/entities` returns a list of the entities whose associations the platform will unlink.
+     *
      * @param {string} assetId - The unique identifier of the asset to delete.
+     * @param {TwelvelabsApi.AssetsDeleteRequest} request
      * @param {Assets.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link TwelvelabsApi.BadRequestError}
+     * @throws {@link TwelvelabsApi.ConflictError}
      *
      * @example
-     *     await client.assets.delete("6298d673f1090f1100476d4c")
+     *     await client.assets.delete("6298d673f1090f1100476d4c", {
+     *         force: true
+     *     })
      */
-    delete(assetId: string, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<void>;
+    delete(assetId: string, request?: TwelvelabsApi.AssetsDeleteRequest, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
     protected _getCustomAuthorizationHeaders(): Promise<{
         "x-api-key": string;