@workos/openapi-spec 0.115.0 → 0.117.0

package/dist/types.d.ts

@@ -18179,6 +18179,19 @@ export interface components {
              */
             url: string;
         };
+        AuthMethodMismatchError: {
+            /**
+             * @description Error code indicating the endpoint does not match the installation auth method.
+             * @example auth_method_mismatch
+             * @constant
+             */
+            code: "auth_method_mismatch";
+            /**
+             * @description A human-readable explanation of the mismatch.
+             * @example This installation uses oauth authentication. Use the POST /:slug/token endpoint instead.
+             */
+            message: string;
+        };
         DataIntegrationAccessTokenResponse: {
             /**
              * @description Indicates whether the access token is valid and ready for use, or if reauthorization is required.
@@ -18243,19 +18256,6 @@ export interface components {
              */
             message: string;
         };
-        AuthMethodMismatchError: {
-            /**
-             * @description Error code indicating the endpoint does not match the installation auth method.
-             * @example auth_method_mismatch
-             * @constant
-             */
-            code: "auth_method_mismatch";
-            /**
-             * @description A human-readable explanation of the mismatch.
-             * @example This installation uses oauth authentication. Use the POST /:slug/token endpoint instead.
-             */
-            message: string;
-        };
         DataIntegrationVendedCredential: {
             /**
              * @description Distinguishes the credential object.
@@ -18469,7 +18469,7 @@ export interface components {
              */
             client_secret_last_4?: string | null;
             /**
-             * @description The connection-level configuration values stored for this connection — the fields the provider declares at `installation` scope, excluding any it declares as secret. Only present when `auth_method` is `client_credentials`.
+             * @description The connection-level configuration values stored for this connection — the fields the provider declares at `installation` scope, excluding secret and undeclared fields. Returned for every authentication method; empty when no stored values can be disclosed.
              * @example {
              *       "instance_url": "https://example.my.salesforce.com"
              *     }
@@ -18665,7 +18665,7 @@ export interface components {
                      */
                     client_secret_last_4?: string | null;
                     /**
-                     * @description The connection-level configuration values stored for this connection — the fields the provider declares at `installation` scope, excluding any it declares as secret. Only present when `auth_method` is `client_credentials`.
+                     * @description The connection-level configuration values stored for this connection — the fields the provider declares at `installation` scope, excluding secret and undeclared fields. Returned for every authentication method; empty when no stored values can be disclosed.
                      * @example {
                      *       "instance_url": "https://example.my.salesforce.com"
                      *     }
@@ -18781,7 +18781,7 @@ export interface components {
                      */
                     client_secret_last_4?: string | null;
                     /**
-                     * @description The connection-level configuration values stored for this connection — the fields the provider declares at `installation` scope, excluding any it declares as secret. Only present when `auth_method` is `client_credentials`.
+                     * @description The connection-level configuration values stored for this connection — the fields the provider declares at `installation` scope, excluding secret and undeclared fields. Returned for every authentication method; empty when no stored values can be disclosed.
                      * @example {
                      *       "instance_url": "https://example.my.salesforce.com"
                      *     }
@@ -29904,13 +29904,25 @@ export interface operations {
                     };
                 };
             };
-            /** @description The data integration or selected connected account was not found. */
+            /** @description The data integration or selected connected account was not found (`entity_not_found`). */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
+                        /**
+                         * @description The error code identifying the type of error.
+                         * @example entity_not_found
+                         * @constant
+                         */
+                        code: "entity_not_found";
+                        /**
+                         * @description A human-readable description of the error.
+                         * @example Request could not be processed.
+                         */
+                        message: string;
+                    } | {
                         /**
                          * @description A human-readable description of the error.
                          * @example Organization not found: 'org_01EHQMYV6MBK39QC5PZXHY59C3'.
@@ -30140,6 +30152,87 @@ export interface operations {
                     config?: {
                         [key: string]: string;
                     };
+                } | {
+                    /**
+                     * @description The ID of the user to authorize. When `connection_owner` is `organization`, this is the user authorizing on behalf of the organization; they must be an active member of the organization and do not become the owner of the resulting connected account.
+                     * @example user_01EHZNVPK3SFK441A1RGBFSHRT
+                     */
+                    user_id: string;
+                    /**
+                     * @description An organization ID to scope the authorization to a specific organization. Required when `connection_owner` is `organization`.
+                     * @example org_01EHZNVPK3SFK441A1RGBFSHRT
+                     */
+                    organization_id?: string;
+                    /**
+                     * @description Who will own the connected account. `user` (the default) connects the user's own account. `organization` connects the organization's shared account and requires `organization_id`.
+                     * @example user
+                     * @enum {string}
+                     */
+                    connection_owner?: "user" | "organization";
+                    /**
+                     * Format: uri
+                     * @description The URL to redirect the user to after authorization.
+                     * @example https://example.com/callback
+                     */
+                    return_to?: string;
+                    /**
+                     * @description Connect-time config values for the provider-declared `installation`-scope fields (e.g. a Zendesk `subdomain`), keyed by the config field. Only fields the provider declares may be supplied, and required fields must be provided unless already pinned on the integration.
+                     * @example {
+                     *       "subdomain": "acme"
+                     *     }
+                     */
+                    config?: {
+                        [key: string]: string;
+                    };
+                    /**
+                     * @description Create another connection. The first connection for an owner shape fills the compatibility slot; later connections are standard. Creating an additional connection is not yet available: until it is, `add` succeeds only when the owner has no connection for this integration and otherwise returns 404 `multiple_connections_unavailable`. Omit `connection_intent` to use the compatibility connection, or send `reauthorize` with `connected_account_id` to reauthorize one exact connection.
+                     * @example add
+                     * @constant
+                     */
+                    connection_intent: "add";
+                } | {
+                    /**
+                     * @description The ID of the user to authorize. When `connection_owner` is `organization`, this is the user authorizing on behalf of the organization; they must be an active member of the organization and do not become the owner of the resulting connected account.
+                     * @example user_01EHZNVPK3SFK441A1RGBFSHRT
+                     */
+                    user_id: string;
+                    /**
+                     * @description An organization ID to scope the authorization to a specific organization. Required when `connection_owner` is `organization`.
+                     * @example org_01EHZNVPK3SFK441A1RGBFSHRT
+                     */
+                    organization_id?: string;
+                    /**
+                     * @description Who will own the connected account. `user` (the default) connects the user's own account. `organization` connects the organization's shared account and requires `organization_id`.
+                     * @example user
+                     * @enum {string}
+                     */
+                    connection_owner?: "user" | "organization";
+                    /**
+                     * Format: uri
+                     * @description The URL to redirect the user to after authorization.
+                     * @example https://example.com/callback
+                     */
+                    return_to?: string;
+                    /**
+                     * @description Connect-time config values for the provider-declared `installation`-scope fields (e.g. a Zendesk `subdomain`), keyed by the config field. Only fields the provider declares may be supplied, and required fields must be provided unless already pinned on the integration.
+                     * @example {
+                     *       "subdomain": "acme"
+                     *     }
+                     */
+                    config?: {
+                        [key: string]: string;
+                    };
+                    /**
+                     * @description Reauthorize exactly the connection named by `connected_account_id`.
+                     * @example reauthorize
+                     * @constant
+                     */
+                    connection_intent: "reauthorize";
+                    /**
+                     * @description The exact connected account to reauthorize. Required with `connection_intent: reauthorize`.
+                     * @example data_installation_01EHZNVPK3SFK441A1RGBFSHRT
+                     */
+                    connected_account_id: string;
                 };
             };
         };
@@ -30190,13 +30283,25 @@ export interface operations {
                     };
                 };
             };
-            /** @description Not Found */
+            /** @description The integration or user was not found (`entity_not_found`); `connected_account_not_found` when `connected_account_id` does not name a connection for this owner and integration; or `multiple_connections_unavailable` when `connection_intent: add` would create an additional connection before that capability is available. */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
+                        /**
+                         * @description The error code identifying the type of error.
+                         * @example multiple_connections_unavailable
+                         * @enum {string}
+                         */
+                        code: "multiple_connections_unavailable" | "connected_account_not_found" | "entity_not_found";
+                        /**
+                         * @description A human-readable description of the error.
+                         * @example Request could not be processed.
+                         */
+                        message: string;
+                    } | {
                         /**
                          * @description A human-readable description of the error.
                          * @example Organization not found: 'org_01EHQMYV6MBK39QC5PZXHY59C3'.
@@ -30205,6 +30310,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description The selected connected account does not use OAuth authentication. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AuthMethodMismatchError"];
+                };
+            };
         };
     };
     DataIntegrationsController_upsertClientCredentials: {
@@ -30409,13 +30523,25 @@ export interface operations {
                     };
                 };
             };
-            /** @description The data integration or selected connected account was not found. */
+            /** @description The data integration or selected connected account was not found (`entity_not_found`). */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
+                        /**
+                         * @description The error code identifying the type of error.
+                         * @example entity_not_found
+                         * @constant
+                         */
+                        code: "entity_not_found";
+                        /**
+                         * @description A human-readable description of the error.
+                         * @example Request could not be processed.
+                         */
+                        message: string;
+                    } | {
                         /**
                          * @description A human-readable description of the error.
                          * @example Organization not found: 'org_01EHQMYV6MBK39QC5PZXHY59C3'.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workos/openapi-spec",
-  "version": "0.115.0",
+  "version": "0.117.0",
   "type": "module",
   "description": "WorkOS OpenAPI specification, TypeScript types, and SDK resolution policy",
   "license": "MIT",