@composio/client 0.1.0-alpha.14 → 0.1.0-alpha.16

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,
@@ -84,12 +85,9 @@ export {
 } from './tools';
 export {
   TriggerInstances,
-  type TriggerInstanceDeleteResponse,
   type TriggerInstanceListActiveResponse,
-  type TriggerInstanceUpdateStatusResponse,
   type TriggerInstanceUpsertResponse,
   type TriggerInstanceListActiveParams,
-  type TriggerInstanceUpdateStatusParams,
   type TriggerInstanceUpsertParams,
 } from './trigger-instances/trigger-instances';
 export {
@@ -99,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/tools.ts

@@ -411,18 +411,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/index.ts

@@ -7,13 +7,16 @@ export {
   type HandleRetrieveParams,
   type HandleExecuteParams,
 } from './handle';
+export {
+  Manage,
+  type ManageUpdateResponse,
+  type ManageDeleteResponse,
+  type ManageUpdateParams,
+} from './manage';
 export {
   TriggerInstances,
-  type TriggerInstanceDeleteResponse,
   type TriggerInstanceListActiveResponse,
-  type TriggerInstanceUpdateStatusResponse,
   type TriggerInstanceUpsertResponse,
   type TriggerInstanceListActiveParams,
-  type TriggerInstanceUpdateStatusParams,
   type TriggerInstanceUpsertParams,
 } from './trigger-instances';

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

@@ -0,0 +1,46 @@
+// 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';
+import { path } from '../../internal/utils/path';
+
+export class Manage extends APIResource {
+  update(
+    triggerID: string,
+    body: ManageUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<ManageUpdateResponse> {
+    return this._client.patch(path`/api/v3/trigger_instances/manage/${triggerID}`, { body, ...options });
+  }
+
+  delete(triggerID: string, options?: RequestOptions): APIPromise<ManageDeleteResponse> {
+    return this._client.delete(path`/api/v3/trigger_instances/manage/${triggerID}`, options);
+  }
+}
+
+export interface ManageUpdateResponse {
+  /**
+   * Status of the operation
+   */
+  status: 'success';
+}
+
+export interface ManageDeleteResponse {
+  /**
+   * The ID of the deleted trigger instance
+   */
+  trigger_id: string;
+}
+
+export interface ManageUpdateParams {
+  status: 'enable' | 'disable';
+}
+
+export declare namespace Manage {
+  export {
+    type ManageUpdateResponse as ManageUpdateResponse,
+    type ManageDeleteResponse as ManageDeleteResponse,
+    type ManageUpdateParams as ManageUpdateParams,
+  };
+}

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

@@ -9,16 +9,15 @@ import {
   HandleRetrieveParams,
   HandleRetrieveResponse,
 } from './handle';
+import * as ManageAPI from './manage';
+import { Manage, ManageDeleteResponse, ManageUpdateParams, ManageUpdateResponse } from './manage';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class TriggerInstances extends APIResource {
   handle: HandleAPI.Handle = new HandleAPI.Handle(this._client);
-
-  delete(triggerID: string, options?: RequestOptions): APIPromise<TriggerInstanceDeleteResponse> {
-    return this._client.delete(path`/api/v3/trigger_instances/delete/${triggerID}`, options);
-  }
+  manage: ManageAPI.Manage = new ManageAPI.Manage(this._client);
 
   listActive(
     query: TriggerInstanceListActiveParams | null | undefined = {},
@@ -27,15 +26,6 @@ export class TriggerInstances extends APIResource {
     return this._client.get('/api/v3/trigger_instances/active', { query, ...options });
   }
 
-  updateStatus(
-    status: 'enable' | 'disable',
-    params: TriggerInstanceUpdateStatusParams,
-    options?: RequestOptions,
-  ): APIPromise<TriggerInstanceUpdateStatusResponse> {
-    const { triggerId } = params;
-    return this._client.patch(path`/api/v3/trigger_instances/id/${triggerId}/${status}`, options);
-  }
-
   upsert(
     slug: string,
     body: TriggerInstanceUpsertParams | null | undefined = {},
@@ -45,13 +35,6 @@ export class TriggerInstances extends APIResource {
   }
 }
 
-export interface TriggerInstanceDeleteResponse {
-  /**
-   * The ID of the deleted trigger instance
-   */
-  triggerId: string;
-}
-
 export interface TriggerInstanceListActiveResponse {
   items: Array<TriggerInstanceListActiveResponse.Item>;
 
@@ -73,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
@@ -103,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
@@ -155,20 +124,13 @@ export namespace TriggerInstanceListActiveResponse {
   }
 }
 
-export interface TriggerInstanceUpdateStatusResponse {
-  /**
-   * Status of the operation
-   */
-  status: 'success';
-}
-
 export interface TriggerInstanceUpsertResponse {
   deprecated: TriggerInstanceUpsertResponse.Deprecated;
 
   /**
    * ID of the updated trigger
    */
-  triggerId: string;
+  trigger_id: string;
 }
 
 export namespace TriggerInstanceUpsertResponse {
@@ -186,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
@@ -228,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
@@ -244,24 +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;
-}
-
-export interface TriggerInstanceUpdateStatusParams {
-  /**
-   * The ID of the trigger instance to update
-   */
-  triggerId: string;
+  triggerNames?: string;
 }
 
 export interface TriggerInstanceUpsertParams {
@@ -270,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
    */
@@ -288,15 +217,13 @@ export interface TriggerInstanceUpsertParams {
 }
 
 TriggerInstances.Handle = Handle;
+TriggerInstances.Manage = Manage;
 
 export declare namespace TriggerInstances {
   export {
-    type TriggerInstanceDeleteResponse as TriggerInstanceDeleteResponse,
     type TriggerInstanceListActiveResponse as TriggerInstanceListActiveResponse,
-    type TriggerInstanceUpdateStatusResponse as TriggerInstanceUpdateStatusResponse,
     type TriggerInstanceUpsertResponse as TriggerInstanceUpsertResponse,
     type TriggerInstanceListActiveParams as TriggerInstanceListActiveParams,
-    type TriggerInstanceUpdateStatusParams as TriggerInstanceUpdateStatusParams,
     type TriggerInstanceUpsertParams as TriggerInstanceUpsertParams,
   };
 
@@ -307,4 +234,11 @@ export declare namespace TriggerInstances {
     type HandleRetrieveParams as HandleRetrieveParams,
     type HandleExecuteParams as HandleExecuteParams,
   };
+
+  export {
+    Manage as Manage,
+    type ManageUpdateResponse as ManageUpdateResponse,
+    type ManageDeleteResponse as ManageDeleteResponse,
+    type ManageUpdateParams as ManageUpdateParams,
+  };
 }

package/src/resources/v3/admin.ts

@@ -0,0 +1,141 @@
+// 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 { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Admin extends APIResource {
+  /**
+   * Administrative endpoint that retrieves all active connections for a given
+   * toolkit slug. This is primarily used for token refresh operations and system
+   * maintenance. Only includes non-deleted connections with OAuth2 or JWT
+   * authentication types.
+   *
+   * @example
+   * ```ts
+   * const response = await client.v3.admin.listConnections({
+   *   toolkit_slug: 'google-drive',
+   *   'x-composio-admin-token': 'adm_123456789abcdef',
+   * });
+   * ```
+   */
+  listConnections(
+    params: AdminListConnectionsParams,
+    options?: RequestOptions,
+  ): APIPromise<AdminListConnectionsResponse> {
+    const { 'x-composio-admin-token': xComposioAdminToken, ...query } = params;
+    return this._client.get('/api/v3/admin/connections', {
+      query,
+      ...options,
+      headers: buildHeaders([{ 'x-composio-admin-token': xComposioAdminToken }, options?.headers]),
+    });
+  }
+
+  /**
+   * Administrative endpoint that refreshes authentication tokens for multiple
+   * connected accounts in parallel. This is useful for proactive token refresh to
+   * prevent authentication failures or for recovering from authentication issues
+   * across multiple connections.
+   *
+   * @example
+   * ```ts
+   * const response = await client.v3.admin.refreshAuthTokens({
+   *   connectionIds: ['conn_123abc', 'conn_456def'],
+   *   'x-composio-admin-token': 'adm_123456789abcdef',
+   * });
+   * ```
+   */
+  refreshAuthTokens(
+    params: AdminRefreshAuthTokensParams,
+    options?: RequestOptions,
+  ): APIPromise<AdminRefreshAuthTokensResponse> {
+    const { 'x-composio-admin-token': xComposioAdminToken, ...body } = params;
+    return this._client.post('/api/v3/admin/auth-refresh', {
+      body,
+      ...options,
+      headers: buildHeaders([{ 'x-composio-admin-token': xComposioAdminToken }, options?.headers]),
+    });
+  }
+}
+
+export interface AdminListConnectionsResponse {
+  /**
+   * Collection of account connection objects, may be empty if no connections exist
+   */
+  items: Array<AdminListConnectionsResponse.Item>;
+}
+
+export namespace AdminListConnectionsResponse {
+  export interface Item {
+    /**
+     * Identifier that can be used with other API endpoints that operate on connections
+     */
+    id: string;
+  }
+}
+
+export interface AdminRefreshAuthTokensResponse {
+  /**
+   * Array of connections that failed to refresh with detailed error information
+   */
+  failures: Array<AdminRefreshAuthTokensResponse.Failure>;
+
+  /**
+   * List of connections where token refresh was successful or not needed
+   */
+  success: Array<string>;
+}
+
+export namespace AdminRefreshAuthTokensResponse {
+  export interface Failure {
+    /**
+     * Connection ID that failed during refresh
+     */
+    connectionId: string;
+
+    /**
+     * Specific error code identifying why the refresh operation failed
+     */
+    error: string;
+  }
+}
+
+export interface AdminListConnectionsParams {
+  /**
+   * Query param: The unique identifier slug of the toolkit to filter connections by
+   */
+  toolkit_slug: string;
+
+  /**
+   * Header param: Admin authentication token required for administrative operations
+   */
+  'x-composio-admin-token': string;
+}
+
+export interface AdminRefreshAuthTokensParams {
+  /**
+   * Body param: List of connection identifiers that need token refresh
+   */
+  connectionIds: Array<string>;
+
+  /**
+   * Header param: Admin authentication token required for administrative operations
+   */
+  'x-composio-admin-token': string;
+
+  /**
+   * Body param: Controls processing speed and system load. Higher values process
+   * faster but increase load.
+   */
+  parallelism?: number;
+}
+
+export declare namespace Admin {
+  export {
+    type AdminListConnectionsResponse as AdminListConnectionsResponse,
+    type AdminRefreshAuthTokensResponse as AdminRefreshAuthTokensResponse,
+    type AdminListConnectionsParams as AdminListConnectionsParams,
+    type AdminRefreshAuthTokensParams as AdminRefreshAuthTokensParams,
+  };
+}