extend-ai 1.6.0 → 1.8.0

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

@@ -0,0 +1,287 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowVersionsClient = void 0;
+const BaseClient_1 = require("../../../../BaseClient");
+const core = __importStar(require("../../../../core"));
+const headers_1 = require("../../../../core/headers");
+const environments = __importStar(require("../../../../environments"));
+const handleNonStatusCodeError_1 = require("../../../../errors/handleNonStatusCodeError");
+const errors = __importStar(require("../../../../errors/index"));
+const Extend = __importStar(require("../../../index"));
+class WorkflowVersionsClient {
+    constructor(options) {
+        this._options = (0, BaseClient_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * List all versions of a workflow, including the draft version. Returns a paginated list of version summaries.
+     *
+     * @param {string} id - The ID of the workflow.
+     * @param {Extend.WorkflowVersionsListRequest} request
+     * @param {WorkflowVersionsClient.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.workflowVersions.list("workflow_abc123", {
+     *         nextPageToken: "xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ="
+     *     })
+     */
+    list(id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(id, request, requestOptions));
+    }
+    __list(id_1) {
+        return __awaiter(this, arguments, void 0, function* (id, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const { nextPageToken, maxPageSize, sortDir } = request;
+            const _queryParams = {
+                nextPageToken,
+                maxPageSize,
+                sortDir: sortDir != null ? sortDir : undefined,
+            };
+            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, `workflows/${core.url.encodePathParam(id)}/versions`),
+                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", "/workflows/{id}/versions");
+        });
+    }
+    /**
+     * Deploy a new version of a workflow. The deployed version becomes available for running workflow runs.
+     *
+     * When `steps` is omitted, the current draft is deployed as-is. When `steps` is provided, the given steps are deployed directly without modifying the draft.
+     *
+     * @param {string} id - The ID of the workflow to deploy.
+     * @param {Extend.WorkflowVersionsCreateRequest} request
+     * @param {WorkflowVersionsClient.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.workflowVersions.create("workflow_abc123")
+     */
+    create(id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__create(id, request, requestOptions));
+    }
+    __create(id_1) {
+        return __awaiter(this, arguments, void 0, function* (id, request = {}, requestOptions) {
+            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, `workflows/${core.url.encodePathParam(id)}/versions`),
+                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", "/workflows/{id}/versions");
+        });
+    }
+    /**
+     * Get a specific version of a workflow, including its step definitions.
+     *
+     * @param {string} id - The ID of the workflow.
+     * @param {string} versionId - The version to retrieve. Accepts any of the following:
+     *
+     *                             - `"draft"` — returns the current draft version
+     *                             - `"latest"` — returns the latest published version (falls back to draft if none published)
+     *                             - A version number (e.g. `"1"`, `"2"`) — returns that specific published version
+     *                             - A version ID (e.g. `"workflow_version_abc123"`) — returns that specific version by ID
+     * @param {WorkflowVersionsClient.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.workflowVersions.retrieve("workflow_abc123", "draft")
+     */
+    retrieve(id, versionId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__retrieve(id, versionId, requestOptions));
+    }
+    __retrieve(id, versionId, 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, `workflows/${core.url.encodePathParam(id)}/versions/${core.url.encodePathParam(versionId)}`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: 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", "/workflows/{id}/versions/{versionId}");
+        });
+    }
+}
+exports.WorkflowVersionsClient = WorkflowVersionsClient;

package/api/resources/workflowVersions/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests";

package/api/resources/workflowVersions/client/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./requests"), exports);

package/api/resources/workflowVersions/client/requests/WorkflowVersionsCreateRequest.d.ts

@@ -0,0 +1,17 @@
+import type * as Extend from "../../../../index";
+/**
+ * @example
+ *     {}
+ */
+export interface WorkflowVersionsCreateRequest {
+    /** An optional name for this deployed version. */
+    name?: string;
+    /**
+     * Optional step definitions. When provided, these steps are deployed directly without modifying the draft. When omitted, the current draft is deployed.
+     *
+     * All configurable steps (`EXTRACT`, `CLASSIFY`, `SPLIT`, `CONDITIONAL_EXTRACT`, `RULE_VALIDATION`, `EXTERNAL_DATA_VALIDATION`) must include `config` when deploying. Unconfigured steps are rejected with a 400.
+     *
+     * See the [Configuring Workflows via API guide](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api) for step definitions, branching patterns, and examples.
+     */
+    steps?: Extend.WorkflowStepDefinition[];
+}

package/api/resources/workflowVersions/client/requests/WorkflowVersionsCreateRequest.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/workflowVersions/client/requests/WorkflowVersionsListRequest.d.ts

@@ -0,0 +1,12 @@
+import type * as Extend from "../../../../index";
+/**
+ * @example
+ *     {
+ *         nextPageToken: "xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ="
+ *     }
+ */
+export interface WorkflowVersionsListRequest {
+    nextPageToken?: Extend.NextPageToken;
+    maxPageSize?: Extend.MaxPageSize;
+    sortDir?: Extend.SortDir;
+}

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

@@ -0,0 +1,2 @@
+export type { WorkflowVersionsCreateRequest } from "./WorkflowVersionsCreateRequest";
+export type { WorkflowVersionsListRequest } from "./WorkflowVersionsListRequest";

package/api/resources/workflowVersions/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/workflowVersions/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client";
+export * from "./types";

package/api/resources/workflowVersions/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./client"), exports);
+__exportStar(require("./types"), exports);

package/api/resources/workflowVersions/types/WorkflowVersionsListResponse.d.ts

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

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

@@ -0,0 +1 @@
+export * from "./WorkflowVersionsListResponse";

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

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./WorkflowVersionsListResponse"), exports);

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

@@ -11,9 +11,33 @@ export declare class WorkflowsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<WorkflowsClient.Options>;
     constructor(options: WorkflowsClient.Options);
     /**
-     * Create a new workflow in Extend. Workflows are sequences of steps that process files and data in a specific order to achieve a desired outcome.
+     * List all workflows. Returns a paginated list of workflow summaries.
      *
-     * This endpoint will create a new workflow in Extend, which can then be configured and deployed. Typically, workflows are created from our UI, however this endpoint can be used to create workflows programmatically. Configuration of the flow still needs to be done in the dashboard.
+     * @param {Extend.WorkflowsListRequest} request
+     * @param {WorkflowsClient.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.workflows.list({
+     *         nextPageToken: "xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ="
+     *     })
+     */
+    list(request?: Extend.WorkflowsListRequest, requestOptions?: WorkflowsClient.RequestOptions): core.HttpResponsePromise<Extend.WorkflowsListResponse>;
+    private __list;
+    /**
+     * Create a new workflow. Optionally provide `steps` to define the workflow's step graph.
+     *
+     * When `steps` is omitted, the workflow is created with default steps (`TRIGGER` → `PARSE`). When `steps` is provided, the step graph is validated and the draft version is populated with the given steps.
+     *
+     * **Note:** The default steps may change in the future. If your integration depends on a specific step graph, provide `steps` explicitly.
      *
      * @param {Extend.WorkflowsCreateRequest} request
      * @param {WorkflowsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -31,7 +55,105 @@ export declare class WorkflowsClient {
      *     await client.workflows.create({
      *         name: "Invoice Processing"
      *     })
+     *
+     * @example
+     *     await client.workflows.create({
+     *         name: "Invoice Processing",
+     *         steps: [{
+     *                 type: "TRIGGER",
+     *                 name: "name"
+     *             }, {
+     *                 type: "PARSE",
+     *                 name: "name"
+     *             }, {
+     *                 type: "EXTRACT",
+     *                 name: "name"
+     *             }, {
+     *                 type: "HUMAN_REVIEW",
+     *                 name: "name"
+     *             }]
+     *     })
+     *
+     * @example
+     *     await client.workflows.create({
+     *         name: "Document Routing",
+     *         steps: [{
+     *                 type: "TRIGGER",
+     *                 name: "name"
+     *             }, {
+     *                 type: "PARSE",
+     *                 name: "name"
+     *             }, {
+     *                 type: "CLASSIFY",
+     *                 name: "name"
+     *             }, {
+     *                 type: "EXTRACT",
+     *                 name: "name"
+     *             }, {
+     *                 type: "EXTRACT",
+     *                 name: "name"
+     *             }, {
+     *                 type: "HUMAN_REVIEW",
+     *                 name: "name"
+     *             }]
+     *     })
      */
     create(request: Extend.WorkflowsCreateRequest, requestOptions?: WorkflowsClient.RequestOptions): core.HttpResponsePromise<Extend.Workflow>;
     private __create;
+    /**
+     * Get details of a workflow, including its draft version and steps.
+     *
+     * @param {string} id - The ID of the workflow.
+     * @param {WorkflowsClient.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.workflows.retrieve("workflow_abc123")
+     */
+    retrieve(id: string, requestOptions?: WorkflowsClient.RequestOptions): core.HttpResponsePromise<Extend.Workflow>;
+    private __retrieve;
+    /**
+     * Update a workflow's draft. You can update the name, the steps, or both.
+     *
+     * When `steps` is provided, the draft version's steps are replaced with the new set. Steps with matching names from the previous draft preserve their internal identity.
+     *
+     * @param {string} id - The ID of the workflow to update.
+     * @param {Extend.WorkflowsUpdateRequest} request
+     * @param {WorkflowsClient.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.workflows.update("workflow_abc123", {
+     *         name: "Updated Invoice Processing"
+     *     })
+     *
+     * @example
+     *     await client.workflows.update("workflow_abc123", {
+     *         steps: [{
+     *                 type: "TRIGGER",
+     *                 name: "name"
+     *             }, {
+     *                 type: "PARSE",
+     *                 name: "name"
+     *             }]
+     *     })
+     */
+    update(id: string, request?: Extend.WorkflowsUpdateRequest, requestOptions?: WorkflowsClient.RequestOptions): core.HttpResponsePromise<Extend.Workflow>;
+    private __update;
 }