extend-ai 1.8.0 → 1.9.0

package/BaseClient.js

@@ -44,8 +44,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "extend-ai",
-        "X-Fern-SDK-Version": "1.8.0",
-        "User-Agent": "extend-ai/1.8.0",
+        "X-Fern-SDK-Version": "1.9.0",
+        "User-Agent": "extend-ai/1.9.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "x-extend-api-version": (_a = options === null || options === void 0 ? void 0 : options.extendApiVersion) !== null && _a !== void 0 ? _a : "2026-02-09",

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

@@ -13,7 +13,7 @@ export declare class BatchRunsClient {
     /**
      * Retrieve the status of a batch run by its ID. The `status` field reflects the aggregate state of the batch.
      *
-     * This is a unified endpoint that works for batches created via any of the batch submission endpoints (`POST /extract_runs/batch`, `POST /classify_runs/batch`, `POST /split_runs/batch`).
+     * This is a unified endpoint that works for batches created via any of the batch submission endpoints (`POST /parse_runs/batch`, `POST /extract_runs/batch`, `POST /classify_runs/batch`, `POST /split_runs/batch`).
      *
      * | Status | Meaning |
      * |---|---|
@@ -23,7 +23,8 @@ export declare class BatchRunsClient {
      * | `FAILED` | The batch encountered a fatal error |
      * | `CANCELLED` | The batch was cancelled |
      *
-     * To retrieve individual run results, use the List endpoint for the relevant processor type filtered by `batchId`:
+     * To retrieve individual run results, use the List endpoint for the relevant type filtered by `batchId`:
+     * - `GET /parse_runs?batchId={id}`
      * - `GET /extract_runs?batchId={id}`
      * - `GET /classify_runs?batchId={id}`
      * - `GET /split_runs?batchId={id}`

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

@@ -58,7 +58,7 @@ class BatchRunsClient {
     /**
      * Retrieve the status of a batch run by its ID. The `status` field reflects the aggregate state of the batch.
      *
-     * This is a unified endpoint that works for batches created via any of the batch submission endpoints (`POST /extract_runs/batch`, `POST /classify_runs/batch`, `POST /split_runs/batch`).
+     * This is a unified endpoint that works for batches created via any of the batch submission endpoints (`POST /parse_runs/batch`, `POST /extract_runs/batch`, `POST /classify_runs/batch`, `POST /split_runs/batch`).
      *
      * | Status | Meaning |
      * |---|---|
@@ -68,7 +68,8 @@ class BatchRunsClient {
      * | `FAILED` | The batch encountered a fatal error |
      * | `CANCELLED` | The batch was cancelled |
      *
-     * To retrieve individual run results, use the List endpoint for the relevant processor type filtered by `batchId`:
+     * To retrieve individual run results, use the List endpoint for the relevant type filtered by `batchId`:
+     * - `GET /parse_runs?batchId={id}`
      * - `GET /extract_runs?batchId={id}`
      * - `GET /classify_runs?batchId={id}`
      * - `GET /split_runs?batchId={id}`

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

@@ -10,6 +10,30 @@ export declare namespace ParseRunsClient {
 export declare class ParseRunsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ParseRunsClient.Options>;
     constructor(options: ParseRunsClient.Options);
+    /**
+     * List parse runs, with optional filters for status, batch ID, and file name.
+     *
+     * Returns a paginated list of parse runs. Use `GET /parse_runs/{id}` to retrieve the full result including output for a specific run.
+     *
+     * @param {Extend.ParseRunsListRequest} request
+     * @param {ParseRunsClient.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.parseRuns.list({
+     *         nextPageToken: "xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ="
+     *     })
+     */
+    list(request?: Extend.ParseRunsListRequest, requestOptions?: ParseRunsClient.RequestOptions): core.HttpResponsePromise<Extend.ParseRunsListResponse>;
+    private __list;
     /**
      * Parse files to get cleaned, chunked target content (e.g. markdown).
      *
@@ -89,4 +113,57 @@ export declare class ParseRunsClient {
      */
     delete(id: string, request?: Extend.ParseRunsDeleteRequest, requestOptions?: ParseRunsClient.RequestOptions): core.HttpResponsePromise<Extend.ParseRunsDeleteResponse>;
     private __delete;
+    /**
+     * Submit up to **1,000 files** for parsing in a single request. Each file is processed as an independent parse run using the same configuration.
+     *
+     * Unlike the single [Parse File (Async)](https://docs.extend.ai/2026-02-09/developers/api-reference/endpoints/parse/create-parse-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_parse_run.processed` and `batch_parse_run.failed` events. The webhook payload indicates the batch has finished — fetch individual run results using `GET /parse_runs?batchId={id}`.
+     * - **Polling:** Call `GET /batch_runs/{id}` to check the overall batch status, and use `GET /parse_runs?batchId={id}` to retrieve individual run results.
+     *
+     * **Notes:**
+     * - `inputs` must contain between 1 and 1,000 items.
+     * - File input supports URLs, Extend file IDs, and raw text strings.
+     *
+     * @param {Extend.ParseRunsCreateBatchRequest} request
+     * @param {ParseRunsClient.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.parseRuns.createBatch({
+     *         inputs: [{
+     *                 file: {
+     *                     url: "https://example.com/document1.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_abc123"
+     *                 }
+     *             }, {
+     *                 file: {
+     *                     url: "https://example.com/document2.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_def456"
+     *                 }
+     *             }, {
+     *                 file: {
+     *                     text: "This is some raw text to parse."
+     *                 },
+     *                 metadata: {
+     *                     "source": "manual-entry"
+     *                 }
+     *             }]
+     *     })
+     */
+    createBatch(request: Extend.ParseRunsCreateBatchRequest, requestOptions?: ParseRunsClient.RequestOptions): core.HttpResponsePromise<Extend.BatchRun>;
+    private __createBatch;
 }

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

@@ -55,6 +55,90 @@ class ParseRunsClient {
     constructor(options) {
         this._options = (0, BaseClient_1.normalizeClientOptionsWithAuth)(options);
     }
+    /**
+     * List parse runs, with optional filters for status, batch ID, and file name.
+     *
+     * Returns a paginated list of parse runs. Use `GET /parse_runs/{id}` to retrieve the full result including output for a specific run.
+     *
+     * @param {Extend.ParseRunsListRequest} request
+     * @param {ParseRunsClient.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.parseRuns.list({
+     *         nextPageToken: "xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ="
+     *     })
+     */
+    list(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
+    }
+    __list() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const { status, batchId, fileNameContains, nextPageToken, maxPageSize, "x-extend-workspace-id": extendWorkspaceId, } = request;
+            const _queryParams = {
+                status: status != null ? status : undefined,
+                batchId,
+                fileNameContains,
+                nextPageToken,
+                maxPageSize,
+            };
+            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-workspace-id": extendWorkspaceId,
+                "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, "parse_runs"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                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, "GET", "/parse_runs");
+        });
+    }
     /**
      * Parse files to get cleaned, chunked target content (e.g. markdown).
      *
@@ -295,5 +379,110 @@ class ParseRunsClient {
             return (0, handleNonStatusCodeError_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/parse_runs/{id}");
         });
     }
+    /**
+     * Submit up to **1,000 files** for parsing in a single request. Each file is processed as an independent parse run using the same configuration.
+     *
+     * Unlike the single [Parse File (Async)](https://docs.extend.ai/2026-02-09/developers/api-reference/endpoints/parse/create-parse-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_parse_run.processed` and `batch_parse_run.failed` events. The webhook payload indicates the batch has finished — fetch individual run results using `GET /parse_runs?batchId={id}`.
+     * - **Polling:** Call `GET /batch_runs/{id}` to check the overall batch status, and use `GET /parse_runs?batchId={id}` to retrieve individual run results.
+     *
+     * **Notes:**
+     * - `inputs` must contain between 1 and 1,000 items.
+     * - File input supports URLs, Extend file IDs, and raw text strings.
+     *
+     * @param {Extend.ParseRunsCreateBatchRequest} request
+     * @param {ParseRunsClient.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.parseRuns.createBatch({
+     *         inputs: [{
+     *                 file: {
+     *                     url: "https://example.com/document1.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_abc123"
+     *                 }
+     *             }, {
+     *                 file: {
+     *                     url: "https://example.com/document2.pdf"
+     *                 },
+     *                 metadata: {
+     *                     "customerId": "cust_def456"
+     *                 }
+     *             }, {
+     *                 file: {
+     *                     text: "This is some raw text to parse."
+     *                 },
+     *                 metadata: {
+     *                     "source": "manual-entry"
+     *                 }
+     *             }]
+     *     })
+     */
+    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, "parse_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", "/parse_runs/batch");
+        });
+    }
 }
 exports.ParseRunsClient = ParseRunsClient;

package/api/resources/parseRuns/client/requests/ParseRunsCreateBatchRequest.d.ts

@@ -0,0 +1,35 @@
+import type * as Extend from "../../../../index";
+/**
+ * @example
+ *     {
+ *         inputs: [{
+ *                 file: {
+ *                     url: "https://example.com/document1.pdf"
+ *                 },
+ *                 metadata: {
+ *                     "customerId": "cust_abc123"
+ *                 }
+ *             }, {
+ *                 file: {
+ *                     url: "https://example.com/document2.pdf"
+ *                 },
+ *                 metadata: {
+ *                     "customerId": "cust_def456"
+ *                 }
+ *             }, {
+ *                 file: {
+ *                     text: "This is some raw text to parse."
+ *                 },
+ *                 metadata: {
+ *                     "source": "manual-entry"
+ *                 }
+ *             }]
+ *     }
+ */
+export interface ParseRunsCreateBatchRequest {
+    /** An array of inputs to parse. Each item produces one parse run. Must contain between 1 and 1,000 items. */
+    inputs: Extend.ParseRunsCreateBatchRequestInputsItem[];
+    /** Optional parsing configuration applied to every run in this batch. If omitted, default parse settings are used. */
+    config?: Extend.ParseConfig;
+    priority?: Extend.RunPriority;
+}

package/api/resources/parseRuns/client/requests/ParseRunsCreateBatchRequest.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/parseRuns/client/requests/ParseRunsListRequest.d.ts

@@ -0,0 +1,27 @@
+import type * as Extend from "../../../../index";
+/**
+ * @example
+ *     {
+ *         nextPageToken: "xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ="
+ *     }
+ */
+export interface ParseRunsListRequest {
+    /** Filter parse runs by status. */
+    status?: Extend.ParseRunsListRequestStatus;
+    /**
+     * Filter parse runs by the batch they belong to. Use this after submitting a batch via `POST /parse_runs/batch` to retrieve individual run results.
+     *
+     * Example: `"bpar_Xj8mK2pL9nR4vT7qY5wZ"`
+     */
+    batchId?: string;
+    /**
+     * Filters runs by the name of the file. Only returns runs where the file name contains this string.
+     *
+     * Example: `"invoice"`
+     */
+    fileNameContains?: string;
+    nextPageToken?: Extend.NextPageToken;
+    maxPageSize?: Extend.MaxPageSize;
+    /** The workspace ID to target. **Required** when using an organization-scoped API key; optional for workspace-scoped keys (the key is already tied to a workspace). See [Authentication](https://docs.extend.ai/2026-02-09/developers/authentication) for details on API key scopes. */
+    "x-extend-workspace-id"?: string;
+}

package/api/resources/parseRuns/client/requests/ParseRunsListRequest.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/parseRuns/client/requests/index.d.ts

@@ -1,3 +1,5 @@
+export type { ParseRunsCreateBatchRequest } from "./ParseRunsCreateBatchRequest";
 export type { ParseRunsCreateRequest } from "./ParseRunsCreateRequest";
 export type { ParseRunsDeleteRequest } from "./ParseRunsDeleteRequest";
+export type { ParseRunsListRequest } from "./ParseRunsListRequest";
 export type { ParseRunsRetrieveRequest } from "./ParseRunsRetrieveRequest";

package/api/resources/parseRuns/types/ParseRunsCreateBatchRequestInputsItem.d.ts

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

package/api/resources/parseRuns/types/ParseRunsCreateBatchRequestInputsItem.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/parseRuns/types/ParseRunsCreateBatchRequestInputsItemFile.d.ts

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

package/api/resources/parseRuns/types/ParseRunsCreateBatchRequestInputsItemFile.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/parseRuns/types/ParseRunsListRequestStatus.d.ts

@@ -0,0 +1,7 @@
+export declare const ParseRunsListRequestStatus: {
+    readonly Pending: "PENDING";
+    readonly Processing: "PROCESSING";
+    readonly Processed: "PROCESSED";
+    readonly Failed: "FAILED";
+};
+export type ParseRunsListRequestStatus = (typeof ParseRunsListRequestStatus)[keyof typeof ParseRunsListRequestStatus] | string;

package/api/resources/parseRuns/types/ParseRunsListRequestStatus.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.ParseRunsListRequestStatus = void 0;
+exports.ParseRunsListRequestStatus = {
+    Pending: "PENDING",
+    Processing: "PROCESSING",
+    Processed: "PROCESSED",
+    Failed: "FAILED",
+};

package/api/resources/parseRuns/types/ParseRunsListResponse.d.ts

@@ -0,0 +1,6 @@
+import type * as Extend from "../../../index";
+export interface ParseRunsListResponse {
+    object: "list";
+    data: Extend.ParseRun[];
+    nextPageToken?: Extend.NextPageToken;
+}

package/api/resources/parseRuns/types/ParseRunsListResponse.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/parseRuns/types/index.d.ts

@@ -1,3 +1,7 @@
+export * from "./ParseRunsCreateBatchRequestInputsItem";
+export * from "./ParseRunsCreateBatchRequestInputsItemFile";
 export * from "./ParseRunsCreateRequestFile";
 export * from "./ParseRunsDeleteResponse";
+export * from "./ParseRunsListRequestStatus";
+export * from "./ParseRunsListResponse";
 export * from "./ParseRunsRetrieveRequestResponseType";

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

@@ -14,6 +14,10 @@ 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("./ParseRunsCreateBatchRequestInputsItem"), exports);
+__exportStar(require("./ParseRunsCreateBatchRequestInputsItemFile"), exports);
 __exportStar(require("./ParseRunsCreateRequestFile"), exports);
 __exportStar(require("./ParseRunsDeleteResponse"), exports);
+__exportStar(require("./ParseRunsListRequestStatus"), exports);
+__exportStar(require("./ParseRunsListResponse"), exports);
 __exportStar(require("./ParseRunsRetrieveRequestResponseType"), exports);

package/api/types/BatchParseRunCompletedWebhookEvent.d.ts

@@ -0,0 +1,6 @@
+import type * as Extend from "../index";
+export interface BatchParseRunCompletedWebhookEvent {
+    /** Unique identifier for the event */
+    eventId: string;
+    payload: Extend.BatchRun;
+}

package/api/types/BatchParseRunCompletedWebhookEvent.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/types/BatchParseRunFailedWebhookEvent.d.ts

@@ -0,0 +1,6 @@
+import type * as Extend from "../index";
+export interface BatchParseRunFailedWebhookEvent {
+    /** Unique identifier for the event */
+    eventId: string;
+    payload: Extend.BatchRun;
+}

package/api/types/BatchParseRunFailedWebhookEvent.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/types/BatchRun.d.ts

@@ -1,6 +1,6 @@
 import type * as Extend from "../index";
 /**
- * A batch run represents a batch of files submitted for processing via one of the batch endpoints (`POST /extract_runs/batch`, `POST /classify_runs/batch`, or `POST /split_runs/batch`). Use `GET /batch_runs/{id}` to poll the status.
+ * A batch run represents a batch of files submitted for processing via one of the batch endpoints (`POST /parse_runs/batch`, `POST /extract_runs/batch`, `POST /classify_runs/batch`, or `POST /split_runs/batch`). Use `GET /batch_runs/{id}` to poll the status.
  *
  * **Note:** This object is not used for workflow batch runs. See `POST /workflow_runs/batch` for workflow batching.
  */

package/api/types/ParseRun.d.ts

@@ -11,10 +11,19 @@ export interface ParseRun {
      * Example: `"pr_xK9mLPqRtN3vS8wF5hB2cQ"`
      */
     id: string;
-    /** The file that was parsed. This file can be used as a parameter for other Extend endpoints, such as `POST /workflow_runs`. */
+    /**
+     * The ID of the batch this run belongs to, if created via `POST /parse_runs/batch`.
+     *
+     * **Availability:** Present when the run was submitted as part of a batch.
+     *
+     * Example: `"bpar_Xj8mK2pL9nR4vT7qY5wZ"`
+     */
+    batchId?: string | null;
+    /** The file that was parsed. This file can be used as a parameter for other Extend endpoints, such as `POST /workflow_runs`. May be `null` for batch parse runs where file ingestion failed. */
     file: Extend.FileSummary;
     /**
      * The status of the parse run:
+     * * `"PENDING"` - The run has been created and is waiting to be processed. Only applies to runs created via `POST /parse_runs/batch`.
      * * `"PROCESSING"` - The file is still being processed
      * * `"PROCESSED"` - The file was successfully processed
      * * `"FAILED"` - The processing failed (see `failureReason` for details)

package/api/types/ParseRunStatusEnum.d.ts

@@ -1,10 +1,12 @@
 /**
  * The status of the parse run:
+ * * `"PENDING"` - The run has been created and is waiting to be processed. Only applies to runs created via `POST /parse_runs/batch`.
  * * `"PROCESSING"` - The file is still being processed
  * * `"PROCESSED"` - The file was successfully processed
  * * `"FAILED"` - The processing failed (see `failureReason` for details)
  */
 export declare const ParseRunStatusEnum: {
+    readonly Pending: "PENDING";
     readonly Processing: "PROCESSING";
     readonly Processed: "PROCESSED";
     readonly Failed: "FAILED";

package/api/types/ParseRunStatusEnum.js

@@ -4,11 +4,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParseRunStatusEnum = void 0;
 /**
  * The status of the parse run:
+ * * `"PENDING"` - The run has been created and is waiting to be processed. Only applies to runs created via `POST /parse_runs/batch`.
  * * `"PROCESSING"` - The file is still being processed
  * * `"PROCESSED"` - The file was successfully processed
  * * `"FAILED"` - The processing failed (see `failureReason` for details)
  */
 exports.ParseRunStatusEnum = {
+    Pending: "PENDING",
     Processing: "PROCESSING",
     Processed: "PROCESSED",
     Failed: "FAILED",

package/api/types/WebhookEndpointEventType.d.ts

@@ -12,6 +12,8 @@ export declare const WebhookEndpointEventType: {
     readonly SplitRunFailed: "split_run.failed";
     readonly BatchProcessorRunProcessed: "batch_processor_run.processed";
     readonly BatchProcessorRunFailed: "batch_processor_run.failed";
+    readonly BatchParseRunProcessed: "batch_parse_run.processed";
+    readonly BatchParseRunFailed: "batch_parse_run.failed";
     readonly ExtractorCreated: "extractor.created";
     readonly ExtractorUpdated: "extractor.updated";
     readonly ExtractorDeleted: "extractor.deleted";

package/api/types/WebhookEndpointEventType.js

@@ -16,6 +16,8 @@ exports.WebhookEndpointEventType = {
     SplitRunFailed: "split_run.failed",
     BatchProcessorRunProcessed: "batch_processor_run.processed",
     BatchProcessorRunFailed: "batch_processor_run.failed",
+    BatchParseRunProcessed: "batch_parse_run.processed",
+    BatchParseRunFailed: "batch_parse_run.failed",
     ExtractorCreated: "extractor.created",
     ExtractorUpdated: "extractor.updated",
     ExtractorDeleted: "extractor.deleted",

package/api/types/WebhookEvent.d.ts

@@ -19,7 +19,7 @@ import type * as Extend from "../index";
  * }
  * ```
  */
-export type WebhookEvent = Extend.WebhookEvent.WorkflowRunCompleted | Extend.WebhookEvent.WorkflowRunFailed | Extend.WebhookEvent.WorkflowRunNeedsReview | Extend.WebhookEvent.WorkflowRunRejected | Extend.WebhookEvent.WorkflowRunCancelled | Extend.WebhookEvent.WorkflowRunStepRunProcessed | Extend.WebhookEvent.ExtractRunProcessed | Extend.WebhookEvent.ExtractRunFailed | Extend.WebhookEvent.ClassifyRunProcessed | Extend.WebhookEvent.ClassifyRunFailed | Extend.WebhookEvent.SplitRunProcessed | Extend.WebhookEvent.SplitRunFailed | Extend.WebhookEvent.BatchProcessorRunProcessed | Extend.WebhookEvent.BatchProcessorRunFailed | Extend.WebhookEvent.ParseRunProcessed | Extend.WebhookEvent.ParseRunFailed | Extend.WebhookEvent.EditRunProcessed | Extend.WebhookEvent.EditRunFailed | Extend.WebhookEvent.WorkflowCreated | Extend.WebhookEvent.WorkflowDeployed | Extend.WebhookEvent.WorkflowDeleted | Extend.WebhookEvent.ExtractorCreated | Extend.WebhookEvent.ExtractorUpdated | Extend.WebhookEvent.ExtractorDeleted | Extend.WebhookEvent.ExtractorDraftUpdated | Extend.WebhookEvent.ExtractorVersionPublished | Extend.WebhookEvent.ClassifierCreated | Extend.WebhookEvent.ClassifierUpdated | Extend.WebhookEvent.ClassifierDeleted | Extend.WebhookEvent.ClassifierDraftUpdated | Extend.WebhookEvent.ClassifierVersionPublished | Extend.WebhookEvent.SplitterCreated | Extend.WebhookEvent.SplitterUpdated | Extend.WebhookEvent.SplitterDeleted | Extend.WebhookEvent.SplitterDraftUpdated | Extend.WebhookEvent.SplitterVersionPublished;
+export type WebhookEvent = Extend.WebhookEvent.WorkflowRunCompleted | Extend.WebhookEvent.WorkflowRunFailed | Extend.WebhookEvent.WorkflowRunNeedsReview | Extend.WebhookEvent.WorkflowRunRejected | Extend.WebhookEvent.WorkflowRunCancelled | Extend.WebhookEvent.WorkflowRunStepRunProcessed | Extend.WebhookEvent.ExtractRunProcessed | Extend.WebhookEvent.ExtractRunFailed | Extend.WebhookEvent.ClassifyRunProcessed | Extend.WebhookEvent.ClassifyRunFailed | Extend.WebhookEvent.SplitRunProcessed | Extend.WebhookEvent.SplitRunFailed | Extend.WebhookEvent.BatchProcessorRunProcessed | Extend.WebhookEvent.BatchProcessorRunFailed | Extend.WebhookEvent.BatchParseRunProcessed | Extend.WebhookEvent.BatchParseRunFailed | Extend.WebhookEvent.ParseRunProcessed | Extend.WebhookEvent.ParseRunFailed | Extend.WebhookEvent.EditRunProcessed | Extend.WebhookEvent.EditRunFailed | Extend.WebhookEvent.WorkflowCreated | Extend.WebhookEvent.WorkflowDeployed | Extend.WebhookEvent.WorkflowDeleted | Extend.WebhookEvent.ExtractorCreated | Extend.WebhookEvent.ExtractorUpdated | Extend.WebhookEvent.ExtractorDeleted | Extend.WebhookEvent.ExtractorDraftUpdated | Extend.WebhookEvent.ExtractorVersionPublished | Extend.WebhookEvent.ClassifierCreated | Extend.WebhookEvent.ClassifierUpdated | Extend.WebhookEvent.ClassifierDeleted | Extend.WebhookEvent.ClassifierDraftUpdated | Extend.WebhookEvent.ClassifierVersionPublished | Extend.WebhookEvent.SplitterCreated | Extend.WebhookEvent.SplitterUpdated | Extend.WebhookEvent.SplitterDeleted | Extend.WebhookEvent.SplitterDraftUpdated | Extend.WebhookEvent.SplitterVersionPublished;
 export declare namespace WebhookEvent {
     interface WorkflowRunCompleted extends Extend.WorkflowRunCompletedWebhookEvent {
         eventType: "workflow_run.completed";
@@ -63,6 +63,12 @@ export declare namespace WebhookEvent {
     interface BatchProcessorRunFailed extends Extend.BatchProcessorRunFailedWebhookEvent {
         eventType: "batch_processor_run.failed";
     }
+    interface BatchParseRunProcessed extends Extend.BatchParseRunCompletedWebhookEvent {
+        eventType: "batch_parse_run.processed";
+    }
+    interface BatchParseRunFailed extends Extend.BatchParseRunFailedWebhookEvent {
+        eventType: "batch_parse_run.failed";
+    }
     interface ParseRunProcessed extends Extend.ParseRunProcessedWebhookEvent {
         eventType: "parse_run.processed";
     }

package/api/types/index.d.ts

@@ -3,6 +3,8 @@ export * from "./ApiVersionEnum";
 export * from "./ArrayStrategy";
 export * from "./ArrayStrategyType";
 export * from "./BarcodeDetails";
+export * from "./BatchParseRunCompletedWebhookEvent";
+export * from "./BatchParseRunFailedWebhookEvent";
 export * from "./BatchProcessorRunCompletedWebhookEvent";
 export * from "./BatchProcessorRunFailedWebhookEvent";
 export * from "./BatchRun";

package/api/types/index.js

@@ -19,6 +19,8 @@ __exportStar(require("./ApiVersionEnum"), exports);
 __exportStar(require("./ArrayStrategy"), exports);
 __exportStar(require("./ArrayStrategyType"), exports);
 __exportStar(require("./BarcodeDetails"), exports);
+__exportStar(require("./BatchParseRunCompletedWebhookEvent"), exports);
+__exportStar(require("./BatchParseRunFailedWebhookEvent"), exports);
 __exportStar(require("./BatchProcessorRunCompletedWebhookEvent"), exports);
 __exportStar(require("./BatchProcessorRunFailedWebhookEvent"), exports);
 __exportStar(require("./BatchRun"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "extend-ai",
-    "version": "1.8.0",
+    "version": "1.9.0",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -720,6 +720,73 @@ await client.files.upload(createReadStream("path/to/file"), {});
 </details>
 
 ## ParseRuns
+<details><summary><code>client.parseRuns.<a href="/src/api/resources/parseRuns/client/Client.ts">list</a>({ ...params }) -> Extend.ParseRunsListResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+List parse runs, with optional filters for status, batch ID, and file name.
+
+Returns a paginated list of parse runs. Use `GET /parse_runs/{id}` to retrieve the full result including output for a specific run.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.parseRuns.list({
+    nextPageToken: "xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ="
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Extend.ParseRunsListRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ParseRunsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
 <details><summary><code>client.parseRuns.<a href="/src/api/resources/parseRuns/client/Client.ts">create</a>({ ...params }) -> Extend.ParseRun</code></summary>
 <dl>
 <dd>
@@ -942,6 +1009,102 @@ Example: `"pr_xK9mLPqRtN3vS8wF5hB2cQ"`
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.parseRuns.<a href="/src/api/resources/parseRuns/client/Client.ts">createBatch</a>({ ...params }) -> Extend.BatchRun</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Submit up to **1,000 files** for parsing in a single request. Each file is processed as an independent parse run using the same configuration.
+
+Unlike the single [Parse File (Async)](https://docs.extend.ai/2026-02-09/developers/api-reference/endpoints/parse/create-parse-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_parse_run.processed` and `batch_parse_run.failed` events. The webhook payload indicates the batch has finished — fetch individual run results using `GET /parse_runs?batchId={id}`.
+- **Polling:** Call `GET /batch_runs/{id}` to check the overall batch status, and use `GET /parse_runs?batchId={id}` to retrieve individual run results.
+
+**Notes:**
+- `inputs` must contain between 1 and 1,000 items.
+- File input supports URLs, Extend file IDs, and raw text strings.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.parseRuns.createBatch({
+    inputs: [{
+            file: {
+                url: "https://example.com/document1.pdf"
+            },
+            metadata: {
+                "customerId": "cust_abc123"
+            }
+        }, {
+            file: {
+                url: "https://example.com/document2.pdf"
+            },
+            metadata: {
+                "customerId": "cust_def456"
+            }
+        }, {
+            file: {
+                text: "This is some raw text to parse."
+            },
+            metadata: {
+                "source": "manual-entry"
+            }
+        }]
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Extend.ParseRunsCreateBatchRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ParseRunsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -6269,7 +6432,7 @@ Example: `"bpr_Xj8mK2pL9nR4vT7qY5wZ"`
 
 Retrieve the status of a batch run by its ID. The `status` field reflects the aggregate state of the batch.
 
-This is a unified endpoint that works for batches created via any of the batch submission endpoints (`POST /extract_runs/batch`, `POST /classify_runs/batch`, `POST /split_runs/batch`).
+This is a unified endpoint that works for batches created via any of the batch submission endpoints (`POST /parse_runs/batch`, `POST /extract_runs/batch`, `POST /classify_runs/batch`, `POST /split_runs/batch`).
 
 | Status | Meaning |
 |---|---|
@@ -6279,7 +6442,8 @@ This is a unified endpoint that works for batches created via any of the batch s
 | `FAILED` | The batch encountered a fatal error |
 | `CANCELLED` | The batch was cancelled |
 
-To retrieve individual run results, use the List endpoint for the relevant processor type filtered by `batchId`:
+To retrieve individual run results, use the List endpoint for the relevant type filtered by `batchId`:
+- `GET /parse_runs?batchId={id}`
 - `GET /extract_runs?batchId={id}`
 - `GET /classify_runs?batchId={id}`
 - `GET /split_runs?batchId={id}`

package/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.8.0";
+export declare const SDK_VERSION = "1.9.0";

package/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.8.0";
+exports.SDK_VERSION = "1.9.0";