@composio/client 0.1.0-alpha.15 → 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,
@@ -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/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/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/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,
+  };
+}

package/src/resources/{auth → v3/auth}/auth.ts

@@ -1,8 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../core/resource';
+import { APIResource } from '../../../core/resource';
 import * as SessionAPI from './session';
-import { Session, SessionRetrieveResponse } from './session';
+import { Session, SessionRetrieveInfoResponse } from './session';
 
 export class Auth extends APIResource {
   session: SessionAPI.Session = new SessionAPI.Session(this._client);
@@ -11,5 +11,5 @@ export class Auth extends APIResource {
 Auth.Session = Session;
 
 export declare namespace Auth {
-  export { Session as Session, type SessionRetrieveResponse as SessionRetrieveResponse };
+  export { Session as Session, type SessionRetrieveInfoResponse as SessionRetrieveInfoResponse };
 }

package/src/resources/{auth → v3/auth}/index.ts

@@ -1,4 +1,4 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Auth } from './auth';
-export { Session, type SessionRetrieveResponse } from './session';
+export { Session, type SessionRetrieveInfoResponse } from './session';

package/src/resources/{auth → v3/auth}/session.ts

@@ -1,8 +1,8 @@
 // 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 { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
 
 export class Session extends APIResource {
   /**
@@ -11,8 +11,14 @@ export class Session extends APIResource {
    * applicable. This endpoint is useful for verifying authentication status and
    * retrieving contextual information about the authenticated user and their access
    * privileges.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.v3.auth.session.retrieveInfo();
+   * ```
    */
-  retrieve(options?: RequestOptions): APIPromise<SessionRetrieveResponse> {
+  retrieveInfo(options?: RequestOptions): APIPromise<SessionRetrieveInfoResponse> {
     return this._client.get('/api/v3/auth/session/info', options);
   }
 }
@@ -20,25 +26,25 @@ export class Session extends APIResource {
 /**
  * Response containing user session information
  */
-export interface SessionRetrieveResponse {
+export interface SessionRetrieveInfoResponse {
   /**
    * Details of the API key used for authentication (null if using session auth)
    */
-  api_key: SessionRetrieveResponse.APIKey | null;
+  api_key: SessionRetrieveInfoResponse.APIKey | null;
 
   /**
    * Information about the authenticated user
    */
-  org_member: SessionRetrieveResponse.OrgMember;
+  org_member: SessionRetrieveInfoResponse.OrgMember;
 
   /**
    * Details of the current active project (null if accessing with org-level
    * credentials)
    */
-  project: SessionRetrieveResponse.Project | null;
+  project: SessionRetrieveInfoResponse.Project | null;
 }
 
-export namespace SessionRetrieveResponse {
+export namespace SessionRetrieveInfoResponse {
   /**
    * Details of the API key used for authentication (null if using session auth)
    */
@@ -288,5 +294,5 @@ export namespace SessionRetrieveResponse {
 }
 
 export declare namespace Session {
-  export { type SessionRetrieveResponse as SessionRetrieveResponse };
+  export { type SessionRetrieveInfoResponse as SessionRetrieveInfoResponse };
 }