extend-ai 1.7.0 → 1.8.0

package/api/resources/classifyRuns/client/Client.js

@@ -83,10 +83,11 @@ class ClassifyRunsClient {
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
-            const { status, classifierId, sourceId, source, fileNameContains, sortBy, sortDir, nextPageToken, maxPageSize, "x-extend-workspace-id": extendWorkspaceId, } = request;
+            const { status, classifierId, batchId, sourceId, source, fileNameContains, sortBy, sortDir, nextPageToken, maxPageSize, "x-extend-workspace-id": extendWorkspaceId, } = request;
             const _queryParams = {
                 status: status != null ? status : undefined,
                 classifierId,
+                batchId,
                 sourceId,
                 source: source != null ? source : undefined,
                 fileNameContains,
@@ -456,5 +457,114 @@ class ClassifyRunsClient {
             return (0, handleNonStatusCodeError_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/classify_runs/{id}/cancel");
         });
     }
+    /**
+     * Submit up to **1,000 files** for classification in a single request. Each file is processed as an independent classify run using the same classifier and configuration.
+     *
+     * Unlike the single [Classify File (Async)](https://docs.extend.ai/2026-02-09/developers/api-reference/endpoints/classify/create-classify-run) endpoint, this batch endpoint accepts an `inputs` array and immediately returns a `BatchRun` object containing a batch `id` and a `PENDING` status. The individual runs are then queued and processed asynchronously.
+     *
+     * **Monitoring results:**
+     * - **Webhooks (recommended):** Subscribe to `batch_processor_run.processed` and `batch_processor_run.failed` events. The webhook payload indicates the batch has finished — fetch individual run results using `GET /classify_runs?batchId={id}`.
+     * - **Polling:** Call `GET /batch_runs/{id}` to check the overall batch status, and use `GET /classify_runs` filtered by `batchId` to retrieve individual run results.
+     *
+     * **Notes:**
+     * - A processor reference (`classifier.id`) is required — inline `config` is not supported for batch requests.
+     * - `inputs` must contain between 1 and 1,000 items.
+     * - All inputs in a batch use the same classifier version and override config.
+     *
+     * @param {Extend.ClassifyRunsCreateBatchRequest} request
+     * @param {ClassifyRunsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Extend.BadRequestError}
+     * @throws {@link Extend.UnauthorizedError}
+     * @throws {@link Extend.PaymentRequiredError}
+     * @throws {@link Extend.ForbiddenError}
+     * @throws {@link Extend.NotFoundError}
+     * @throws {@link Extend.UnprocessableEntityError}
+     * @throws {@link Extend.TooManyRequestsError}
+     * @throws {@link Extend.InternalServerError}
+     *
+     * @example
+     *     await client.classifyRuns.createBatch({
+     *         classifier: {
+     *             id: "cl_xK9mLPqRtN3vS8wF5hB2cQ"
+     *         },
+     *         inputs: [{
+     *                 file: {
+     *                     url: "https://example.com/document1.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_abc123"
+     *                 }
+     *             }, {
+     *                 file: {
+     *                     url: "https://example.com/document2.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_def456"
+     *                 }
+     *             }, {
+     *                 file: {
+     *                     url: "https://example.com/document3.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_ghi789"
+     *                 }
+     *             }]
+     *     })
+     */
+    createBatch(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createBatch(request, requestOptions));
+    }
+    __createBatch(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "x-extend-api-version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.extendApiVersion) !== null && _b !== void 0 ? _b : "2026-02-09" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_c = this._options.fetcher) !== null && _c !== void 0 ? _c : core.fetcher)({
+                url: core.url.join((_e = (_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ExtendEnvironment.Production, "classify_runs/batch"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 300) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Extend.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Extend.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 402:
+                        throw new Extend.PaymentRequiredError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Extend.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Extend.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Extend.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Extend.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Extend.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.ExtendError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/classify_runs/batch");
+        });
+    }
 }
 exports.ClassifyRunsClient = ClassifyRunsClient;

package/api/resources/classifyRuns/client/requests/ClassifyRunsCreateBatchRequest.d.ts

@@ -0,0 +1,38 @@
+import type * as Extend from "../../../../index";
+/**
+ * @example
+ *     {
+ *         classifier: {
+ *             id: "cl_xK9mLPqRtN3vS8wF5hB2cQ"
+ *         },
+ *         inputs: [{
+ *                 file: {
+ *                     url: "https://example.com/document1.pdf"
+ *                 },
+ *                 metadata: {
+ *                     "customerId": "cust_abc123"
+ *                 }
+ *             }, {
+ *                 file: {
+ *                     url: "https://example.com/document2.pdf"
+ *                 },
+ *                 metadata: {
+ *                     "customerId": "cust_def456"
+ *                 }
+ *             }, {
+ *                 file: {
+ *                     url: "https://example.com/document3.pdf"
+ *                 },
+ *                 metadata: {
+ *                     "customerId": "cust_ghi789"
+ *                 }
+ *             }]
+ *     }
+ */
+export interface ClassifyRunsCreateBatchRequest {
+    /** Reference to the classifier to run against every input in this batch. */
+    classifier: Extend.ClassifyRunsCreateBatchRequestClassifier;
+    /** An array of inputs to process. Each item produces one classify run. Must contain between 1 and 1,000 items. */
+    inputs: Extend.ClassifyRunsCreateBatchRequestInputsItem[];
+    priority?: Extend.RunPriority;
+}

package/api/resources/classifyRuns/client/requests/ClassifyRunsListRequest.d.ts

@@ -13,6 +13,12 @@ export interface ClassifyRunsListRequest {
      * Example: `"cl_BMdfq_yWM3sT-ZzvCnA3f"`
      */
     classifierId?: string;
+    /**
+     * Filters runs by the batch they belong to. Only returns runs created as part of the specified batch.
+     *
+     * Example: `"bpr_Xj8mK2pL9nR4vT7qY5wZ"`
+     */
+    batchId?: string;
     /** Filters runs by the source ID. */
     sourceId?: Extend.RunSourceId;
     /** Filters runs by the source that created them. If not provided, runs from all sources are returned. */

package/api/resources/classifyRuns/client/requests/index.d.ts

@@ -1,4 +1,5 @@
 export type { ClassifyRunsCancelRequest } from "./ClassifyRunsCancelRequest";
+export type { ClassifyRunsCreateBatchRequest } from "./ClassifyRunsCreateBatchRequest";
 export type { ClassifyRunsCreateRequest } from "./ClassifyRunsCreateRequest";
 export type { ClassifyRunsDeleteRequest } from "./ClassifyRunsDeleteRequest";
 export type { ClassifyRunsListRequest } from "./ClassifyRunsListRequest";

package/api/resources/classifyRuns/types/ClassifyRunsCreateBatchRequestClassifier.d.ts

@@ -0,0 +1,11 @@
+import type * as Extend from "../../../index";
+/**
+ * Reference to the classifier to run against every input in this batch.
+ */
+export interface ClassifyRunsCreateBatchRequestClassifier {
+    /** The ID of the classifier to use. */
+    id: string;
+    version?: Extend.ProcessorVersionString;
+    /** Optional partial configuration override applied to every run in this batch. Only the fields you provide will override the classifier's saved configuration. */
+    overrideConfig?: Extend.ClassifyOverrideConfig;
+}

package/api/resources/classifyRuns/types/ClassifyRunsCreateBatchRequestInputsItem.d.ts

@@ -0,0 +1,6 @@
+import type * as Extend from "../../../index";
+export interface ClassifyRunsCreateBatchRequestInputsItem {
+    /** The file to classify. Can be a URL, an Extend file ID, or raw text. */
+    file: Extend.ClassifyRunsCreateBatchRequestInputsItemFile;
+    metadata?: Extend.RunMetadata;
+}

package/api/resources/classifyRuns/types/ClassifyRunsCreateBatchRequestInputsItemFile.d.ts

@@ -0,0 +1,5 @@
+import type * as Extend from "../../../index";
+/**
+ * The file to classify. Can be a URL, an Extend file ID, or raw text.
+ */
+export type ClassifyRunsCreateBatchRequestInputsItemFile = Extend.FileFromUrl | Extend.FileFromId | Extend.FileFromText;

package/api/resources/classifyRuns/types/index.d.ts

@@ -1,3 +1,6 @@
+export * from "./ClassifyRunsCreateBatchRequestClassifier";
+export * from "./ClassifyRunsCreateBatchRequestInputsItem";
+export * from "./ClassifyRunsCreateBatchRequestInputsItemFile";
 export * from "./ClassifyRunsCreateRequestClassifier";
 export * from "./ClassifyRunsCreateRequestFile";
 export * from "./ClassifyRunsDeleteResponse";

package/api/resources/classifyRuns/types/index.js

@@ -14,6 +14,9 @@ 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("./ClassifyRunsCreateBatchRequestClassifier"), exports);
+__exportStar(require("./ClassifyRunsCreateBatchRequestInputsItem"), exports);
+__exportStar(require("./ClassifyRunsCreateBatchRequestInputsItemFile"), exports);
 __exportStar(require("./ClassifyRunsCreateRequestClassifier"), exports);
 __exportStar(require("./ClassifyRunsCreateRequestFile"), exports);
 __exportStar(require("./ClassifyRunsDeleteResponse"), exports);

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

@@ -136,4 +136,61 @@ export declare class ExtractRunsClient {
      */
     cancel(id: string, request?: Extend.ExtractRunsCancelRequest, requestOptions?: ExtractRunsClient.RequestOptions): core.HttpResponsePromise<Extend.ExtractRun>;
     private __cancel;
+    /**
+     * Submit up to **1,000 files** for extraction in a single request. Each file is processed as an independent extract run using the same extractor and configuration.
+     *
+     * Unlike the single [Extract File (Async)](https://docs.extend.ai/2026-02-09/developers/api-reference/endpoints/extract/create-extract-run) endpoint, this batch endpoint accepts an `inputs` array and immediately returns a `BatchRun` object containing a batch `id` and a `PENDING` status. The individual runs are then queued and processed asynchronously.
+     *
+     * **Monitoring results:**
+     * - **Webhooks (recommended):** Subscribe to `batch_processor_run.processed` and `batch_processor_run.failed` events. The webhook payload indicates the batch has finished — fetch individual run results using `GET /extract_runs?batchId={id}`.
+     * - **Polling:** Call `GET /batch_runs/{id}` to check the overall batch status, and use `GET /extract_runs` filtered by `batchId` to retrieve individual run results.
+     *
+     * **Notes:**
+     * - A processor reference (`extractor.id`) is required — inline `config` is not supported for batch requests.
+     * - `inputs` must contain between 1 and 1,000 items.
+     * - All inputs in a batch use the same extractor version and override config.
+     *
+     * @param {Extend.ExtractRunsCreateBatchRequest} request
+     * @param {ExtractRunsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Extend.BadRequestError}
+     * @throws {@link Extend.UnauthorizedError}
+     * @throws {@link Extend.PaymentRequiredError}
+     * @throws {@link Extend.ForbiddenError}
+     * @throws {@link Extend.NotFoundError}
+     * @throws {@link Extend.UnprocessableEntityError}
+     * @throws {@link Extend.TooManyRequestsError}
+     * @throws {@link Extend.InternalServerError}
+     *
+     * @example
+     *     await client.extractRuns.createBatch({
+     *         extractor: {
+     *             id: "ex_xK9mLPqRtN3vS8wF5hB2cQ"
+     *         },
+     *         inputs: [{
+     *                 file: {
+     *                     url: "https://example.com/invoice1.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_abc123"
+     *                 }
+     *             }, {
+     *                 file: {
+     *                     url: "https://example.com/invoice2.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_def456"
+     *                 }
+     *             }, {
+     *                 file: {
+     *                     url: "https://example.com/invoice3.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_ghi789"
+     *                 }
+     *             }]
+     *     })
+     */
+    createBatch(request: Extend.ExtractRunsCreateBatchRequest, requestOptions?: ExtractRunsClient.RequestOptions): core.HttpResponsePromise<Extend.BatchRun>;
+    private __createBatch;
 }

package/api/resources/extractRuns/client/Client.js

@@ -83,10 +83,11 @@ class ExtractRunsClient {
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
-            const { status, extractorId, sourceId, source, fileNameContains, sortBy, sortDir, nextPageToken, maxPageSize, "x-extend-workspace-id": extendWorkspaceId, } = request;
+            const { status, extractorId, batchId, sourceId, source, fileNameContains, sortBy, sortDir, nextPageToken, maxPageSize, "x-extend-workspace-id": extendWorkspaceId, } = request;
             const _queryParams = {
                 status: status != null ? status : undefined,
                 extractorId,
+                batchId,
                 sourceId,
                 source: source != null ? source : undefined,
                 fileNameContains,
@@ -456,5 +457,114 @@ class ExtractRunsClient {
             return (0, handleNonStatusCodeError_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/extract_runs/{id}/cancel");
         });
     }
+    /**
+     * Submit up to **1,000 files** for extraction in a single request. Each file is processed as an independent extract run using the same extractor and configuration.
+     *
+     * Unlike the single [Extract File (Async)](https://docs.extend.ai/2026-02-09/developers/api-reference/endpoints/extract/create-extract-run) endpoint, this batch endpoint accepts an `inputs` array and immediately returns a `BatchRun` object containing a batch `id` and a `PENDING` status. The individual runs are then queued and processed asynchronously.
+     *
+     * **Monitoring results:**
+     * - **Webhooks (recommended):** Subscribe to `batch_processor_run.processed` and `batch_processor_run.failed` events. The webhook payload indicates the batch has finished — fetch individual run results using `GET /extract_runs?batchId={id}`.
+     * - **Polling:** Call `GET /batch_runs/{id}` to check the overall batch status, and use `GET /extract_runs` filtered by `batchId` to retrieve individual run results.
+     *
+     * **Notes:**
+     * - A processor reference (`extractor.id`) is required — inline `config` is not supported for batch requests.
+     * - `inputs` must contain between 1 and 1,000 items.
+     * - All inputs in a batch use the same extractor version and override config.
+     *
+     * @param {Extend.ExtractRunsCreateBatchRequest} request
+     * @param {ExtractRunsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Extend.BadRequestError}
+     * @throws {@link Extend.UnauthorizedError}
+     * @throws {@link Extend.PaymentRequiredError}
+     * @throws {@link Extend.ForbiddenError}
+     * @throws {@link Extend.NotFoundError}
+     * @throws {@link Extend.UnprocessableEntityError}
+     * @throws {@link Extend.TooManyRequestsError}
+     * @throws {@link Extend.InternalServerError}
+     *
+     * @example
+     *     await client.extractRuns.createBatch({
+     *         extractor: {
+     *             id: "ex_xK9mLPqRtN3vS8wF5hB2cQ"
+     *         },
+     *         inputs: [{
+     *                 file: {
+     *                     url: "https://example.com/invoice1.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_abc123"
+     *                 }
+     *             }, {
+     *                 file: {
+     *                     url: "https://example.com/invoice2.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_def456"
+     *                 }
+     *             }, {
+     *                 file: {
+     *                     url: "https://example.com/invoice3.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_ghi789"
+     *                 }
+     *             }]
+     *     })
+     */
+    createBatch(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createBatch(request, requestOptions));
+    }
+    __createBatch(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "x-extend-api-version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.extendApiVersion) !== null && _b !== void 0 ? _b : "2026-02-09" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_c = this._options.fetcher) !== null && _c !== void 0 ? _c : core.fetcher)({
+                url: core.url.join((_e = (_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ExtendEnvironment.Production, "extract_runs/batch"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 300) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Extend.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Extend.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 402:
+                        throw new Extend.PaymentRequiredError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Extend.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Extend.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Extend.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Extend.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Extend.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.ExtendError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/extract_runs/batch");
+        });
+    }
 }
 exports.ExtractRunsClient = ExtractRunsClient;

package/api/resources/extractRuns/client/requests/ExtractRunsCreateBatchRequest.d.ts

@@ -0,0 +1,38 @@
+import type * as Extend from "../../../../index";
+/**
+ * @example
+ *     {
+ *         extractor: {
+ *             id: "ex_xK9mLPqRtN3vS8wF5hB2cQ"
+ *         },
+ *         inputs: [{
+ *                 file: {
+ *                     url: "https://example.com/invoice1.pdf"
+ *                 },
+ *                 metadata: {
+ *                     "customerId": "cust_abc123"
+ *                 }
+ *             }, {
+ *                 file: {
+ *                     url: "https://example.com/invoice2.pdf"
+ *                 },
+ *                 metadata: {
+ *                     "customerId": "cust_def456"
+ *                 }
+ *             }, {
+ *                 file: {
+ *                     url: "https://example.com/invoice3.pdf"
+ *                 },
+ *                 metadata: {
+ *                     "customerId": "cust_ghi789"
+ *                 }
+ *             }]
+ *     }
+ */
+export interface ExtractRunsCreateBatchRequest {
+    /** Reference to the extractor to run against every input in this batch. */
+    extractor: Extend.ExtractRunsCreateBatchRequestExtractor;
+    /** An array of inputs to process. Each item produces one extract run. Must contain between 1 and 1,000 items. */
+    inputs: Extend.ExtractRunsCreateBatchRequestInputsItem[];
+    priority?: Extend.RunPriority;
+}

package/api/resources/extractRuns/client/requests/ExtractRunsListRequest.d.ts

@@ -13,6 +13,12 @@ export interface ExtractRunsListRequest {
      * Example: `"ex_BMdfq_yWM3sT-ZzvCnA3f"`
      */
     extractorId?: string;
+    /**
+     * Filters runs by the batch they belong to. Only returns runs created as part of the specified batch.
+     *
+     * Example: `"bpr_Xj8mK2pL9nR4vT7qY5wZ"`
+     */
+    batchId?: string;
     /** Filters runs by the source ID. */
     sourceId?: Extend.RunSourceId;
     /** Filters runs by the source that created them. If not provided, runs from all sources are returned. */

package/api/resources/extractRuns/client/requests/index.d.ts

@@ -1,4 +1,5 @@
 export type { ExtractRunsCancelRequest } from "./ExtractRunsCancelRequest";
+export type { ExtractRunsCreateBatchRequest } from "./ExtractRunsCreateBatchRequest";
 export type { ExtractRunsCreateRequest } from "./ExtractRunsCreateRequest";
 export type { ExtractRunsDeleteRequest } from "./ExtractRunsDeleteRequest";
 export type { ExtractRunsListRequest } from "./ExtractRunsListRequest";

package/api/resources/extractRuns/types/ExtractRunsCreateBatchRequestExtractor.d.ts

@@ -0,0 +1,11 @@
+import type * as Extend from "../../../index";
+/**
+ * Reference to the extractor to run against every input in this batch.
+ */
+export interface ExtractRunsCreateBatchRequestExtractor {
+    /** The ID of the extractor to use. */
+    id: string;
+    version?: Extend.ProcessorVersionString;
+    /** Optional partial configuration override applied to every run in this batch. Only the fields you provide will override the extractor's saved configuration. */
+    overrideConfig?: Extend.ExtractOverrideConfigJson;
+}

package/api/resources/extractRuns/types/ExtractRunsCreateBatchRequestInputsItem.d.ts

@@ -0,0 +1,6 @@
+import type * as Extend from "../../../index";
+export interface ExtractRunsCreateBatchRequestInputsItem {
+    /** The file to extract from. Can be a URL, an Extend file ID, or raw text. */
+    file: Extend.ExtractRunsCreateBatchRequestInputsItemFile;
+    metadata?: Extend.RunMetadata;
+}

package/api/resources/extractRuns/types/ExtractRunsCreateBatchRequestInputsItem.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/extractRuns/types/ExtractRunsCreateBatchRequestInputsItemFile.d.ts

@@ -0,0 +1,5 @@
+import type * as Extend from "../../../index";
+/**
+ * The file to extract from. Can be a URL, an Extend file ID, or raw text.
+ */
+export type ExtractRunsCreateBatchRequestInputsItemFile = Extend.FileFromUrl | Extend.FileFromId | Extend.FileFromText;

package/api/resources/extractRuns/types/ExtractRunsCreateBatchRequestInputsItemFile.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/extractRuns/types/index.d.ts

@@ -1,3 +1,6 @@
+export * from "./ExtractRunsCreateBatchRequestExtractor";
+export * from "./ExtractRunsCreateBatchRequestInputsItem";
+export * from "./ExtractRunsCreateBatchRequestInputsItemFile";
 export * from "./ExtractRunsCreateRequestExtractor";
 export * from "./ExtractRunsCreateRequestFile";
 export * from "./ExtractRunsDeleteResponse";

package/api/resources/extractRuns/types/index.js

@@ -14,6 +14,9 @@ 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("./ExtractRunsCreateBatchRequestExtractor"), exports);
+__exportStar(require("./ExtractRunsCreateBatchRequestInputsItem"), exports);
+__exportStar(require("./ExtractRunsCreateBatchRequestInputsItemFile"), exports);
 __exportStar(require("./ExtractRunsCreateRequestExtractor"), exports);
 __exportStar(require("./ExtractRunsCreateRequestFile"), exports);
 __exportStar(require("./ExtractRunsDeleteResponse"), exports);

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

@@ -71,9 +71,12 @@ export declare class ExtractorVersionsClient {
      * @param {string} extractorId - The ID of the extractor.
      *
      *                               Example: `"ex_Xj8mK2pL9nR4vT7qY5wZ"`
-     * @param {string} versionId - The ID of the specific extractor version.
+     * @param {string} versionId - The version to retrieve. Accepts any of the following:
      *
-     *                             Example: `"extv_QYk6jgHA_8CsO8rVWhyNC"`
+     *                             - `"draft"` — returns the current draft version
+     *                             - `"latest"` — returns the latest published version (falls back to draft if none published)
+     *                             - A version number (e.g. `"0.1"`, `"1.0"`) — returns that specific published version
+     *                             - A version ID (e.g. `"extv_QYk6jgHA_8CsO8rVWhyNC"`) — returns that specific version by ID
      * @param {Extend.ExtractorVersionsRetrieveRequest} request
      * @param {ExtractorVersionsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -87,7 +90,7 @@ export declare class ExtractorVersionsClient {
      * @throws {@link Extend.InternalServerError}
      *
      * @example
-     *     await client.extractorVersions.retrieve("extractor_id_here", "extractor_version_id_here")
+     *     await client.extractorVersions.retrieve("extractor_id_here", "draft")
      */
     retrieve(extractorId: string, versionId: string, request?: Extend.ExtractorVersionsRetrieveRequest, requestOptions?: ExtractorVersionsClient.RequestOptions): core.HttpResponsePromise<Extend.ExtractorVersion>;
     private __retrieve;

package/api/resources/extractorVersions/client/Client.js

@@ -241,9 +241,12 @@ class ExtractorVersionsClient {
      * @param {string} extractorId - The ID of the extractor.
      *
      *                               Example: `"ex_Xj8mK2pL9nR4vT7qY5wZ"`
-     * @param {string} versionId - The ID of the specific extractor version.
+     * @param {string} versionId - The version to retrieve. Accepts any of the following:
      *
-     *                             Example: `"extv_QYk6jgHA_8CsO8rVWhyNC"`
+     *                             - `"draft"` — returns the current draft version
+     *                             - `"latest"` — returns the latest published version (falls back to draft if none published)
+     *                             - A version number (e.g. `"0.1"`, `"1.0"`) — returns that specific published version
+     *                             - A version ID (e.g. `"extv_QYk6jgHA_8CsO8rVWhyNC"`) — returns that specific version by ID
      * @param {Extend.ExtractorVersionsRetrieveRequest} request
      * @param {ExtractorVersionsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -257,7 +260,7 @@ class ExtractorVersionsClient {
      * @throws {@link Extend.InternalServerError}
      *
      * @example
-     *     await client.extractorVersions.retrieve("extractor_id_here", "extractor_version_id_here")
+     *     await client.extractorVersions.retrieve("extractor_id_here", "draft")
      */
     retrieve(extractorId, versionId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__retrieve(extractorId, versionId, request, requestOptions));

package/api/resources/index.d.ts

@@ -1,6 +1,7 @@
 export * as batchProcessorRun from "./batchProcessorRun";
 export * from "./batchProcessorRun/client/requests";
 export * from "./batchProcessorRun/types";
+export * as batchRuns from "./batchRuns";
 export * as classifiers from "./classifiers";
 export * from "./classifiers/client/requests";
 export * from "./classifiers/types";

package/api/resources/index.js

@@ -36,10 +36,11 @@ 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 });
-exports.workflowVersions = exports.workflows = exports.workflowRuns = exports.webhookSubscriptions = exports.webhookEndpoints = exports.splitterVersions = exports.splitters = exports.splitRuns = exports.processorVersion = exports.processorRun = exports.processor = exports.parseRuns = exports.files = exports.extractRuns = exports.extractorVersions = exports.extractors = exports.evaluationSets = exports.evaluationSetRuns = exports.evaluationSetItems = exports.editSchemas = exports.editRuns = exports.classifyRuns = exports.classifierVersions = exports.classifiers = exports.batchProcessorRun = void 0;
+exports.workflowVersions = exports.workflows = exports.workflowRuns = exports.webhookSubscriptions = exports.webhookEndpoints = exports.splitterVersions = exports.splitters = exports.splitRuns = exports.processorVersion = exports.processorRun = exports.processor = exports.parseRuns = exports.files = exports.extractRuns = exports.extractorVersions = exports.extractors = exports.evaluationSets = exports.evaluationSetRuns = exports.evaluationSetItems = exports.editSchemas = exports.editRuns = exports.classifyRuns = exports.classifierVersions = exports.classifiers = exports.batchRuns = exports.batchProcessorRun = void 0;
 exports.batchProcessorRun = __importStar(require("./batchProcessorRun"));
 __exportStar(require("./batchProcessorRun/client/requests"), exports);
 __exportStar(require("./batchProcessorRun/types"), exports);
+exports.batchRuns = __importStar(require("./batchRuns"));
 exports.classifiers = __importStar(require("./classifiers"));
 __exportStar(require("./classifiers/client/requests"), exports);
 __exportStar(require("./classifiers/types"), exports);