@composio/client 0.1.0-alpha.1 → 0.1.0-alpha.10

package/src/resources/connected-accounts.ts

@@ -6,6 +6,9 @@ import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
 export class ConnectedAccounts extends APIResource {
+  /**
+   * Create a new connected account
+   */
   create(
     body: ConnectedAccountCreateParams,
     options?: RequestOptions,
@@ -13,10 +16,16 @@ export class ConnectedAccounts extends APIResource {
     return this._client.post('/api/v3/connected_accounts', { body, ...options });
   }
 
+  /**
+   * Get connected account details by ID
+   */
   retrieve(nanoid: string, options?: RequestOptions): APIPromise<ConnectedAccountRetrieveResponse> {
     return this._client.get(path`/api/v3/connected_accounts/${nanoid}`, options);
   }
 
+  /**
+   * List connected accounts with optional filters
+   */
   list(
     query: ConnectedAccountListParams | null | undefined = {},
     options?: RequestOptions,
@@ -24,14 +33,23 @@ export class ConnectedAccounts extends APIResource {
     return this._client.get('/api/v3/connected_accounts', { query, ...options });
   }
 
+  /**
+   * Delete a connected account
+   */
   delete(nanoid: string, options?: RequestOptions): APIPromise<ConnectedAccountDeleteResponse> {
     return this._client.delete(path`/api/v3/connected_accounts/${nanoid}`, options);
   }
 
+  /**
+   * Refresh authentication for a connected account
+   */
   refresh(nanoid: string, options?: RequestOptions): APIPromise<ConnectedAccountRefreshResponse> {
     return this._client.post(path`/api/v3/connected_accounts/${nanoid}/refresh`, options);
   }
 
+  /**
+   * Enable or disable a connected account
+   */
   updateStatus(
     nanoID: string,
     body: ConnectedAccountUpdateStatusParams,
@@ -47,17 +65,39 @@ export interface ConnectedAccountCreateResponse {
    */
   id: string;
 
+  deprecated: ConnectedAccountCreateResponse.Deprecated;
+
   /**
-   * The redirect uri of the app
+   * @deprecated DEPRECATED: This field will be removed in a future version. Please
+   * use redirect_url instead.
    */
   redirect_uri: string | null;
 
+  /**
+   * The URL to redirect to after connection completion
+   */
+  redirect_url: string | null;
+
   /**
    * The status of the connected account
    */
   status: 'ACTIVE' | 'INACTIVE' | 'DELETED' | 'INITIATED' | 'EXPIRED' | 'FAILED';
 }
 
+export namespace ConnectedAccountCreateResponse {
+  export interface Deprecated {
+    /**
+     * The uuid of the auth config
+     */
+    authConfigUuid: string;
+
+    /**
+     * The uuid of the connected account
+     */
+    uuid: string;
+  }
+}
+
 export interface ConnectedAccountRetrieveResponse {
   /**
    * The id of the connection
@@ -108,10 +148,7 @@ export interface ConnectedAccountRetrieveResponse {
    */
   user_id: string;
 
-  /**
-   * The uuid of the connection
-   */
-  uuid: string;
+  deprecated?: ConnectedAccountRetrieveResponse.Deprecated;
 
   /**
    * The endpoint to make test request for verification
@@ -153,6 +190,17 @@ export namespace ConnectedAccountRetrieveResponse {
      * Whether the auth config is disabled
      */
     is_disabled: boolean;
+
+    deprecated?: AuthConfig.Deprecated;
+  }
+
+  export namespace AuthConfig {
+    export interface Deprecated {
+      /**
+       * The uuid of the auth config
+       */
+      uuid: string;
+    }
   }
 
   export interface Toolkit {
@@ -161,6 +209,18 @@ export namespace ConnectedAccountRetrieveResponse {
      */
     slug: string;
   }
+
+  export interface Deprecated {
+    /**
+     * The labels of the connection
+     */
+    labels: Array<string>;
+
+    /**
+     * The uuid of the connection
+     */
+    uuid: string;
+  }
 }
 
 export interface ConnectedAccountListResponse {
@@ -217,15 +277,12 @@ export namespace ConnectedAccountListResponse {
      */
     user_id: string;
 
+    deprecated?: Item.Deprecated;
+
     /**
      * The endpoint to make test request for verification
      */
     test_request_endpoint?: string;
-
-    /**
-     * The uuid of the connected account
-     */
-    uuid?: string;
   }
 
   export namespace Item {
@@ -262,6 +319,17 @@ export namespace ConnectedAccountListResponse {
        * Whether the auth config is disabled
        */
       is_disabled: boolean;
+
+      deprecated?: AuthConfig.Deprecated;
+    }
+
+    export namespace AuthConfig {
+      export interface Deprecated {
+        /**
+         * The uuid of the auth config
+         */
+        uuid: string;
+      }
     }
 
     export interface Toolkit {
@@ -270,307 +338,50 @@ export namespace ConnectedAccountListResponse {
        */
       slug: string;
     }
+
+    export interface Deprecated {
+      /**
+       * The labels of the connection
+       */
+      labels: Array<string>;
+
+      /**
+       * The uuid of the connection
+       */
+      uuid: string;
+    }
   }
 }
 
 export interface ConnectedAccountDeleteResponse {
   /**
-   * The id of the connection
-   */
-  id: string;
-
-  auth_config: ConnectedAccountDeleteResponse.AuthConfig;
-
-  /**
-   * The created at of the connection
-   */
-  created_at: string;
-
-  /**
-   * The data of the connection
-   */
-  data: Record<string, unknown>;
-
-  /**
-   * Whether the connection is disabled
-   */
-  is_disabled: boolean;
-
-  /**
-   * The status of the connection
-   */
-  status: 'ACTIVE' | 'INACTIVE' | 'DELETED' | 'INITIATED' | 'EXPIRED' | 'FAILED';
-
-  /**
-   * The reason the connection is disabled
-   */
-  status_reason: string | null;
-
-  toolkit: ConnectedAccountDeleteResponse.Toolkit;
-
-  /**
-   * The updated at of the connection
+   * The success of the update
    */
-  updated_at: string;
-
-  /**
-   * The user id of the connection
-   */
-  user_id: string;
-
-  /**
-   * The uuid of the connection
-   */
-  uuid: string;
-
-  /**
-   * The endpoint to make test request for verification
-   */
-  test_request_endpoint?: string;
-}
-
-export namespace ConnectedAccountDeleteResponse {
-  export interface AuthConfig {
-    /**
-     * The id of the auth config
-     */
-    id: string;
-
-    /**
-     * The auth scheme of the auth config
-     */
-    auth_scheme:
-      | 'OAUTH2'
-      | 'OAUTH1'
-      | 'OAUTH1A'
-      | 'API_KEY'
-      | 'BASIC'
-      | 'BILLCOM_AUTH'
-      | 'BEARER_TOKEN'
-      | 'GOOGLE_SERVICE_ACCOUNT'
-      | 'NO_AUTH'
-      | 'BASIC_WITH_JWT'
-      | 'COMPOSIO_LINK'
-      | 'CALCOM_AUTH'
-      | 'SNOWFLAKE';
-
-    /**
-     * Whether the auth config is managed by Composio
-     */
-    is_composio_managed: boolean;
-
-    /**
-     * Whether the auth config is disabled
-     */
-    is_disabled: boolean;
-  }
-
-  export interface Toolkit {
-    /**
-     * The slug of the toolkit
-     */
-    slug: string;
-  }
+  success: boolean;
 }
 
 export interface ConnectedAccountRefreshResponse {
   /**
-   * The id of the connection
+   * The id of the connected account
    */
   id: string;
 
-  auth_config: ConnectedAccountRefreshResponse.AuthConfig;
-
-  /**
-   * The created at of the connection
-   */
-  created_at: string;
-
-  /**
-   * The data of the connection
-   */
-  data: Record<string, unknown>;
-
   /**
-   * Whether the connection is disabled
+   * The redirect URL of the app (previously named redirect_uri)
    */
-  is_disabled: boolean;
+  redirect_url: string | null;
 
   /**
-   * The status of the connection
+   * The status of the connected account
    */
   status: 'ACTIVE' | 'INACTIVE' | 'DELETED' | 'INITIATED' | 'EXPIRED' | 'FAILED';
-
-  /**
-   * The reason the connection is disabled
-   */
-  status_reason: string | null;
-
-  toolkit: ConnectedAccountRefreshResponse.Toolkit;
-
-  /**
-   * The updated at of the connection
-   */
-  updated_at: string;
-
-  /**
-   * The user id of the connection
-   */
-  user_id: string;
-
-  /**
-   * The uuid of the connection
-   */
-  uuid: string;
-
-  /**
-   * The endpoint to make test request for verification
-   */
-  test_request_endpoint?: string;
-}
-
-export namespace ConnectedAccountRefreshResponse {
-  export interface AuthConfig {
-    /**
-     * The id of the auth config
-     */
-    id: string;
-
-    /**
-     * The auth scheme of the auth config
-     */
-    auth_scheme:
-      | 'OAUTH2'
-      | 'OAUTH1'
-      | 'OAUTH1A'
-      | 'API_KEY'
-      | 'BASIC'
-      | 'BILLCOM_AUTH'
-      | 'BEARER_TOKEN'
-      | 'GOOGLE_SERVICE_ACCOUNT'
-      | 'NO_AUTH'
-      | 'BASIC_WITH_JWT'
-      | 'COMPOSIO_LINK'
-      | 'CALCOM_AUTH'
-      | 'SNOWFLAKE';
-
-    /**
-     * Whether the auth config is managed by Composio
-     */
-    is_composio_managed: boolean;
-
-    /**
-     * Whether the auth config is disabled
-     */
-    is_disabled: boolean;
-  }
-
-  export interface Toolkit {
-    /**
-     * The slug of the toolkit
-     */
-    slug: string;
-  }
 }
 
 export interface ConnectedAccountUpdateStatusResponse {
   /**
-   * The id of the connection
-   */
-  id: string;
-
-  auth_config: ConnectedAccountUpdateStatusResponse.AuthConfig;
-
-  /**
-   * The created at of the connection
-   */
-  created_at: string;
-
-  /**
-   * The data of the connection
-   */
-  data: Record<string, unknown>;
-
-  /**
-   * Whether the connection is disabled
-   */
-  is_disabled: boolean;
-
-  /**
-   * The status of the connection
+   * The success of the update
    */
-  status: 'ACTIVE' | 'INACTIVE' | 'DELETED' | 'INITIATED' | 'EXPIRED' | 'FAILED';
-
-  /**
-   * The reason the connection is disabled
-   */
-  status_reason: string | null;
-
-  toolkit: ConnectedAccountUpdateStatusResponse.Toolkit;
-
-  /**
-   * The updated at of the connection
-   */
-  updated_at: string;
-
-  /**
-   * The user id of the connection
-   */
-  user_id: string;
-
-  /**
-   * The uuid of the connection
-   */
-  uuid: string;
-
-  /**
-   * The endpoint to make test request for verification
-   */
-  test_request_endpoint?: string;
-}
-
-export namespace ConnectedAccountUpdateStatusResponse {
-  export interface AuthConfig {
-    /**
-     * The id of the auth config
-     */
-    id: string;
-
-    /**
-     * The auth scheme of the auth config
-     */
-    auth_scheme:
-      | 'OAUTH2'
-      | 'OAUTH1'
-      | 'OAUTH1A'
-      | 'API_KEY'
-      | 'BASIC'
-      | 'BILLCOM_AUTH'
-      | 'BEARER_TOKEN'
-      | 'GOOGLE_SERVICE_ACCOUNT'
-      | 'NO_AUTH'
-      | 'BASIC_WITH_JWT'
-      | 'COMPOSIO_LINK'
-      | 'CALCOM_AUTH'
-      | 'SNOWFLAKE';
-
-    /**
-     * Whether the auth config is managed by Composio
-     */
-    is_composio_managed: boolean;
-
-    /**
-     * Whether the auth config is disabled
-     */
-    is_disabled: boolean;
-  }
-
-  export interface Toolkit {
-    /**
-     * The slug of the toolkit
-     */
-    slug: string;
-  }
+  success: boolean;
 }
 
 export interface ConnectedAccountCreateParams {
@@ -588,13 +399,24 @@ export namespace ConnectedAccountCreateParams {
   }
 
   export interface Connection {
+    /**
+     * The URL to redirect to after connection completion
+     */
+    callback_url?: string;
+
     /**
      * Initial data to pass to the connected account
      */
     data?: Record<string, unknown>;
 
     /**
-     * The URL to redirect to after connection completion
+     * Whether the connection is rerouted
+     */
+    deprecated_is_v1_rerouted?: boolean;
+
+    /**
+     * @deprecated DEPRECATED: This parameter will be removed in a future version.
+     * Please use callback_url instead.
      */
     redirect_uri?: string;
 
@@ -607,15 +429,20 @@ export namespace ConnectedAccountCreateParams {
 
 export interface ConnectedAccountListParams {
   /**
-   * The auth config id of the connected account
+   * The auth config ids of the connected accounts
    */
-  auth_config_id?: string;
+  auth_config_ids?: Array<string> | null;
 
   /**
    * The cursor to paginate through the connected accounts
    */
   cursor?: number | null;
 
+  /**
+   * The labels of the connected accounts
+   */
+  labels?: Array<string> | null;
+
   /**
    * The limit of the connected accounts to return
    */
@@ -629,17 +456,17 @@ export interface ConnectedAccountListParams {
   /**
    * The status of the connected account
    */
-  status?: 'ACTIVE' | 'INACTIVE' | 'DELETED' | 'INITIATED' | 'EXPIRED' | 'FAILED';
+  statuses?: Array<'ACTIVE' | 'INACTIVE' | 'DELETED' | 'INITIATED' | 'EXPIRED' | 'FAILED'> | null;
 
   /**
-   * The toolkit slug of the connected account
+   * The toolkit slugs of the connected accounts
    */
-  toolkit_slug?: string;
+  toolkit_slugs?: Array<string> | null;
 
   /**
-   * The user id of the connected account
+   * The user ids of the connected accounts
    */
-  user_id?: string;
+  user_ids?: Array<string> | null;
 }
 
 export interface ConnectedAccountUpdateStatusParams {