@composio/client 0.1.0-alpha.62 → 0.1.0-alpha.63

package/src/resources/connected-accounts.ts

@@ -40,7 +40,7 @@ export class ConnectedAccounts extends APIResource {
    * ```ts
    * const connectedAccount =
    *   await client.connectedAccounts.retrieve(
-   *     'con_1a2b3c4d5e6f',
+   *     'ca_1a2b3c4d5e6f',
    *   );
    * ```
    */
@@ -75,13 +75,41 @@ export class ConnectedAccounts extends APIResource {
    * @example
    * ```ts
    * const connectedAccount =
-   *   await client.connectedAccounts.delete('con_1a2b3c4d5e6f');
+   *   await client.connectedAccounts.delete('ca_1a2b3c4d5e6f');
    * ```
    */
   delete(nanoid: string, options?: RequestOptions): APIPromise<ConnectedAccountDeleteResponse> {
     return this._client.delete(path`/api/v3/connected_accounts/${nanoid}`, options);
   }
 
+  /**
+   * 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
+   * const response = await client.connectedAccounts.patch(
+   *   'ca_1a2b3c4d5e6f',
+   *   {
+   *     connection: {
+   *       state: {
+   *         authScheme: 'BEARER_TOKEN',
+   *         val: { token: 'new_access_token' },
+   *       },
+   *     },
+   *   },
+   * );
+   * ```
+   */
+  patch(
+    nanoid: string,
+    body: ConnectedAccountPatchParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConnectedAccountPatchResponse> {
+    return this._client.patch(path`/api/v3/connected_accounts/${nanoid}`, { body, ...options });
+  }
+
   /**
    * Initiates a new authentication flow for a connected account when credentials
    * have expired or become invalid. This may generate a new authentication URL for
@@ -90,7 +118,7 @@ export class ConnectedAccounts extends APIResource {
    * @example
    * ```ts
    * const response = await client.connectedAccounts.refresh(
-   *   'con_1a2b3c4d5e6f',
+   *   'ca_1a2b3c4d5e6f',
    * );
    * ```
    */
@@ -116,7 +144,7 @@ export class ConnectedAccounts extends APIResource {
    * ```ts
    * const response =
    *   await client.connectedAccounts.updateStatus(
-   *     'con_1a2b3c4d5e6f',
+   *     'ca_1a2b3c4d5e6f',
    *     { enabled: true },
    *   );
    * ```
@@ -4541,6 +4569,11 @@ export interface ConnectedAccountRetrieveResponse {
    */
   id: string;
 
+  /**
+   * A user-defined alias for the connected account
+   */
+  alias: string | null;
+
   auth_config: ConnectedAccountRetrieveResponse.AuthConfig;
 
   /**
@@ -4609,6 +4642,12 @@ export interface ConnectedAccountRetrieveResponse {
    */
   user_id: string;
 
+  /**
+   * A short, token-friendly identifier for multi-account disambiguation, typically
+   * toolkit-prefixed with 1-2 words (e.g., "gmail_red-castle")
+   */
+  word_id: string | null;
+
   /**
    * @deprecated
    */
@@ -9056,6 +9095,11 @@ export namespace ConnectedAccountListResponse {
      */
     id: string;
 
+    /**
+     * A user-defined alias for the connected account
+     */
+    alias: string | null;
+
     auth_config: Item.AuthConfig;
 
     /**
@@ -9118,6 +9162,12 @@ export namespace ConnectedAccountListResponse {
      */
     user_id: string;
 
+    /**
+     * A short, token-friendly identifier for multi-account disambiguation, typically
+     * toolkit-prefixed with 1-2 words (e.g., "gmail_red-castle")
+     */
+    word_id: string | null;
+
     /**
      * @deprecated
      */
@@ -13557,6 +13607,24 @@ export interface ConnectedAccountDeleteResponse {
   success: boolean;
 }
 
+export interface ConnectedAccountPatchResponse {
+  /**
+   * The unique identifier of the updated connected account
+   */
+  id: string;
+
+  /**
+   * The current status of the connected account after the update (ACTIVE, EXPIRED,
+   * INACTIVE, etc.)
+   */
+  status: string;
+
+  /**
+   * Whether the update was successful
+   */
+  success: boolean;
+}
+
 /**
  * Response schema for a refreshed connected account authentication
  */
@@ -13609,6 +13677,12 @@ export namespace ConnectedAccountCreateParams {
   }
 
   export interface Connection {
+    /**
+     * A human-readable alias for this connected account. Must be unique per entity and
+     * toolkit within the project.
+     */
+    alias?: string;
+
     /**
      * The URL to redirect to after connection completion
      */
@@ -18046,6 +18120,120 @@ export interface ConnectedAccountListParams {
   user_ids?: Array<string> | null;
 }
 
+export interface ConnectedAccountPatchParams {
+  /**
+   * 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 namespace ConnectedAccountPatchParams {
+  export interface Connection {
+    state: Connection.State;
+  }
+
+  export namespace Connection {
+    export interface State {
+      /**
+       * The auth scheme of the connected account. Must match the connection's actual
+       * auth scheme.
+       */
+      authScheme:
+        | 'BEARER_TOKEN'
+        | 'API_KEY'
+        | 'BASIC'
+        | 'BASIC_WITH_JWT'
+        | 'GOOGLE_SERVICE_ACCOUNT'
+        | 'SERVICE_ACCOUNT';
+
+      /**
+       * Credential fields to update. Only provided fields are changed — omitted fields
+       * are preserved. Set a field to null to remove it.
+       */
+      val: State.Val;
+    }
+
+    export namespace State {
+      /**
+       * Credential fields to update. Only provided fields are changed — omitted fields
+       * are preserved. Set a field to null to remove it.
+       */
+      export interface Val {
+        token?: string | null;
+
+        account_id?: string | null;
+
+        account_url?: string | null;
+
+        api_key?: string | null;
+
+        api_url?: 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;
+
+        extension?: string | null;
+
+        form_api_base_url?: string | null;
+
+        generic_api_key?: 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;
+
+        username?: string | null;
+
+        version?: string | null;
+
+        your_server?: string | null;
+
+        'your-domain'?: string | null;
+
+        [k: string]: unknown;
+      }
+    }
+  }
+}
+
 export interface ConnectedAccountRefreshParams {
   /**
    * Query param
@@ -18077,10 +18265,12 @@ export declare namespace ConnectedAccounts {
     type ConnectedAccountRetrieveResponse as ConnectedAccountRetrieveResponse,
     type ConnectedAccountListResponse as ConnectedAccountListResponse,
     type ConnectedAccountDeleteResponse as ConnectedAccountDeleteResponse,
+    type ConnectedAccountPatchResponse as ConnectedAccountPatchResponse,
     type ConnectedAccountRefreshResponse as ConnectedAccountRefreshResponse,
     type ConnectedAccountUpdateStatusResponse as ConnectedAccountUpdateStatusResponse,
     type ConnectedAccountCreateParams as ConnectedAccountCreateParams,
     type ConnectedAccountListParams as ConnectedAccountListParams,
+    type ConnectedAccountPatchParams as ConnectedAccountPatchParams,
     type ConnectedAccountRefreshParams as ConnectedAccountRefreshParams,
     type ConnectedAccountUpdateStatusParams as ConnectedAccountUpdateStatusParams,
   };

package/src/resources/index.ts

@@ -26,10 +26,12 @@ export {
   type ConnectedAccountRetrieveResponse,
   type ConnectedAccountListResponse,
   type ConnectedAccountDeleteResponse,
+  type ConnectedAccountPatchResponse,
   type ConnectedAccountRefreshResponse,
   type ConnectedAccountUpdateStatusResponse,
   type ConnectedAccountCreateParams,
   type ConnectedAccountListParams,
+  type ConnectedAccountPatchParams,
   type ConnectedAccountRefreshParams,
   type ConnectedAccountUpdateStatusParams,
 } from './connected-accounts';

package/src/resources/mcp/mcp.ts

@@ -26,7 +26,7 @@ export class Mcp extends APIResource {
    * @example
    * ```ts
    * const mcp = await client.mcp.create({
-   *   auth_config_ids: ['auth_cfg_abc123def456'],
+   *   auth_config_ids: ['ac_1a2b3c4d5e6f'],
    *   name: 'GitHub Integration Server',
    * });
    * ```

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

@@ -66,7 +66,7 @@ export class Session extends APIResource {
    * ```ts
    * const response = await client.toolRouter.session.execute(
    *   'trs_LX9uJKBinWWr',
-   *   { tool_slug: 'GITHUB_CREATE_ISSUE' },
+   *   { tool_slug: 'GITHUB_CREATE_AN_ISSUE' },
    * );
    * ```
    */
@@ -304,6 +304,11 @@ export namespace SessionCreateResponse {
        */
       callback_url?: string;
 
+      /**
+       * Enable the "remove" action in COMPOSIO_MANAGE_CONNECTIONS. Default true.
+       */
+      enable_connection_removal?: boolean;
+
       /**
        * Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status.
        * Default false. May not work reliably with GPT models.
@@ -562,6 +567,11 @@ export namespace SessionRetrieveResponse {
        */
       callback_url?: string;
 
+      /**
+       * Enable the "remove" action in COMPOSIO_MANAGE_CONNECTIONS. Default true.
+       */
+      enable_connection_removal?: boolean;
+
       /**
        * Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status.
        * Default false. May not work reliably with GPT models.
@@ -1038,7 +1048,8 @@ export namespace SessionSearchResponse {
     input_schema?: { [key: string]: unknown };
 
     /**
-     * Output/response schema for the tool
+     * Output/response schema for the tool. Only included when include_output_schemas
+     * is true.
      */
     output_schema?: { [key: string]: unknown };
 
@@ -1059,14 +1070,14 @@ export namespace SessionSearchResponse {
       args: SchemaRef.Args;
 
       /**
-       * Instruction message for the LLM
+       * Tool to call
        */
-      message: string;
+      tool: 'COMPOSIO_GET_TOOL_SCHEMAS';
 
       /**
-       * Tool to call
+       * Instruction message for the LLM
        */
-      tool: 'COMPOSIO_GET_TOOL_SCHEMAS';
+      message?: string;
     }
 
     export namespace SchemaRef {
@@ -1103,6 +1114,18 @@ export namespace SessionSearchResponse {
      */
     toolkit: string;
 
+    /**
+     * When "required", the agent must specify which account to use. Present only when
+     * multiple accounts exist.
+     */
+    account_selection?: 'required';
+
+    /**
+     * List of connected accounts for this toolkit. Present when multi-account is
+     * enabled.
+     */
+    accounts?: Array<ToolkitConnectionStatus.Account>;
+
     /**
      * Connection details including auth config and connected account IDs. Only present
      * when has_active_connection is true.
@@ -1114,6 +1137,40 @@ export namespace SessionSearchResponse {
      */
     current_user_info?: { [key: string]: unknown };
   }
+
+  export namespace ToolkitConnectionStatus {
+    export interface Account {
+      /**
+       * Unique identifier for this account
+       */
+      id: string;
+
+      /**
+       * ISO 8601 timestamp of when the account was connected
+       */
+      created_at: string;
+
+      /**
+       * Whether this is the default account for the toolkit
+       */
+      is_default: boolean;
+
+      /**
+       * Connection status (e.g., "active")
+       */
+      status: string;
+
+      /**
+       * User-assigned alias for this account
+       */
+      alias?: string;
+
+      /**
+       * Information about the connected user (email, name, etc.)
+       */
+      user_info?: { [key: string]: unknown };
+    }
+  }
 }
 
 export interface SessionToolkitsResponse {
@@ -1282,6 +1339,12 @@ export namespace SessionToolsResponse {
      */
     output_parameters: { [key: string]: unknown };
 
+    /**
+     * Structured scope requirements for the tool. Null means the tool is legacy and
+     * only exposes flat scopes.
+     */
+    scope_requirements: Item.ScopeRequirements | null;
+
     /**
      * List of scopes associated with the tool
      */
@@ -1344,6 +1407,20 @@ export namespace SessionToolsResponse {
       }
     }
 
+    /**
+     * Structured scope requirements for the tool. Null means the tool is legacy and
+     * only exposes flat scopes.
+     */
+    export interface ScopeRequirements {
+      all_of: Array<string | ScopeRequirements.AnyOf>;
+    }
+
+    export namespace ScopeRequirements {
+      export interface AnyOf {
+        any_of: Array<string>;
+      }
+    }
+
     export interface Toolkit {
       /**
        * URL to the toolkit logo image
@@ -1566,6 +1643,12 @@ export namespace SessionCreateParams {
      */
     enable?: boolean | null;
 
+    /**
+     * Enable the "remove" action in COMPOSIO_MANAGE_CONNECTIONS to allow deleting
+     * connected accounts. Default true.
+     */
+    enable_connection_removal?: boolean | null;
+
     /**
      * When true, the COMPOSIO_WAIT_FOR_CONNECTIONS tool is available for agents to
      * poll connection status after sharing auth URLs. Default is false (disabled). May
@@ -1673,6 +1756,14 @@ export interface SessionExecuteParams {
    */
   tool_slug: string;
 
+  /**
+   * Account identifier to specify which connected account to use. Use the account ID
+   * (e.g. "coup_hurricane_dal_analytical") or an alias. When omitted with a single
+   * account, the default is used. When omitted with multiple accounts, an error
+   * lists available accounts.
+   */
+  account?: string;
+
   /**
    * The arguments required by the tool
    */
@@ -2614,9 +2705,9 @@ export interface SessionToolkitsParams {
   is_connected?: boolean | null;
 
   /**
-   * Number of items per page, max allowed is 1000
+   * Number of items per page, max allowed is 50
    */
-  limit?: number | null;
+  limit?: number;
 
   /**
    * Search query to filter toolkits by name, slug, or description

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

@@ -45,11 +45,11 @@ export class ToolRouter extends APIResource {
    *     toolkits: [
    *       {
    *         toolkit: 'gmail',
-   *         auth_config_id: 'auth_config_123',
+   *         auth_config_id: 'ac_1a2b3c4d5e6f',
    *       },
    *       {
    *         toolkit: 'slack',
-   *         auth_config_id: 'auth_config_456',
+   *         auth_config_id: 'ac_7g8h9i0j1k2l',
    *       },
    *       { toolkit: 'github' },
    *     ],

package/src/resources/tools.ts

@@ -163,6 +163,12 @@ export interface ToolRetrieveResponse {
    */
   output_parameters: { [key: string]: unknown };
 
+  /**
+   * Structured scope requirements for the tool. Null means the tool is legacy and
+   * only exposes flat scopes.
+   */
+  scope_requirements: ToolRetrieveResponse.ScopeRequirements | null;
+
   /**
    * List of scopes associated with the tool
    */
@@ -225,6 +231,20 @@ export namespace ToolRetrieveResponse {
     }
   }
 
+  /**
+   * Structured scope requirements for the tool. Null means the tool is legacy and
+   * only exposes flat scopes.
+   */
+  export interface ScopeRequirements {
+    all_of: Array<string | ScopeRequirements.AnyOf>;
+  }
+
+  export namespace ScopeRequirements {
+    export interface AnyOf {
+      any_of: Array<string>;
+    }
+  }
+
   export interface Toolkit {
     /**
      * URL to the toolkit logo image
@@ -294,6 +314,12 @@ export namespace ToolListResponse {
      */
     output_parameters: { [key: string]: unknown };
 
+    /**
+     * Structured scope requirements for the tool. Null means the tool is legacy and
+     * only exposes flat scopes.
+     */
+    scope_requirements: Item.ScopeRequirements | null;
+
     /**
      * List of scopes associated with the tool
      */
@@ -356,6 +382,20 @@ export namespace ToolListResponse {
       }
     }
 
+    /**
+     * Structured scope requirements for the tool. Null means the tool is legacy and
+     * only exposes flat scopes.
+     */
+    export interface ScopeRequirements {
+      all_of: Array<string | ScopeRequirements.AnyOf>;
+    }
+
+    export namespace ScopeRequirements {
+      export interface AnyOf {
+        any_of: Array<string>;
+      }
+    }
+
     export interface Toolkit {
       /**
        * URL to the toolkit logo image

package/src/resources/trigger-instances/trigger-instances.ts

@@ -101,7 +101,8 @@ export namespace TriggerInstanceListActiveResponse {
     disabledAt: string | null;
 
     /**
-     * State of the trigger instance
+     * @deprecated DEPRECATED: This field exposes internal state and will be removed in
+     * a future version.
      */
     state: { [key: string]: unknown };
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.62'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.63'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.62";
+export declare const VERSION = "0.1.0-alpha.63";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.62";
+export declare const VERSION = "0.1.0-alpha.63";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.1.0-alpha.62'; // x-release-please-version
+exports.VERSION = '0.1.0-alpha.63'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.1.0-alpha.62'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.63'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map