@composio/client 0.1.0-alpha.15 → 0.1.0-alpha.17

package/src/resources/index.ts

@@ -1,6 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Auth } from './auth/auth';
 export {
   AuthConfigs,
   type AuthConfigCreateResponse,
@@ -41,10 +40,12 @@ export {
   type McpListResponse,
   type McpDeleteResponse,
   type McpRetrieveAppResponse,
+  type McpValidateResponse,
   type McpCreateParams,
   type McpUpdateParams,
   type McpListParams,
   type McpRetrieveAppParams,
+  type McpValidateParams,
 } from './mcp/mcp';
 export {
   Migration,
@@ -96,3 +97,4 @@ export {
   type TriggersTypeRetrieveEnumResponse,
   type TriggersTypeListParams,
 } from './triggers-types';
+export { V3 } from './v3/v3';

package/src/resources/mcp/index.ts

@@ -9,8 +9,10 @@ export {
   type McpListResponse,
   type McpDeleteResponse,
   type McpRetrieveAppResponse,
+  type McpValidateResponse,
   type McpCreateParams,
   type McpUpdateParams,
   type McpListParams,
   type McpRetrieveAppParams,
+  type McpValidateParams,
 } from './mcp';

package/src/resources/mcp/mcp.ts

@@ -4,6 +4,7 @@ import { APIResource } from '../../core/resource';
 import * as CustomAPI from './custom';
 import { Custom, CustomCreateParams, CustomCreateResponse } from './custom';
 import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -117,6 +118,32 @@ export class Mcp extends APIResource {
   ): APIPromise<McpRetrieveAppResponse> {
     return this._client.get(path`/api/v3/mcp/app/${appKey}`, { query, ...options });
   }
+
+  /**
+   * Admin-only endpoint that validates a Model Control Protocol (MCP) server and
+   * retrieves its complete configuration details, including authentication
+   * information. This endpoint is typically used by the MCP service itself to
+   * authenticate and authorize connection requests from clients.
+   *
+   * @example
+   * ```ts
+   * const response = await client.mcp.validate(
+   *   '550e8400-e29b-41d4-a716-446655440000',
+   *   { 'x-composio-admin-token': 'admin_tk_12345abcdef' },
+   * );
+   * ```
+   */
+  validate(
+    uuid: string,
+    params: McpValidateParams,
+    options?: RequestOptions,
+  ): APIPromise<McpValidateResponse> {
+    const { 'x-composio-admin-token': xComposioAdminToken } = params;
+    return this._client.get(path`/api/v3/mcp/validate/${uuid}`, {
+      ...options,
+      headers: buildHeaders([{ 'x-composio-admin-token': xComposioAdminToken }, options?.headers]),
+    });
+  }
 }
 
 /**
@@ -528,6 +555,98 @@ export namespace McpRetrieveAppResponse {
   }
 }
 
+/**
+ * Complete validation and connection details for an MCP server
+ */
+export interface McpValidateResponse {
+  /**
+   * Unique identifier of the validated MCP server
+   */
+  id: string;
+
+  /**
+   * Client information for the MCP server
+   */
+  client: McpValidateResponse.Client;
+
+  /**
+   * Human-readable name of the MCP server
+   */
+  name: string;
+
+  /**
+   * URL endpoint for connecting to this MCP server
+   */
+  url: string;
+
+  /**
+   * User authentication data for the MCP server
+   */
+  userData: McpValidateResponse.UserData;
+
+  /**
+   * List of action identifiers enabled for this server
+   */
+  actions?: Array<string> | null;
+
+  /**
+   * List of application identifiers this server is configured for
+   */
+  apps?: Array<string>;
+
+  /**
+   * List of connected account identifiers this server can use for authentication
+   */
+  connectedAccountIds?: Array<string> | null;
+
+  /**
+   * Flag indicating if this server uses custom authentication headers
+   */
+  customAuthHeaders?: boolean;
+
+  /**
+   * List of entity identifiers this MCP server can interact with
+   */
+  entityIds?: Array<string> | null;
+}
+
+export namespace McpValidateResponse {
+  /**
+   * Client information for the MCP server
+   */
+  export interface Client {
+    /**
+     * Project identifier that owns this MCP server
+     */
+    id: string;
+
+    /**
+     * Organization identifier that owns the project
+     */
+    orgId: string;
+  }
+
+  /**
+   * User authentication data for the MCP server
+   */
+  export interface UserData {
+    /**
+     * User identifier for API access
+     */
+    id: string;
+
+    /**
+     * API key for authenticating requests to the Composio API
+     */
+    apiKey: string;
+
+    /**
+     * Email address associated with the API key user
+     */
+    email: string;
+  }
+}
+
 export interface McpCreateParams {
   /**
    * Human-readable name to identify this MCP server instance (4-25 characters,
@@ -624,6 +743,13 @@ export interface McpRetrieveAppParams {
   toolkit?: string;
 }
 
+export interface McpValidateParams {
+  /**
+   * Administrative access token required for validating MCP servers
+   */
+  'x-composio-admin-token': string;
+}
+
 Mcp.Custom = Custom;
 
 export declare namespace Mcp {
@@ -634,10 +760,12 @@ export declare namespace Mcp {
     type McpListResponse as McpListResponse,
     type McpDeleteResponse as McpDeleteResponse,
     type McpRetrieveAppResponse as McpRetrieveAppResponse,
+    type McpValidateResponse as McpValidateResponse,
     type McpCreateParams as McpCreateParams,
     type McpUpdateParams as McpUpdateParams,
     type McpListParams as McpListParams,
     type McpRetrieveAppParams as McpRetrieveAppParams,
+    type McpValidateParams as McpValidateParams,
   };
 
   export {

package/src/resources/org/project/api-keys.ts

@@ -99,12 +99,6 @@ export interface APIKeyCreateResponse {
    */
   created_at: string;
 
-  /**
-   * @deprecated UTC timestamp indicating when the API key was created. DEPRECATED:
-   * Use created_at instead.
-   */
-  createdAt: string;
-
   /**
    * The API key string value that should be included in API requests. This value is
    * only shown once at creation time.
@@ -193,24 +187,12 @@ export interface APIKeyCreateAPIKeyResponse {
    */
   created_at: string;
 
-  /**
-   * @deprecated UTC timestamp indicating when the API key was created. Use
-   * created_at instead.
-   */
-  createdAt: string;
-
   /**
    * The API key string value that should be included in API requests. This value is
    * only shown once.
    */
   key: string;
 
-  /**
-   * @deprecated UTC timestamp indicating when the API key was created. Use
-   * last_used_at instead.
-   */
-  lastUsedAt: string;
-
   /**
    * Name assigned to help identify the key's purpose. For auto-generated keys, this
    * will be a random name.

package/src/resources/org/project/trigger.ts

@@ -11,13 +11,14 @@ export class Trigger extends APIResource {
    *
    * @example
    * ```ts
-   * const trigger = await client.org.project.trigger.update({
-   *   enabled: true,
-   * });
+   * const trigger = await client.org.project.trigger.update();
    * ```
    */
-  update(params: TriggerUpdateParams, options?: RequestOptions): APIPromise<TriggerUpdateResponse> {
-    const { enabled } = params;
+  update(
+    params: TriggerUpdateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TriggerUpdateResponse> {
+    const { enabled } = params ?? {};
     return this._client.patch('/api/v3/org/project/trigger', { query: { enabled }, ...options });
   }
 
@@ -175,7 +176,7 @@ export interface TriggerUpdateParams {
    * Boolean flag indicating whether triggers should be enabled (true) or disabled
    * (false) for the project
    */
-  enabled: boolean;
+  enabled?: boolean | null;
 }
 
 export declare namespace Trigger {

package/src/resources/toolkits.ts

@@ -47,6 +47,8 @@ export class Toolkits extends APIResource {
  * Detailed information about a single toolkit
  */
 export interface ToolkitRetrieveResponse {
+  deprecated: ToolkitRetrieveResponse.Deprecated;
+
   /**
    * Indicates if this toolkit is currently enabled and available for use
    */
@@ -86,6 +88,12 @@ export interface ToolkitRetrieveResponse {
 }
 
 export namespace ToolkitRetrieveResponse {
+  export interface Deprecated {
+    toolkitId: string;
+
+    getCurrentUserEndpoint?: string;
+  }
+
   /**
    * Comprehensive metadata for the toolkit including dates, descriptions, and
    * statistics
@@ -294,6 +302,11 @@ export namespace ToolkitListResponse {
    * Detailed information about a toolkit
    */
   export interface Item {
+    /**
+     * Deprecated toolkit ID
+     */
+    deprecated: Item.Deprecated;
+
     /**
      * Indicates if this toolkit is specific to the current project or globally
      * available
@@ -332,6 +345,13 @@ export namespace ToolkitListResponse {
   }
 
   export namespace Item {
+    /**
+     * Deprecated toolkit ID
+     */
+    export interface Deprecated {
+      toolkitId: string;
+    }
+
     /**
      * Additional metadata about the toolkit
      */

package/src/resources/tools.ts

@@ -118,7 +118,7 @@ export interface ToolRetrieveResponse {
   deprecated: ToolRetrieveResponse.Deprecated;
 
   /**
-   * Detailed description of what the tool does
+   * Detailed explanation of the tool's functionality and purpose
    */
   description: string;
 
@@ -128,7 +128,7 @@ export interface ToolRetrieveResponse {
   input_parameters: Record<string, unknown>;
 
   /**
-   * Human-readable name of the tool
+   * Human-readable display name of the tool
    */
   name: string;
 
@@ -148,7 +148,7 @@ export interface ToolRetrieveResponse {
   slug: string;
 
   /**
-   * List of tags associated with the tool for categorization
+   * List of tags associated with the tool for categorization and filtering
    */
   tags: Array<string>;
 
@@ -162,15 +162,36 @@ export interface ToolRetrieveResponse {
 
 export namespace ToolRetrieveResponse {
   export interface Deprecated {
+    /**
+     * List of all available versions for this tool
+     */
+    available_versions: Array<string>;
+
     /**
      * The display name of the tool
      */
     displayName: string;
 
     /**
-     * Whether the action is deprecated
+     * Indicates if this tool is deprecated and may be removed in the future
      */
     is_deprecated: boolean;
+
+    toolkit: Deprecated.Toolkit;
+
+    /**
+     * Current version identifier of the tool
+     */
+    version: string;
+  }
+
+  export namespace Deprecated {
+    export interface Toolkit {
+      /**
+       * URL to the toolkit logo image
+       */
+      logo: string;
+    }
   }
 
   export interface Toolkit {
@@ -201,6 +222,11 @@ export interface ToolListResponse {
 
 export namespace ToolListResponse {
   export interface Item {
+    /**
+     * List of all available versions for this tool
+     */
+    available_versions: Array<string>;
+
     deprecated: Item.Deprecated;
 
     /**
@@ -239,6 +265,11 @@ export namespace ToolListResponse {
     tags: Array<string>;
 
     toolkit: Item.Toolkit;
+
+    /**
+     * Current version of the tool
+     */
+    version: string;
   }
 
   export namespace Item {
@@ -276,6 +307,11 @@ export namespace ToolListResponse {
     }
 
     export interface Toolkit {
+      /**
+       * URL to the toolkit logo image
+       */
+      logo: string;
+
       /**
        * Human-readable name of the parent toolkit
        */
@@ -393,7 +429,7 @@ export interface ToolExecuteParams {
   /**
    * Enable debug tracing for tool execution (useful for debugging)
    */
-  allow_tracing?: boolean;
+  allow_tracing?: boolean | null;
 
   /**
    * Key-value pairs of arguments required by the tool (mutually exclusive with text)
@@ -411,18 +447,17 @@ export interface ToolExecuteParams {
    */
   custom_auth_params?: ToolExecuteParams.CustomAuthParams;
 
-  /**
-   * Entity identifier for multi-entity connected accounts (e.g. multiple
-   * repositories, organizations)
-   */
-  entity_id?: string;
-
   /**
    * Natural language description of the task to perform (mutually exclusive with
    * arguments)
    */
   text?: string;
 
+  /**
+   * User id for multi-user connected accounts (e.g. multiple users, organizations)
+   */
+  user_id?: string;
+
   /**
    * Tool version to execute (defaults to "latest" if not specified)
    */

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

@@ -56,10 +56,9 @@ export namespace TriggerInstanceListActiveResponse {
     connected_account_id: string;
 
     /**
-     * @deprecated DEPRECATED: This parameter will be removed in a future version.
-     * Please use connected_account_id instead.
+     * UUID of the connected account this trigger is associated with
      */
-    connectedAccountId: string;
+    connected_account_uuid: string;
 
     /**
      * ISO 8601 timestamp when the trigger instance was disabled, if applicable
@@ -86,28 +85,15 @@ export namespace TriggerInstanceListActiveResponse {
      */
     trigger_name: string;
 
-    /**
-     * @deprecated DEPRECATED: This parameter will be removed in a future version.
-     * Please use trigger_config instead.
-     */
-    triggerConfig: Record<string, unknown>;
-
-    /**
-     * @deprecated DEPRECATED: This parameter will be removed in a future version.
-     * Please use trigger_name instead.
-     */
-    triggerName: string;
-
     /**
      * ISO 8601 timestamp when the trigger instance was updated
      */
     updated_at: string;
 
     /**
-     * @deprecated DEPRECATED: This parameter will be removed in a future version.
-     * Please use updated_at instead.
+     * ID of the user this trigger is associated with
      */
-    updatedAt: string;
+    user_id: string;
 
     /**
      * Deprecated fields for the trigger instance
@@ -162,22 +148,14 @@ export interface TriggerInstanceListActiveParams {
    */
   auth_config_ids?: Array<string> | null;
 
-  /**
-   * @deprecated DEPRECATED: This parameter will be removed in a future version.
-   * Please use auth_config_ids instead.
-   */
-  authConfigIds?: Array<string> | null;
+  authConfigIds?: string;
 
   /**
    * Array of connected account IDs to filter triggers by
    */
   connected_account_ids?: Array<string> | null;
 
-  /**
-   * @deprecated DEPRECATED: This parameter will be removed in a future version.
-   * Please use connected_account_ids instead.
-   */
-  connectedAccountIds?: Array<string> | null;
+  connectedAccountIds?: string;
 
   /**
    * Array of auth config UUIDs to filter triggers by
@@ -204,11 +182,7 @@ export interface TriggerInstanceListActiveParams {
    */
   show_disabled?: boolean | null;
 
-  /**
-   * @deprecated DEPRECATED: This parameter will be removed in a future version.
-   * Please use show_disabled instead.
-   */
-  showDisabled?: boolean | null;
+  showDisabled?: string;
 
   /**
    * Array of trigger IDs to filter triggers by
@@ -220,17 +194,9 @@ export interface TriggerInstanceListActiveParams {
    */
   trigger_names?: Array<string> | null;
 
-  /**
-   * @deprecated DEPRECATED: This parameter will be removed in a future version.
-   * Please use trigger_ids instead.
-   */
-  triggerIds?: Array<string> | null;
+  triggerIds?: string;
 
-  /**
-   * @deprecated DEPRECATED: This parameter will be removed in a future version.
-   * Please use trigger_names instead.
-   */
-  triggerNames?: Array<string> | null;
+  triggerNames?: string;
 }
 
 export interface TriggerInstanceUpsertParams {
@@ -239,12 +205,6 @@ export interface TriggerInstanceUpsertParams {
    */
   connected_account_id?: string;
 
-  /**
-   * @deprecated DEPRECATED: This parameter will be removed in a future version.
-   * Please use connected_account_id instead.
-   */
-  connectedAuthId?: string;
-
   /**
    * Trigger configuration
    */

package/src/resources/triggers-types.ts

@@ -161,6 +161,11 @@ export namespace TriggersTypeListResponse {
      * Information about the toolkit that provides this trigger
      */
     export interface Toolkit {
+      /**
+       * Logo of the toolkit
+       */
+      logo: string;
+
       /**
        * Name of the parent toolkit
        */