Optional
apiOptional
baseOptional
entityPrivate
_wrap_Optional
actions?: Optional<Sequence<string>>Optional
entityId: Optional<string>Composio toolset for OpenAI framework.
+Example:
+
+
+Optional
apiOptional
baseOptional
entityPrivate
apiPrivate
basePrivate
httpPrivate
getStatic
generateStatic
validateThe Actions
class provides methods to interact with the Composio platform's actions.
+It allows fetching details of specific actions, listing all actions, and executing actions.
get
method retrieves details of a specific action.list
method retrieves a list of all actions.execute
method executes a specific action.Each method returns a CancelablePromise
which can be canceled. If canceled, the promise
+will reject with a Cancellation
object.
The client configuration object type.
+The methods in this class are grouped under 'Actions Methods' and provide functionalities +to interact with actions in the Composio platform. This includes fetching, listing, and +executing actions.
+Private
Readonly
clientExecutes a specific action in the Composio platform.
+This method allows you to trigger the execution of an action by providing its name and the necessary input parameters. The request includes the connected account ID to identify the app connection to use for the action, and the input parameters required by the action. The response provides details about the execution status and the response data returned by the action.
+The data for the request.
+A promise that resolves to the execution status and response data.
+If the request fails.
+Retrieves details of a specific action in the Composio platform by providing its action name.
+The response includes the action's name, display name, description, input parameters, expected response, associated app information, and enabled status.
+The data for the request.
+A promise that resolves to the details of the action.
+If the request fails.
+Retrieves a list of all actions in the Composio platform.
+This method allows you to fetch a list of all the available actions. It supports pagination to handle large numbers of actions. The response includes an array of action objects, each containing information such as the action's name, display name, description, input parameters, expected response, associated app information, and enabled status.
+The data for the request.
+A promise that resolves to the list of all actions.
+If the request fails.
+Private
Readonly
clientDisables the previously disabled trigger.
+The data for the request.
+Id of the trigger
+A promise that resolves to the response of the enable request.
+If the request fails.
+Enables the previously disabled trigger.
+The data for the request.
+Id of the trigger
+A promise that resolves to the response of the enable request.
+If the request fails.
+Retrieves details of a specific active trigger in the Composio platform by providing its trigger name.
+The response includes the trigger's name, description, input parameters, expected response, associated app information, and enabled status.
+The data for the request.
+A promise that resolves to the details of the active trigger.
+If the request fails.
+Retrieves a list of all active triggers in the Composio platform.
+This method allows you to fetch a list of all the available active triggers. It supports pagination to handle large numbers of triggers. The response includes an array of trigger objects, each containing information such as the trigger's name, description, input parameters, expected response, associated app information, and enabled status.
+The data for the request.
+A promise that resolves to the list of all active triggers.
+If the request fails.
+Private
Readonly
clientRetrieves details of a specific app in the Composio platform.
+This method allows clients to fetch detailed information about a specific app by providing its unique key. The response includes the app's name, key, status, description, logo, categories, authentication schemes, and other metadata.
+The data for the request, including the app's unique key.
+A promise that resolves to the details of the app.
+If the request fails.
+Retrieves a list of all available apps in the Composio platform.
+This method allows clients to explore and discover the supported apps. It returns an array of app objects, each containing essential details such as the app's key, name, description, logo, categories, and unique identifier.
+A promise that resolves to the list of all apps.
+If the request fails.
+Private
Readonly
clientConnects an account to the Composio platform.
+This method allows you to connect an external app account with Composio. It requires the integration ID in the request body and returns the connection status, connection ID, and a redirect URL (if applicable) for completing the connection flow.
+The data for the request.
+A promise that resolves to the connection status and details.
+If the request fails.
+Retrieves details of a specific account connected to the Composio platform by providing its connected account ID.
+The response includes the integration ID, connection parameters (such as scope, base URL, client ID, token type, access token, etc.), connection ID, status, and creation/update timestamps.
+The data for the request.
+A promise that resolves to the details of the connected account.
+If the request fails.
+Initiates a new connected account on the Composio platform.
+This method allows you to start the process of connecting an external app account with Composio. It requires the integration ID and optionally the entity ID, additional parameters, and a redirect URL.
+The data for the request.
+A promise that resolves to the connection request model.
+If the request fails.
+Retrieves a list of all connected accounts in the Composio platform.
+It supports pagination and filtering based on various parameters such as app ID, integration ID, and connected account ID. The response includes an array of connection objects, each containing details like the connector ID, connection parameters, status, creation/update timestamps, and associated app information.
+The data for the request.
+A promise that resolves to the list of all connected accounts.
+If the request fails.
+Connection request model.
+The status of the connection.
+The unique identifier of the connected account.
+Optional
redirectUrl: null | string = nullThe redirect URL for completing the connection flow.
+Private
Readonly
clientSave user access data.
+The data to save.
+Optional
entityThe entity ID associated with the user.
+The field inputs to save.
+Optional
redirectThe redirect URL for completing the connection flow.
+The response from the server.
+Wait until the connection becomes active.
+Optional
timeout: number = 60The timeout period in seconds.
+The connected account model.
+If the connection does not become active within the timeout period.
+Private
Readonly
clientCreates a new integration in the Composio platform.
+This method allows clients to create a new integration by providing the necessary details such as app ID, name, authentication mode, and configuration.
+The data for the request.
+A promise that resolves to the created integration model.
+If the request fails.
+Retrieves details of a specific integration in the Composio platform by providing its integration name.
+The response includes the integration's name, display name, description, input parameters, expected response, associated app information, and enabled status.
+The data for the request.
+A promise that resolves to the details of the integration.
+If the request fails.
+Retrieves a list of all available integrations in the Composio platform.
+This method allows clients to explore and discover the supported integrations. It returns an array of integration objects, each containing essential details such as the integration's key, name, description, logo, categories, and unique identifier.
+A promise that resolves to the list of all integrations.
+If the request fails.
+Private
clientRetrieves a list of all triggers in the Composio platform.
+This method allows you to fetch a list of all the available triggers. It supports pagination to handle large numbers of triggers. The response includes an array of trigger objects, each containing information such as the trigger's name, description, input parameters, expected response, associated app information, and enabled status.
+The data for the request.
+A promise that resolves to the list of all triggers.
+If the request fails.
+Setup a trigger for a connected account.
+The data for the request.
+A promise that resolves to the setup trigger response.
+If the request fails.
++ +
Composio provides a platform that seamlessly integrates over 200+ apps with your AI agents, enhancing their utility and interactivity. It supports all the features you'll ever need:
+OAuth2
, OAuth1
, Basic
, API_KEY
.To get started, install the Composio SDK using the following command:
+npm install composio-core
+
+Checkout CONTRIBUTING.md
to get started with contributing to SDK. Feel free to reach out to us on Discord for any questions or issues. We value your feedback!
Optional
requestOptional
data?: { Optional
redirectOptional
userOptional
connectedOptional
connectionOptional
redirectOptional
requestOptional
appThe unique identifier of the app associated with the connector.
+Optional
authAn object containing the authentication configuration for the connector.
+Optional
api_The API key used for authentication with the app - if authScheme is API_KEY
+Optional
base_The base URL for making API requests to the app.
+Optional
client_The client ID used for authentication with the app - if authScheme is OAUTH2
+Optional
client_The client secret used for authentication with the app - if authScheme is OAUTH2
+Optional
consumer_The Consumer key used for authentication with the app - if authScheme is OAUTH1
+Optional
consumer_The Consumer secret used for authentication with the app - if authScheme is OAUTH1
+Optional
authThe authentication scheme used by the connector (e.g., "OAUTH2", "API_KEY").
+Optional
name?: stringThe name of the connector.
+Optional
useUse default Composio credentials to proceed. The developer app credentials will be of Composio.
+Optional
appThe unique identifier of the app associated with the connector.
+Optional
appThe name of the app associated with the connector.
+Optional
authAn object containing the authentication configuration for the connector.
+Optional
base_The base URL for making API requests to the app.
+Optional
client_The client ID used for authentication with the app.
+Optional
client_The client secret used for authentication with the app.
+Optional
authThe authentication scheme used by the connector.
+Optional
createdThe timestamp indicating when the connector was created.
+Optional
enabled?: booleanA boolean indicating whether the connector is enabled or not.
+Optional
expectedAn array of input fields expected by the connector.
+Optional
id?: stringThe unique identifier of the newly created connector.
+Optional
logo?: stringThe URL of the logo of the app associated with the connector.
+Optional
name?: stringThe name of the connector.
+Optional
updatedThe timestamp indicating when the connector was last updated.
+The unique identifier of the connection.
+Optional
status?: stringStatus of the api call.
+The name of the action to execute.
+Optional
requestOptional
appOptional
connectedThe unique identifier of the connection to use for executing the action.
+Optional
input?: { An object containing the input parameters for the action.
+Optional
execution_An object containing the details of the action execution.
+Optional
executed?: booleanA boolean indicating whether the action was executed successfully.
+Optional
response_An object containing the response data from the action execution.
+The unique identifier of the action.
+Optional
appThe unique identifier of the app associated with the action.
+Optional
appThe key of the app associated with the action.
+Optional
appThe name of the app associated with the action.
+Optional
description?: stringA description of the action.
+Optional
display_The display name of the action.
+Optional
enabled?: booleanA boolean indicating whether the action is enabled or not.
+Optional
logo?: stringThe URL of the logo of the app associated with the action.
+Optional
name?: stringThe name of the action.
+Optional
parameters?: { An object describing the input parameters of the action.
+Optional
properties?: { An object containing the properties of the input parameters.
+Optional
required?: string[]An array of required parameter names.
+Optional
title?: stringThe title of the input parameters.
+Optional
type?: stringThe type of the input parameters (e.g., "object").
+Optional
response?: { An object describing the response of the action.
+Optional
properties?: { An object containing the properties of the response.
+Optional
required?: string[]An array of required response field names.
+Optional
title?: stringThe title of the response.
+Optional
type?: stringThe type of the response (e.g., "object").
+The ID of the trigger to retrieve.
+Optional
connectionIdentifier for the connection associated with the trigger.
+Optional
createdTimestamp when the trigger was created.
+Optional
disabledTimestamp when the trigger was disabled, if applicable.
+Optional
id?: stringUnique identifier for the trigger.
+Optional
state?: { State information for the trigger.
+Optional
triggerConfiguration settings for the trigger.
+Optional
triggerData associated with the trigger.
+Optional
triggerName of the trigger.
+Optional
updatedTimestamp when the trigger was last updated.
+Optional
configuration_Optional
description?: stringOptional
docs?: stringOptional
documentation_Optional
logo?: stringOptional
testThe unique identifier of the connection.
+Optional
connectionAn object containing the parameters specific to the connection.
+Optional
access_The access token used for authentication with the connected app.
+Optional
base_The base URL for making API requests to the connected app.
+Optional
client_The client ID used for authentication with the connected app.
+Optional
client_The client secret used for authentication with the connected app.
+Optional
scope?: stringThe scope of permissions granted to the connection.
+Optional
token_The type of token used for authentication (e.g., "bearer").
+Optional
createdThe timestamp indicating when the connection was created.
+Optional
id?: stringThe unique identifier of the connection.
+The unique identifier of the connector associated with the connection.
+Optional
status?: "ACTIVE" | "INITIATED" | "FAILED"The status of the connection (e.g., "SUCCESS").
+Optional
updatedThe timestamp indicating when the connection was last updated.
+The unique identifier of the integration.
+Optional
appThe unique identifier of the app associated with the connector.
+Optional
appThe name of the app associated with the connector.
+Optional
authAn object containing the authentication configuration for the connector.
+Optional
base_The base URL for making API requests to the app.
+Optional
client_The client ID used for authentication with the app.
+Optional
client_The client secret used for authentication with the app.
+Optional
authThe authentication scheme used by the connector (e.g., "OAUTH2", "API_KEY").
+Optional
createdThe timestamp indicating when the connector was created.
+Optional
enabled?: booleanA boolean indicating whether the connector is enabled or not.
+Optional
expectedAn array of input fields expected by the connector.
+Optional
id?: stringThe unique identifier of the connector.
+Optional
logo?: stringThe URL of the logo of the app associated with the connector.
+Optional
name?: stringThe name of the connector.
+Optional
updatedThe timestamp indicating when the connector was last updated.
+Optional
actions?: stringFilter by Action names
+Optional
apps?: stringName of the apps like "github", "linear" seperated by a comma
+Optional
showShow all actions - i.e disable pagination
+Optional
showShow actions enabled for the API Key
+Optional
tags?: stringFilter by Action tags
+Optional
useFilter by use case
+Optional
usecaseLimit of use-cases based search
+Optional
items?: { An array of action objects.
+Optional
connectedFilter by Connected Account ids
+Optional
integrationFilter by Integration ids
+Optional
triggerFilter by Trigger ids
+Optional
triggerFilter by Trigger names
+Optional
pageOptional
currentThe current page number.
+Optional
perThe number of items per page.
+Optional
totalThe total number of pages.
+Optional
triggers?: { Optional
items?: { An array of app objects.
+Optional
integrationFilter by using specific Integration
+Optional
page?: numberPage number to fetch
+Optional
pagePage size to assume
+Optional
user_Filter by using specific entity id, seperated by comma
+Optional
items?: { Optional
page?: numberOptional
totalOptional
page?: numberPage number to fetch
+Optional
pagePage Size to assume
+Optional
items?: { Optional
page?: numberOptional
totalOptional
appName of the apps like "github", "linear" seperated by a comma
+Optional
connectedFilter by Aonnected Account ids
+Optional
showShow triggers enabled for the API Key
+Optional
appThe unique ID of the app.
+Optional
appThe key of the app.
+Optional
appThe name of the app.
+Optional
config?: { Optional
properties?: { Optional
description?: stringstring
+Optional
required?: string[]Optional
title?: stringstring
+Optional
type?: stringstring
+Optional
required?: string[]Optional
title?: stringOptional
type?: stringOptional
count?: numberThe count of the event.
+Optional
description?: stringA brief description of the event.
+Optional
display_The display name of the event.
+Optional
enabled?: booleanWhether the event is enabled.
+Optional
instructions?: stringInstructions for the event.
+Optional
logo?: stringThe URL of the app's logo image.
+Optional
name?: stringThe name of the event.
+Optional
payload?: { Optional
properties?: { The GitHub username of the commit author.
+The SHA of the commit.
+The commit message.
+The timestamp of the commit.
+The GitHub URL of the commit.
+The ID of the trigger to enable or disable.
+Optional
verifyThe unique identifier of the integration.
+Optional
requestOptional
enabled?: booleanAll the parameters that you see in the GET connector
+Optional
status?: stringOK
+Optional
appThe unique identifier of the app associated with the action.
+Optional
appThe name of the app associated with the action.
+Optional
description?: stringA description of the action.
+Optional
display_The display name of the action.
+Optional
enabled?: booleanA boolean indicating whether the action is enabled or not.
+Optional
logo?: stringThe URL of the logo of the app associated with the action.
+Optional
name?: stringThe name of the action.
+Optional
parameters?: { An object describing the input parameters of the action.
+Optional
properties?: { An object containing the properties of the input parameters.
+Optional
required?: string[]An array of required parameter names.
+Optional
title?: stringThe title of the input parameters.
+Optional
type?: stringThe type of the input parameters (e.g., "object").
+Optional
response?: { An object describing the response of the action.
+Optional
properties?: { An object containing the properties of the response.
+Optional
required?: string[]An array of required response field names.
+Optional
title?: stringThe title of the response.
+Optional
type?: stringThe type of the response (e.g., "object").
+Not Found
+OK
+Optional
execution_An object containing the details of the action execution.
+Optional
executed?: booleanA boolean indicating whether the action was executed successfully.
+Optional
response_An object containing the response data from the action execution.
+Not Found
+OK
+Optional
items?: { An array of app objects.
+OK
+Optional
items?: { Optional
page?: numberOptional
totalOK
+Optional
connectionOptional
connectionOptional
redirect{ +"message": "Connector not found" +}
+{ +"message": "Connection not found or already deleted" +}
+Optional
status?: stringStatus of the api call.
+Not Found
+OK
+Optional
connectionAn object containing the parameters specific to the connection.
+Optional
access_The access token used for authentication with the connected app.
+Optional
base_The base URL for making API requests to the connected app.
+Optional
client_The client ID used for authentication with the connected app.
+Optional
client_The client secret used for authentication with the connected app.
+Optional
scope?: stringThe scope of permissions granted to the connection.
+Optional
token_The type of token used for authentication (e.g., "bearer").
+Optional
createdThe timestamp indicating when the connection was created.
+Optional
id?: stringThe unique identifier of the connection.
+Optional
integrationThe unique identifier of the connector associated with the connection.
+Optional
status?: "ACTIVE" | "INITIATED" | "FAILED"The status of the connection (e.g., "SUCCESS").
+Optional
updatedThe timestamp indicating when the connection was last updated.
+{ +"message": "Connection not found or already deleted" +}
+OK
+Optional
items?: { Optional
page?: numberOptional
totalOK
+Optional
appThe unique identifier of the app associated with the connector.
+Optional
appThe name of the app associated with the connector.
+Optional
authAn object containing the authentication configuration for the connector.
+Optional
base_The base URL for making API requests to the app.
+Optional
client_The client ID used for authentication with the app.
+Optional
client_The client secret used for authentication with the app.
+Optional
authThe authentication scheme used by the connector.
+Optional
createdThe timestamp indicating when the connector was created.
+Optional
enabled?: booleanA boolean indicating whether the connector is enabled or not.
+Optional
expectedAn array of input fields expected by the connector.
+Optional
id?: stringThe unique identifier of the newly created connector.
+Optional
logo?: stringThe URL of the logo of the app associated with the connector.
+Optional
name?: stringThe name of the connector.
+Optional
updatedThe timestamp indicating when the connector was last updated.
+Bad Request
+OK
+Optional
appThe unique identifier of the app associated with the connector.
+Optional
appThe name of the app associated with the connector.
+Optional
authAn object containing the authentication configuration for the connector.
+Optional
base_The base URL for making API requests to the app.
+Optional
client_The client ID used for authentication with the app.
+Optional
client_The client secret used for authentication with the app.
+Optional
authThe authentication scheme used by the connector (e.g., "OAUTH2", "API_KEY").
+Optional
createdThe timestamp indicating when the connector was created.
+Optional
enabled?: booleanA boolean indicating whether the connector is enabled or not.
+Optional
expectedAn array of input fields expected by the connector.
+Optional
id?: stringThe unique identifier of the connector.
+Optional
logo?: stringThe URL of the logo of the app associated with the connector.
+Optional
name?: stringThe name of the connector.
+Optional
updatedThe timestamp indicating when the connector was last updated.
+Not Found
+OK
+Optional
status?: stringNot Found
+OK
+A list of active triggers
+Optional
pageOptional
currentThe current page number.
+Optional
perThe number of items per page.
+Optional
totalThe total number of pages.
+Optional
triggers?: { A successful response containing the details of the active trigger.
+Optional
connectionIdentifier for the connection associated with the trigger.
+Optional
createdTimestamp when the trigger was created.
+Optional
disabledTimestamp when the trigger was disabled, if applicable.
+Optional
id?: stringUnique identifier for the trigger.
+Optional
state?: { State information for the trigger.
+Optional
triggerConfiguration settings for the trigger.
+Optional
triggerData associated with the trigger.
+Optional
triggerName of the trigger.
+Optional
updatedTimestamp when the trigger was last updated.
+Trigger not found
+Internal server error
+OK
+Optional
items?: { An array of action objects.
+Optional
page?: numberThe current page number of the action list.
+Optional
totalThe total number of pages available for the action list.
+
Composio toolset for Langchain framework.
+Example:
+ +