@composio/client 0.1.0-alpha.71 → 0.1.0-alpha.73

package/resources/connected-accounts.d.ts

@@ -70,9 +70,15 @@ export declare class ConnectedAccounts extends APIResource {
      */
     delete(nanoid: string, options?: RequestOptions): APIPromise<ConnectedAccountDeleteResponse>;
     /**
-     * Update a connected account. Supports updating the alias and/or credentials. Only
-     * specified fields will be updated. Set a credential field to null to remove it.
-     * Alias must be unique within the same project, entity, and toolkit scope.
+     * Update a connected account. Supports updating alias, credentials, sharing model
+     * (`experimental.account_type`), and per-user ACL
+     * (`experimental.acl_config_for_shared`). Only specified fields are updated. Set a
+     * credential field to null to remove it. Alias must be unique within the same
+     * project, entity, and toolkit scope. Toggling `experimental.account_type` between
+     * PRIVATE and SHARED reuses the stored credentials — no re-auth is required.
+     * Demoting SHARED → PRIVATE atomically clears the stored ACL; supplying
+     * `acl_config_for_shared` in the same call is rejected as
+     * `acl_config_for_shared is only valid on SHARED connections`.
      *
      * @example
      * ```ts
@@ -124,12 +130,6 @@ export interface ConnectedAccountCreateResponse {
      * The id of the connected account
      */
     id: string;
-    /**
-     * The persisted sharing model for this connected account (PRIVATE | SHARED).
-     * Echoes back the value supplied at creation time so callers can confirm what
-     * landed without a follow-up GET.
-     */
-    account_type: 'PRIVATE' | 'SHARED';
     /**
      * The connection data of the connected account
      */
@@ -151,6 +151,11 @@ export interface ConnectedAccountCreateResponse {
      * @deprecated DEPRECATED: This field will be removed in a future version
      */
     status: 'INITIALIZING' | 'INITIATED' | 'ACTIVE' | 'FAILED' | 'EXPIRED' | 'INACTIVE' | 'REVOKED';
+    /**
+     * Experimental features - not stable, may be modified or removed in future
+     * versions.
+     */
+    experimental?: ConnectedAccountCreateResponse.Experimental;
 }
 export declare namespace ConnectedAccountCreateResponse {
     interface UnionMember0 {
@@ -2498,19 +2503,42 @@ export declare namespace ConnectedAccountCreateResponse {
          */
         uuid: string;
     }
+    /**
+     * Experimental features - not stable, may be modified or removed in future
+     * versions.
+     */
+    interface Experimental {
+        /**
+         * Sharing model for this connected account. PRIVATE is usable only by the owning
+         * user_id. SHARED is reachable from a tool-router session only when explicitly
+         * pinned in the session config.
+         */
+        account_type: 'PRIVATE' | 'SHARED';
+        /**
+         * Access control for SHARED connections. Visible only to the connection creator
+         * and project/org API key callers; non-creator cookie callers receive the response
+         * without this block.
+         */
+        acl_config_for_shared?: Experimental.ACLConfigForShared;
+    }
+    namespace Experimental {
+        /**
+         * Access control for SHARED connections. Visible only to the connection creator
+         * and project/org API key callers; non-creator cookie callers receive the response
+         * without this block.
+         */
+        interface ACLConfigForShared {
+            allow_all_users: boolean;
+            allowed_user_ids: Array<string>;
+            not_allowed_user_ids: Array<string>;
+        }
+    }
 }
 export interface ConnectedAccountRetrieveResponse {
     /**
      * The id of the connection
      */
     id: string;
-    /**
-     * Sharing model. PRIVATE accounts are usable only by their owning user_id. SHARED
-     * accounts are reachable from a tool-router session only when explicitly pinned in
-     * the session config (at most one SHARED per toolkit per session); they are never
-     * used implicitly.
-     */
-    account_type: 'PRIVATE' | 'SHARED';
     /**
      * A user-defined alias for the connected account
      */
@@ -2569,16 +2597,15 @@ export interface ConnectedAccountRetrieveResponse {
      * toolkit-prefixed with 1-2 words (e.g., "gmail_red-castle")
      */
     word_id: string | null;
-    /**
-     * Access control for SHARED connections. Resolution rule (only fires when caller
-     * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
-     * user in allowed_user_ids → ALLOW; else DENY.
-     */
-    acl_config_for_shared?: ConnectedAccountRetrieveResponse.ACLConfigForShared;
     /**
      * @deprecated
      */
     deprecated?: ConnectedAccountRetrieveResponse.Deprecated;
+    /**
+     * Experimental features - not stable, may be modified or removed in future
+     * versions.
+     */
+    experimental?: ConnectedAccountRetrieveResponse.Experimental;
     /**
      * The endpoint to make test request for verification
      */
@@ -4955,16 +4982,6 @@ export declare namespace ConnectedAccountRetrieveResponse {
          */
         slug: string;
     }
-    /**
-     * Access control for SHARED connections. Resolution rule (only fires when caller
-     * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
-     * user in allowed_user_ids → ALLOW; else DENY.
-     */
-    interface ACLConfigForShared {
-        allow_all_users: boolean;
-        allowed_user_ids: Array<string>;
-        not_allowed_user_ids: Array<string>;
-    }
     /**
      * @deprecated
      */
@@ -4978,6 +4995,36 @@ export declare namespace ConnectedAccountRetrieveResponse {
          */
         uuid: string;
     }
+    /**
+     * Experimental features - not stable, may be modified or removed in future
+     * versions.
+     */
+    interface Experimental {
+        /**
+         * Sharing model for this connected account. PRIVATE is usable only by the owning
+         * user_id. SHARED is reachable from a tool-router session only when explicitly
+         * pinned in the session config.
+         */
+        account_type: 'PRIVATE' | 'SHARED';
+        /**
+         * Access control for SHARED connections. Visible only to the connection creator
+         * and project/org API key callers; non-creator cookie callers receive the response
+         * without this block.
+         */
+        acl_config_for_shared?: Experimental.ACLConfigForShared;
+    }
+    namespace Experimental {
+        /**
+         * Access control for SHARED connections. Visible only to the connection creator
+         * and project/org API key callers; non-creator cookie callers receive the response
+         * without this block.
+         */
+        interface ACLConfigForShared {
+            allow_all_users: boolean;
+            allowed_user_ids: Array<string>;
+            not_allowed_user_ids: Array<string>;
+        }
+    }
 }
 export interface ConnectedAccountListResponse {
     current_page: number;
@@ -4992,13 +5039,6 @@ export declare namespace ConnectedAccountListResponse {
          * The id of the connection
          */
         id: string;
-        /**
-         * Sharing model. PRIVATE accounts are usable only by their owning user_id. SHARED
-         * accounts are reachable from a tool-router session only when explicitly pinned in
-         * the session config (at most one SHARED per toolkit per session); they are never
-         * used implicitly.
-         */
-        account_type: 'PRIVATE' | 'SHARED';
         /**
          * A user-defined alias for the connected account
          */
@@ -5050,16 +5090,15 @@ export declare namespace ConnectedAccountListResponse {
          * toolkit-prefixed with 1-2 words (e.g., "gmail_red-castle")
          */
         word_id: string | null;
-        /**
-         * Access control for SHARED connections. Resolution rule (only fires when caller
-         * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
-         * user in allowed_user_ids → ALLOW; else DENY.
-         */
-        acl_config_for_shared?: Item.ACLConfigForShared;
         /**
          * @deprecated
          */
         deprecated?: Item.Deprecated;
+        /**
+         * Experimental features - not stable, may be modified or removed in future
+         * versions.
+         */
+        experimental?: Item.Experimental;
         /**
          * The endpoint to make test request for verification
          */
@@ -7436,16 +7475,6 @@ export declare namespace ConnectedAccountListResponse {
              */
             slug: string;
         }
-        /**
-         * Access control for SHARED connections. Resolution rule (only fires when caller
-         * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
-         * user in allowed_user_ids → ALLOW; else DENY.
-         */
-        interface ACLConfigForShared {
-            allow_all_users: boolean;
-            allowed_user_ids: Array<string>;
-            not_allowed_user_ids: Array<string>;
-        }
         /**
          * @deprecated
          */
@@ -7459,6 +7488,36 @@ export declare namespace ConnectedAccountListResponse {
              */
             uuid: string;
         }
+        /**
+         * Experimental features - not stable, may be modified or removed in future
+         * versions.
+         */
+        interface Experimental {
+            /**
+             * Sharing model for this connected account. PRIVATE is usable only by the owning
+             * user_id. SHARED is reachable from a tool-router session only when explicitly
+             * pinned in the session config.
+             */
+            account_type: 'PRIVATE' | 'SHARED';
+            /**
+             * Access control for SHARED connections. Visible only to the connection creator
+             * and project/org API key callers; non-creator cookie callers receive the response
+             * without this block.
+             */
+            acl_config_for_shared?: Experimental.ACLConfigForShared;
+        }
+        namespace Experimental {
+            /**
+             * Access control for SHARED connections. Visible only to the connection creator
+             * and project/org API key callers; non-creator cookie callers receive the response
+             * without this block.
+             */
+            interface ACLConfigForShared {
+                allow_all_users: boolean;
+                allowed_user_ids: Array<string>;
+                not_allowed_user_ids: Array<string>;
+            }
+        }
     }
 }
 /**
@@ -7529,20 +7588,6 @@ export declare namespace ConnectedAccountCreateParams {
         id: string;
     }
     interface Connection {
-        /**
-         * Sharing model for this connected account. PRIVATE (default) is usable only by
-         * the owning user_id. SHARED is reachable from a tool-router session ONLY when
-         * explicitly pinned in the session config — at most one SHARED connection per
-         * toolkit per session. Sessions never use a SHARED connection implicitly.
-         */
-        account_type?: 'PRIVATE' | 'SHARED';
-        /**
-         * Access control for SHARED connections. Resolution rule (only fires when caller
-         * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
-         * user in allowed_user_ids → ALLOW; else DENY. Default state (omitted or {}) is
-         * deny-by-default — only the creator can use.
-         */
-        acl_config_for_shared?: Connection.ACLConfigForShared;
         /**
          * A human-readable alias for this connected account. Must be unique per entity and
          * toolkit within the project.
@@ -7563,6 +7608,11 @@ export declare namespace ConnectedAccountCreateParams {
          * @deprecated DEPRECATED: This parameter will be removed in a future version.
          */
         deprecated_is_v1_rerouted?: boolean;
+        /**
+         * Experimental features - not stable, may be modified or removed in future
+         * versions.
+         */
+        experimental?: Connection.Experimental;
         /**
          * @deprecated DEPRECATED: This parameter will be removed in a future version.
          * Please use callback_url instead.
@@ -7579,25 +7629,47 @@ export declare namespace ConnectedAccountCreateParams {
     }
     namespace Connection {
         /**
-         * Access control for SHARED connections. Resolution rule (only fires when caller
-         * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
-         * user in allowed_user_ids → ALLOW; else DENY. Default state (omitted or {}) is
-         * deny-by-default — only the creator can use.
+         * Experimental features - not stable, may be modified or removed in future
+         * versions.
          */
-        interface ACLConfigForShared {
+        interface Experimental {
             /**
-             * Wildcard "any user_id in the project" allow toggle. Only valid on SHARED
-             * connections.
+             * Sharing model for this connected account. PRIVATE (default) is usable only by
+             * the owning user_id. SHARED is reachable from a tool-router session ONLY when
+             * explicitly pinned in the session config — at most one SHARED connection per
+             * toolkit per session. Sessions never use a SHARED connection implicitly.
              */
-            allow_all_users?: boolean;
+            account_type?: 'PRIVATE' | 'SHARED';
             /**
-             * Explicit allow list of user_ids who can use this SHARED connection.
+             * Access control for SHARED connections. Resolution rule (only fires when caller
+             * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
+             * user in allowed_user_ids → ALLOW; else DENY. Default state (omitted or {}) is
+             * deny-by-default — only the creator can use.
              */
-            allowed_user_ids?: Array<string>;
+            acl_config_for_shared?: Experimental.ACLConfigForShared;
+        }
+        namespace Experimental {
             /**
-             * Explicit deny list. Wins on conflict with allow_all_users and allowed_user_ids.
+             * Access control for SHARED connections. Resolution rule (only fires when caller
+             * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
+             * user in allowed_user_ids → ALLOW; else DENY. Default state (omitted or {}) is
+             * deny-by-default — only the creator can use.
              */
-            not_allowed_user_ids?: Array<string>;
+            interface ACLConfigForShared {
+                /**
+                 * Wildcard "any user_id in the project" allow toggle. Only valid on SHARED
+                 * connections.
+                 */
+                allow_all_users?: boolean;
+                /**
+                 * Explicit allow list of user_ids who can use this SHARED connection.
+                 */
+                allowed_user_ids?: Array<string>;
+                /**
+                 * Explicit deny list. Wins on conflict with allow_all_users and allowed_user_ids.
+                 */
+                not_allowed_user_ids?: Array<string>;
+            }
         }
         interface UnionMember0 {
             authScheme: 'OAUTH1';
@@ -9934,9 +10006,9 @@ export declare namespace ConnectedAccountCreateParams {
 }
 export interface ConnectedAccountListParams {
     /**
-     * Filter by sharing model. Default (omitted) returns PRIVATE only — shared
-     * accounts must be requested explicitly. Pass SHARED for only shared accounts, or
-     * ALL for PRIVATE + SHARED.
+     * [Experimental] Filter by sharing model. Default (omitted) returns PRIVATE only —
+     * shared accounts must be requested explicitly. Pass SHARED for only shared
+     * accounts, or ALL for PRIVATE + SHARED.
      */
     account_type?: 'PRIVATE' | 'SHARED' | 'ALL';
     /**
@@ -9977,42 +10049,19 @@ export interface ConnectedAccountListParams {
     user_ids?: Array<string> | null;
 }
 export interface ConnectedAccountPatchParams {
-    /**
-     * Access control for SHARED connections. Resolution rule (only fires when caller
-     * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
-     * user in allowed_user_ids → ALLOW; else DENY. Default state (omitted or {}) is
-     * deny-by-default — only the creator can use.
-     */
-    acl_config_for_shared?: ConnectedAccountPatchParams.ACLConfigForShared;
     /**
      * A human-readable alias for this connected account. Pass an empty string to clear
      * the alias. Must be unique per entity and toolkit within the project.
      */
     alias?: string;
     connection?: ConnectedAccountPatchParams.Connection;
-}
-export declare namespace ConnectedAccountPatchParams {
     /**
-     * Access control for SHARED connections. Resolution rule (only fires when caller
-     * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
-     * user in allowed_user_ids → ALLOW; else DENY. Default state (omitted or {}) is
-     * deny-by-default — only the creator can use.
+     * Experimental features - not stable, may be modified or removed in future
+     * versions.
      */
-    interface ACLConfigForShared {
-        /**
-         * Wildcard "any user_id in the project" allow toggle. Only valid on SHARED
-         * connections.
-         */
-        allow_all_users?: boolean;
-        /**
-         * Explicit allow list of user_ids who can use this SHARED connection.
-         */
-        allowed_user_ids?: Array<string>;
-        /**
-         * Explicit deny list. Wins on conflict with allow_all_users and allowed_user_ids.
-         */
-        not_allowed_user_ids?: Array<string>;
-    }
+    experimental?: ConnectedAccountPatchParams.Experimental;
+}
+export declare namespace ConnectedAccountPatchParams {
     interface Connection {
         state: Connection.State;
     }
@@ -10072,6 +10121,48 @@ export declare namespace ConnectedAccountPatchParams {
             }
         }
     }
+    /**
+     * Experimental features - not stable, may be modified or removed in future
+     * versions.
+     */
+    interface Experimental {
+        /**
+         * Mutate the sharing model. PRIVATE → SHARED promotes the existing connection
+         * without re-auth; SHARED → PRIVATE revokes all non-creator access and clears the
+         * stored ACL atomically. Omit to leave unchanged.
+         */
+        account_type?: 'PRIVATE' | 'SHARED';
+        /**
+         * Access control for SHARED connections. Resolution rule (only fires when caller
+         * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
+         * user in allowed_user_ids → ALLOW; else DENY. Default state (omitted or {}) is
+         * deny-by-default — only the creator can use.
+         */
+        acl_config_for_shared?: Experimental.ACLConfigForShared;
+    }
+    namespace Experimental {
+        /**
+         * Access control for SHARED connections. Resolution rule (only fires when caller
+         * != creator): user in not_allowed_user_ids → DENY; allow_all_users=true → ALLOW;
+         * user in allowed_user_ids → ALLOW; else DENY. Default state (omitted or {}) is
+         * deny-by-default — only the creator can use.
+         */
+        interface ACLConfigForShared {
+            /**
+             * Wildcard "any user_id in the project" allow toggle. Only valid on SHARED
+             * connections.
+             */
+            allow_all_users?: boolean;
+            /**
+             * Explicit allow list of user_ids who can use this SHARED connection.
+             */
+            allowed_user_ids?: Array<string>;
+            /**
+             * Explicit deny list. Wins on conflict with allow_all_users and allowed_user_ids.
+             */
+            not_allowed_user_ids?: Array<string>;
+        }
+    }
 }
 export interface ConnectedAccountRefreshParams {
     /**