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

package/src/resources/connected-accounts.ts

@@ -79,7 +79,8 @@ export class ConnectedAccounts extends APIResource {
   /**
    * Soft-deletes a connected account by marking it as deleted in the database. This
    * prevents the account from being used for API calls but preserves the record for
-   * audit purposes.
+   * audit purposes. Pass `?revoke_on_delete=true` to also revoke the account's
+   * upstream credentials via a background job.
    *
    * @example
    * ```ts
@@ -87,20 +88,22 @@ export class ConnectedAccounts extends APIResource {
    *   await client.connectedAccounts.delete('ca_1a2b3c4d5e6f');
    * ```
    */
-  delete(nanoid: string, options?: RequestOptions): APIPromise<ConnectedAccountDeleteResponse> {
-    return this._client.delete(path`/api/v3.1/connected_accounts/${nanoid}`, options);
+  delete(
+    nanoid: string,
+    params: ConnectedAccountDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConnectedAccountDeleteResponse> {
+    const { revoke_on_delete } = params ?? {};
+    return this._client.delete(path`/api/v3.1/connected_accounts/${nanoid}`, {
+      query: { revoke_on_delete },
+      ...options,
+    });
   }
 
   /**
-   * 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`.
+   * 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.
    *
    * @example
    * ```ts
@@ -198,12 +201,6 @@ export interface ConnectedAccountCreateResponse {
     | ConnectedAccountCreateResponse.UnionMember12
     | ConnectedAccountCreateResponse.UnionMember13;
 
-  /**
-   * @deprecated DEPRECATED: This field will be removed in a future version. Please
-   * use id and auth_config.id instead.
-   */
-  deprecated: ConnectedAccountCreateResponse.Deprecated;
-
   /**
    * @deprecated DEPRECATED: This field will be removed in a future version
    */
@@ -219,6 +216,12 @@ export interface ConnectedAccountCreateResponse {
    */
   status: 'INITIALIZING' | 'INITIATED' | 'ACTIVE' | 'FAILED' | 'EXPIRED' | 'INACTIVE' | 'REVOKED';
 
+  /**
+   * @deprecated DEPRECATED: This field will be removed in a future version. Please
+   * use id and auth_config.id instead.
+   */
+  deprecated?: ConnectedAccountCreateResponse.Deprecated;
+
   /**
    * Experimental features - not stable, may be modified or removed in future
    * versions.
@@ -4402,10 +4405,6 @@ export namespace ConnectedAccountCreateResponse {
     export interface UnionMember2 {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       status: 'ACTIVE';
 
       account_id?: string;
@@ -4418,6 +4417,10 @@ export namespace ConnectedAccountCreateResponse {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;
@@ -4466,10 +4469,6 @@ export namespace ConnectedAccountCreateResponse {
     export interface UnionMember3 {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       status: 'INACTIVE';
 
       account_id?: string;
@@ -4482,6 +4481,10 @@ export namespace ConnectedAccountCreateResponse {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;
@@ -4784,6 +4787,19 @@ export interface ConnectedAccountRetrieveResponse {
    */
   experimental?: ConnectedAccountRetrieveResponse.Experimental;
 
+  /**
+   * OAuth scopes requested when this connection was most recently initiated (create
+   * or refresh). Absent for connections created before scope snapshots were captured
+   * and for non-OAuth auth schemes.
+   */
+  requested_scopes?: Array<string>;
+
+  /**
+   * OAuth user-token scopes requested at the most recent initiation. Only meaningful
+   * for Slackbot auth configs (user-token scopes); absent otherwise.
+   */
+  requested_user_scopes?: Array<string>;
+
   /**
    * The endpoint to make test request for verification
    */
@@ -9019,10 +9035,6 @@ export namespace ConnectedAccountRetrieveResponse {
     export interface UnionMember2 {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       status: 'ACTIVE';
 
       account_id?: string;
@@ -9035,6 +9047,10 @@ export namespace ConnectedAccountRetrieveResponse {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;
@@ -9083,10 +9099,6 @@ export namespace ConnectedAccountRetrieveResponse {
     export interface UnionMember3 {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       status: 'INACTIVE';
 
       account_id?: string;
@@ -9099,6 +9111,10 @@ export namespace ConnectedAccountRetrieveResponse {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;
@@ -13649,10 +13665,6 @@ export namespace ConnectedAccountListResponse {
       export interface UnionMember2 {
         access_token: string;
 
-        client_id: string;
-
-        client_secret: string;
-
         status: 'ACTIVE';
 
         account_id?: string;
@@ -13665,6 +13677,10 @@ export namespace ConnectedAccountListResponse {
 
         borneo_dashboard_url?: string;
 
+        client_id?: string;
+
+        client_secret?: string;
+
         COMPANYDOMAIN?: string;
 
         dc?: string;
@@ -13713,10 +13729,6 @@ export namespace ConnectedAccountListResponse {
       export interface UnionMember3 {
         access_token: string;
 
-        client_id: string;
-
-        client_secret: string;
-
         status: 'INACTIVE';
 
         account_id?: string;
@@ -13729,6 +13741,10 @@ export namespace ConnectedAccountListResponse {
 
         borneo_dashboard_url?: string;
 
+        client_id?: string;
+
+        client_secret?: string;
+
         COMPANYDOMAIN?: string;
 
         dc?: string;
@@ -13948,6 +13964,14 @@ export interface ConnectedAccountDeleteResponse {
    * Indicates whether the connected account was successfully deleted
    */
   success: boolean;
+
+  /**
+   * Identifier of the background revoke job started for this delete. Present only
+   * when `revoke_on_delete=true`. Track the job and its per-connection results from
+   * the Composio dashboard — a programmatic endpoint to poll this job is not yet
+   * generally available.
+   */
+  revoke_job_id?: string;
 }
 
 export interface ConnectedAccountPatchResponse {
@@ -18303,10 +18327,6 @@ export namespace ConnectedAccountCreateParams {
       export interface UnionMember2 {
         access_token: string;
 
-        client_id: string;
-
-        client_secret: string;
-
         status: 'ACTIVE';
 
         account_id?: string;
@@ -18319,6 +18339,10 @@ export namespace ConnectedAccountCreateParams {
 
         borneo_dashboard_url?: string;
 
+        client_id?: string;
+
+        client_secret?: string;
+
         COMPANYDOMAIN?: string;
 
         dc?: string;
@@ -18367,10 +18391,6 @@ export namespace ConnectedAccountCreateParams {
       export interface UnionMember3 {
         access_token: string;
 
-        client_id: string;
-
-        client_secret: string;
-
         status: 'INACTIVE';
 
         account_id?: string;
@@ -18383,6 +18403,10 @@ export namespace ConnectedAccountCreateParams {
 
         borneo_dashboard_url?: string;
 
+        client_id?: string;
+
+        client_secret?: string;
+
         COMPANYDOMAIN?: string;
 
         dc?: string;
@@ -18593,6 +18617,16 @@ export interface ConnectedAccountListParams {
   user_ids?: Array<string> | null;
 }
 
+export interface ConnectedAccountDeleteParams {
+  /**
+   * When `true`, the delete also starts a background job that revokes the upstream
+   * credentials of every connected account in scope, and the response carries a
+   * `revoke_job_id`. Defaults to `false`. Revocation is irreversible — recovering a
+   * deleted entity does not restore working credentials.
+   */
+  revoke_on_delete?: boolean | null;
+}
+
 export interface ConnectedAccountPatchParams {
   /**
    * A human-readable alias for this connected account. Pass an empty string to clear
@@ -18643,71 +18677,35 @@ export namespace ConnectedAccountPatchParams {
       export interface Val {
         token?: string | null;
 
-        account_id?: string | null;
-
-        account_url?: string | null;
-
         api_key?: string | null;
 
-        api_url?: string | null;
+        api_key_prefix?: string | null;
 
         application_id?: string | null;
 
-        base_url?: string | null;
-
         basic_encoded?: string | null;
 
         bearer_token?: string | null;
 
-        borneo_dashboard_url?: string | null;
-
-        COMPANYDOMAIN?: string | null;
-
         credentials_json?: string | null;
 
-        dc?: string | null;
-
-        domain?: string | null;
+        generic_api_key?: string | null;
 
-        extension?: string | null;
+        generic_id?: string | null;
 
-        form_api_base_url?: string | null;
+        generic_secret?: string | null;
 
-        generic_api_key?: string | null;
+        generic_token?: string | null;
 
         installation_id?: string | null;
 
-        instanceEndpoint?: string | null;
-
-        instanceName?: string | null;
-
         password?: string | null;
 
         private_key?: string | null;
 
-        proxy_password?: string | null;
-
-        proxy_username?: string | null;
-
-        region?: string | null;
-
-        server_location?: string | null;
-
-        shop?: string | null;
-
-        site_name?: string | null;
-
-        subdomain?: string | null;
+        user_agent?: string | null;
 
         username?: string | null;
-
-        version?: string | null;
-
-        your_server?: string | null;
-
-        'your-domain'?: string | null;
-
-        [k: string]: unknown;
       }
     }
   }
@@ -18717,13 +18715,6 @@ export namespace ConnectedAccountPatchParams {
    * versions.
    */
   export 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;
@@ -18796,6 +18787,7 @@ export declare namespace ConnectedAccounts {
     type ConnectedAccountUpdateStatusResponse as ConnectedAccountUpdateStatusResponse,
     type ConnectedAccountCreateParams as ConnectedAccountCreateParams,
     type ConnectedAccountListParams as ConnectedAccountListParams,
+    type ConnectedAccountDeleteParams as ConnectedAccountDeleteParams,
     type ConnectedAccountPatchParams as ConnectedAccountPatchParams,
     type ConnectedAccountRefreshParams as ConnectedAccountRefreshParams,
     type ConnectedAccountUpdateStatusParams as ConnectedAccountUpdateStatusParams,

package/src/resources/files.ts

@@ -9,13 +9,12 @@ import { RequestOptions } from '../internal/request-options';
  */
 export class Files extends APIResource {
   /**
+   * DEPRECATED: This endpoint is deprecated and will be removed in a future release.
    * Retrieves a list of files associated with the authenticated project. Results can
-   * be filtered by toolkit and tool slugs.
+   * be filtered by toolkit and tool slugs. Responses carry a `Deprecation` header
+   * (RFC 9745) for client-side detection.
    *
-   * @example
-   * ```ts
-   * const files = await client.files.list();
-   * ```
+   * @deprecated
    */
   list(
     query: FileListParams | null | undefined = {},

package/src/resources/index.ts

@@ -11,6 +11,7 @@ export {
   type AuthConfigCreateParams,
   type AuthConfigUpdateParams,
   type AuthConfigListParams,
+  type AuthConfigDeleteParams,
   type AuthConfigUpdateStatusParams,
 } from './auth-configs';
 export {
@@ -31,6 +32,7 @@ export {
   type ConnectedAccountUpdateStatusResponse,
   type ConnectedAccountCreateParams,
   type ConnectedAccountListParams,
+  type ConnectedAccountDeleteParams,
   type ConnectedAccountPatchParams,
   type ConnectedAccountRefreshParams,
   type ConnectedAccountUpdateStatusParams,
@@ -57,17 +59,9 @@ export {
   type McpListParams,
   type McpRetrieveAppParams,
 } from './mcp/mcp';
-export {
-  Migration,
-  type MigrationRetrieveNanoidResponse,
-  type MigrationRetrieveNanoidParams,
-} from './migration';
+export { Migration } from './migration';
 export { Project } from './project/project';
-export {
-  ToolRouter,
-  type ToolRouterCreateSessionResponse,
-  type ToolRouterCreateSessionParams,
-} from './tool-router/tool-router';
+export { ToolRouter } from './tool-router/tool-router';
 export {
   Toolkits,
   type ToolkitRetrieveResponse,

package/src/resources/link.ts

@@ -4039,10 +4039,6 @@ export namespace LinkCreateParams {
   export interface UnionMember71 {
     access_token: string;
 
-    client_id: string;
-
-    client_secret: string;
-
     account_id?: string;
 
     account_url?: string;
@@ -4053,6 +4049,10 @@ export namespace LinkCreateParams {
 
     borneo_dashboard_url?: string;
 
+    client_id?: string;
+
+    client_secret?: string;
+
     COMPANYDOMAIN?: string;
 
     dc?: string;
@@ -4101,10 +4101,6 @@ export namespace LinkCreateParams {
   export interface UnionMember72 {
     access_token: string;
 
-    client_id: string;
-
-    client_secret: string;
-
     account_id?: string;
 
     account_url?: string;
@@ -4115,6 +4111,10 @@ export namespace LinkCreateParams {
 
     borneo_dashboard_url?: string;
 
+    client_id?: string;
+
+    client_secret?: string;
+
     COMPANYDOMAIN?: string;
 
     dc?: string;

package/src/resources/migration.ts

@@ -1,49 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import { APIPromise } from '../core/api-promise';
-import { RequestOptions } from '../internal/request-options';
 
-/**
- * Endpoints to help with migration from v1 to v3
- */
-export class Migration extends APIResource {
-  /**
-   * Convert a legacy UUID to its corresponding NanoId for migration purposes. This
-   * endpoint facilitates the transition from UUID-based identifiers to the more
-   * compact NanoId format used in the v3 API.
-   */
-  retrieveNanoid(
-    query: MigrationRetrieveNanoidParams,
-    options?: RequestOptions,
-  ): APIPromise<MigrationRetrieveNanoidResponse> {
-    return this._client.get('/api/v3.1/migration/get-nanoid', { query, ...options });
-  }
-}
-
-export interface MigrationRetrieveNanoidResponse {
-  /**
-   * The NanoId corresponding to the provided UUID. This is the new identifier that
-   * should be used in place of the legacy UUID.
-   */
-  nanoid: string;
-}
-
-export interface MigrationRetrieveNanoidParams {
-  /**
-   * The type of resource that the UUID belongs to
-   */
-  type: 'CONNECTED_ACCOUNT' | 'AUTH_CONFIG' | 'TRIGGER_INSTANCE';
-
-  /**
-   * The legacy UUID that needs to be converted to a NanoId
-   */
-  uuid: string;
-}
-
-export declare namespace Migration {
-  export {
-    type MigrationRetrieveNanoidResponse as MigrationRetrieveNanoidResponse,
-    type MigrationRetrieveNanoidParams as MigrationRetrieveNanoidParams,
-  };
-}
+export class Migration extends APIResource {}

package/src/resources/project/config.ts

@@ -1,110 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import { APIPromise } from '../../core/api-promise';
-import { RequestOptions } from '../../internal/request-options';
 
-export class Config extends APIResource {
-  /**
-   * Retrieves the current project configuration including 2FA settings.
-   *
-   * @example
-   * ```ts
-   * const config = await client.project.config.retrieve();
-   * ```
-   */
-  retrieve(options?: RequestOptions): APIPromise<ConfigRetrieveResponse> {
-    return this._client.get('/api/v3.1/org/project/config', options);
-  }
-
-  /**
-   * Updates the project configuration settings.
-   *
-   * @example
-   * ```ts
-   * const config = await client.project.config.update({
-   *   is_2FA_enabled: true,
-   * });
-   * ```
-   */
-  update(
-    body: ConfigUpdateParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ConfigUpdateResponse> {
-    return this._client.patch('/api/v3.1/org/project/config', { body, ...options });
-  }
-}
-
-export interface ConfigRetrieveResponse {
-  is_2FA_enabled: boolean;
-
-  log_visibility_setting: 'show_all' | 'dont_store_data';
-
-  mask_secret_keys_in_connected_account: boolean;
-
-  display_name?: string;
-
-  /**
-   * Whether to enable composio link for managed authentication. This key will be
-   * deprecated in the future. Please don't use this key.
-   */
-  is_composio_link_enabled_for_managed_auth?: boolean;
-
-  logo_url?: string;
-
-  require_mcp_api_key?: boolean;
-
-  signed_url_file_expiry_in_seconds?: number;
-}
-
-export interface ConfigUpdateResponse {
-  is_2FA_enabled: boolean;
-
-  log_visibility_setting: 'show_all' | 'dont_store_data';
-
-  mask_secret_keys_in_connected_account: boolean;
-
-  display_name?: string;
-
-  /**
-   * Whether to enable composio link for managed authentication. This key will be
-   * deprecated in the future. Please don't use this key.
-   */
-  is_composio_link_enabled_for_managed_auth?: boolean;
-
-  logo_url?: string;
-
-  require_mcp_api_key?: boolean;
-
-  signed_url_file_expiry_in_seconds?: number;
-}
-
-export interface ConfigUpdateParams {
-  display_name?: string;
-
-  is_2FA_enabled?: boolean;
-
-  /**
-   * Whether to enable composio link for managed authentication. This key will be
-   * deprecated in the future. Please don't use this key.
-   */
-  is_composio_link_enabled_for_managed_auth?: boolean;
-
-  log_visibility_setting?: 'show_all' | 'dont_store_data';
-
-  logo_url?: string;
-
-  mask_secret_keys_in_connected_account?: boolean;
-
-  require_mcp_api_key?: boolean;
-
-  signed_url_file_expiry_in_seconds?: number;
-}
-
-export declare namespace Config {
-  export {
-    type ConfigRetrieveResponse as ConfigRetrieveResponse,
-    type ConfigUpdateResponse as ConfigUpdateResponse,
-    type ConfigUpdateParams as ConfigUpdateParams,
-  };
-}
+export class Config extends APIResource {}

package/src/resources/project/index.ts

@@ -1,9 +1,4 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export {
-  Config,
-  type ConfigRetrieveResponse,
-  type ConfigUpdateResponse,
-  type ConfigUpdateParams,
-} from './config';
+export { Config } from './config';
 export { Project } from './project';

package/src/resources/project/project.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as ConfigAPI from './config';
-import { Config, ConfigRetrieveResponse, ConfigUpdateParams, ConfigUpdateResponse } from './config';
+import { Config } from './config';
 
 export class Project extends APIResource {
   config: ConfigAPI.Config = new ConfigAPI.Config(this._client);
@@ -11,10 +11,5 @@ export class Project extends APIResource {
 Project.Config = Config;
 
 export declare namespace Project {
-  export {
-    Config as Config,
-    type ConfigRetrieveResponse as ConfigRetrieveResponse,
-    type ConfigUpdateResponse as ConfigUpdateResponse,
-    type ConfigUpdateParams as ConfigUpdateParams,
-  };
+  export { Config as Config };
 }

package/src/resources/tool-router/index.ts

@@ -26,8 +26,4 @@ export {
   type SessionToolkitsParams,
   type SessionToolsParams,
 } from './session/index';
-export {
-  ToolRouter,
-  type ToolRouterCreateSessionResponse,
-  type ToolRouterCreateSessionParams,
-} from './tool-router';
+export { ToolRouter } from './tool-router';