Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
feat: Enrich API index pages with method, path, and description
Sushmithamallesha36f47e943e4
diff --git a/docs/content/reference/api-reference/auth-configs/index.mdx b/docs/content/reference/api-reference/auth-configs/index.mdxindex aacc31f16..777762b48 100644--- a/docs/content/reference/api-reference/auth-configs/index.mdx+++ b/docs/content/reference/api-reference/auth-configs/index.mdx@@ -9,9 +9,42 @@ Authentication configuration management## Endpoints-- [Create new authentication configuration](/reference/api-reference/auth-configs/create-new-authentication-configuration)-- [List authentication configurations with optional filters](/reference/api-reference/auth-configs/list-authentication-configurations-with-optional-filters)-- [Get single authentication configuration by ID](/reference/api-reference/auth-configs/get-single-authentication-configuration-by-id)-- [Update an authentication configuration](/reference/api-reference/auth-configs/update-an-authentication-configuration)-- [Delete an authentication configuration](/reference/api-reference/auth-configs/delete-an-authentication-configuration)-- [Enable or disable an authentication configuration](/reference/api-reference/auth-configs/enable-or-disable-an-authentication-configuration)+### POST `/api/v3/auth_configs`+**[Create new authentication configuration](/reference/api-reference/auth-configs/create-new-authentication-configuration)**++Creates a new auth config for a toolkit, allowing you to use your own OAuth credentials or API keys instead of Composio-managed authentication. This is required when you want to use custom OAuth apps (bring your own client ID/secret) or configure specific authentication parameters for a toolkit.++---++### GET `/api/v3/auth_configs`+**[List authentication configurations with optional filters](/reference/api-reference/auth-configs/list-authentication-configurations-with-optional-filters)**++Retrieves all auth configs for your project. Auth configs define how users authenticate with external services (OAuth, API keys, etc.). Use filters to find configs for specific toolkits or to distinguish between Composio-managed and custom configurations.++---++### GET `/api/v3/auth_configs/{nanoid}`+**[Get single authentication configuration by ID](/reference/api-reference/auth-configs/get-single-authentication-configuration-by-id)**++Retrieves detailed information about a specific authentication configuration using its unique identifier.++---++### PATCH `/api/v3/auth_configs/{nanoid}`+**[Update an authentication configuration](/reference/api-reference/auth-configs/update-an-authentication-configuration)**++Modifies an existing authentication configuration with new credentials or other settings. Only specified fields will be updated.++---++### DELETE `/api/v3/auth_configs/{nanoid}`+**[Delete an authentication configuration](/reference/api-reference/auth-configs/delete-an-authentication-configuration)**++Soft-deletes an authentication configuration by marking it as deleted in the database. This operation cannot be undone.++---++### PATCH `/api/v3/auth_configs/{nanoid}/{status}`+**[Enable or disable an authentication configuration](/reference/api-reference/auth-configs/enable-or-disable-an-authentication-configuration)**++Updates the status of an authentication configuration to either enabled or disabled. Disabled configurations cannot be used for new connections.diff --git a/docs/content/reference/api-reference/authentication/index.mdx b/docs/content/reference/api-reference/authentication/index.mdxindex 89925b28e..2db1a4ebe 100644--- a/docs/content/reference/api-reference/authentication/index.mdx+++ b/docs/content/reference/api-reference/authentication/index.mdx@@ -9,4 +9,7 @@ Authentication related endpoints## Endpoints-- [Get current user session information](/reference/api-reference/authentication/get-current-user-session-information)+### GET `/api/v3/auth/session/info`+**[Get current user session information](/reference/api-reference/authentication/get-current-user-session-information)**++Retrieves detailed information about the current authenticated user session, including project details, organization membership, and API key information if applicable. This endpoint is useful for verifying authentication status and retrieving contextual information about the authenticated user and their access privileges.diff --git a/docs/content/reference/api-reference/connected-accounts/index.mdx b/docs/content/reference/api-reference/connected-accounts/index.mdxindex e48dab824..aca0b1fb6 100644--- a/docs/content/reference/api-reference/connected-accounts/index.mdx+++ b/docs/content/reference/api-reference/connected-accounts/index.mdx@@ -9,10 +9,49 @@ Connected account management## Endpoints-- [List connected accounts with optional filters](/reference/api-reference/connected-accounts/list-connected-accounts-with-optional-filters)-- [Create a new connected account](/reference/api-reference/connected-accounts/create-a-new-connected-account)-- [Get connected account details by ID](/reference/api-reference/connected-accounts/get-connected-account-details-by-id)-- [Delete a connected account](/reference/api-reference/connected-accounts/delete-a-connected-account)-- [Enable or disable a connected account](/reference/api-reference/connected-accounts/enable-or-disable-a-connected-account)-- [Refresh authentication for a connected account](/reference/api-reference/connected-accounts/refresh-authentication-for-a-connected-account)-- [Create a new auth link session](/reference/api-reference/connected-accounts/create-a-new-auth-link-session)+### GET `/api/v3/connected_accounts`+**[List connected accounts with optional filters](/reference/api-reference/connected-accounts/list-connected-accounts-with-optional-filters)**++Retrieves all connected accounts for your project. Connected accounts represent authenticated user connections to external services (e.g., a user's Gmail account, Slack workspace). Filter by toolkit, status, user ID, or auth config to find specific connections.++---++### POST `/api/v3/connected_accounts`+**[Create a new connected account](/reference/api-reference/connected-accounts/create-a-new-connected-account)**++Initiates a new connection to an external service for a user. For OAuth-based toolkits, this returns a redirect URL to complete authentication. For API key-based toolkits, provide the credentials directly in the request body. Use the `user_id` field to associate the connection with a specific user in your system.++---++### GET `/api/v3/connected_accounts/{nanoid}`+**[Get connected account details by ID](/reference/api-reference/connected-accounts/get-connected-account-details-by-id)**++Retrieves comprehensive details of a connected account, including authentication configuration, connection status, and all parameters needed for API requests.++---++### DELETE `/api/v3/connected_accounts/{nanoid}`+**[Delete a connected account](/reference/api-reference/connected-accounts/delete-a-connected-account)**++Soft-deletes a connected account by marking it as deleted in the database. This prevents the account from being used for API calls but preserves the record for audit purposes.++---++### PATCH `/api/v3/connected_accounts/{nanoId}/status`+**[Enable or disable a connected account](/reference/api-reference/connected-accounts/enable-or-disable-a-connected-account)**++Updates the status of a connected account to either enabled (active) or disabled (inactive). Disabled accounts cannot be used for API calls but remain in the database.++---++### POST `/api/v3/connected_accounts/{nanoid}/refresh`+**[Refresh authentication for a connected account](/reference/api-reference/connected-accounts/refresh-authentication-for-a-connected-account)**++Initiates a new authentication flow for a connected account when credentials have expired or become invalid. This may generate a new authentication URL for OAuth flows or refresh tokens for other auth schemes.++---++### POST `/api/v3/connected_accounts/link`+**[Create a new auth link session](/reference/api-reference/connected-accounts/create-a-new-auth-link-session)**++Creates a new authentication link session that users can use to connect their accountsdiff --git a/docs/content/reference/api-reference/files/index.mdx b/docs/content/reference/api-reference/files/index.mdxindex f37bc1d86..f497e2af0 100644--- a/docs/content/reference/api-reference/files/index.mdx+++ b/docs/content/reference/api-reference/files/index.mdx@@ -9,5 +9,14 @@ File management## Endpoints-- [List files with optional app and action filters](/reference/api-reference/files/list-files-with-optional-app-and-action-filters)-- [Create presigned URL for request file upload to S3](/reference/api-reference/files/create-presigned-url-for-request-file-upload-to-s3)+### GET `/api/v3/files/list`+**[List files with optional app and action filters](/reference/api-reference/files/list-files-with-optional-app-and-action-filters)**++Retrieves a list of files associated with the authenticated project. Results can be filtered by toolkit and tool slugs.++---++### POST `/api/v3/files/upload/request`+**[Create presigned URL for request file upload to S3](/reference/api-reference/files/create-presigned-url-for-request-file-upload-to-s3)**++Generates a presigned URL for uploading a file to S3. This endpoint handles deduplication by checking if a file with the same MD5 hash already exists.diff --git a/docs/content/reference/api-reference/mcp/index.mdx b/docs/content/reference/api-reference/mcp/index.mdxindex 426e26237..a39fd4f27 100644--- a/docs/content/reference/api-reference/mcp/index.mdx+++ b/docs/content/reference/api-reference/mcp/index.mdx@@ -9,14 +9,77 @@ MCP server management## Endpoints-- [List MCP servers with optional filters and pagination](/reference/api-reference/mcp/list-mcp-servers-with-optional-filters-and-pagination)-- [Create a new MCP server](/reference/api-reference/mcp/create-a-new-mcp-server)-- [Create a new custom MCP server with multiple apps](/reference/api-reference/mcp/create-a-new-custom-mcp-server-with-multiple-apps)-- [Generate MCP URL with custom parameters](/reference/api-reference/mcp/generate-mcp-url-with-custom-parameters)-- [Get MCP server details by ID](/reference/api-reference/mcp/get-mcp-server-details-by-id)-- [Update MCP server configuration](/reference/api-reference/mcp/update-mcp-server-configuration)-- [Delete an MCP server](/reference/api-reference/mcp/delete-an-mcp-server)-- [List MCP servers for a specific app](/reference/api-reference/mcp/list-mcp-servers-for-a-specific-app)-- [List all instances for an MCP server](/reference/api-reference/mcp/list-all-instances-for-an-mcp-server)-- [Create a new MCP server instance](/reference/api-reference/mcp/create-a-new-mcp-server-instance)-- [Delete an MCP server instance and associated connected accounts](/reference/api-reference/mcp/delete-an-mcp-server-instance-and-associated-connected-accounts)+### GET `/api/v3/mcp/servers`+**[List MCP servers with optional filters and pagination](/reference/api-reference/mcp/list-mcp-servers-with-optional-filters-and-pagination)**++Retrieves a paginated list of MCP servers associated with the authenticated project. Results can be filtered by name, toolkit, or authentication configuration ID. MCP servers are used to provide Model Control Protocol integration points for connecting AI assistants to your applications and services.++---++### POST `/api/v3/mcp/servers`+**[Create a new MCP server](/reference/api-reference/mcp/create-a-new-mcp-server)**++Creates a new Model Control Protocol (MCP) server instance for the authenticated project. An MCP server provides a connection point for AI assistants to access your applications and services. The server is configured with specific authentication and tool permissions that determine what actions the connected assistants can perform.++---++### POST `/api/v3/mcp/servers/custom`+**[Create a new custom MCP server with multiple apps](/reference/api-reference/mcp/create-a-new-custom-mcp-server-with-multiple-apps)**++Creates a new Model Control Protocol (MCP) server instance that can integrate with multiple applications or toolkits simultaneously. This endpoint allows you to create a server that can access tools from different applications, making it suitable for complex workflows that span multiple services.++---++### POST `/api/v3/mcp/servers/generate`+**[Generate MCP URL with custom parameters](/reference/api-reference/mcp/generate-mcp-url-with-custom-parameters)**++Generates a Model Control Protocol (MCP) URL for an existing server with custom query parameters. The URL includes user-specific parameters and configuration flags that control the behavior of the MCP connection.++---++### GET `/api/v3/mcp/{id}`+**[Get MCP server details by ID](/reference/api-reference/mcp/get-mcp-server-details-by-id)**++Retrieves detailed configuration information for a specific Model Control Protocol (MCP) server. The returned data includes connection details, associated applications, enabled tools, and authentication configuration.++---++### PATCH `/api/v3/mcp/{id}`+**[Update MCP server configuration](/reference/api-reference/mcp/update-mcp-server-configuration)**++Updates the configuration of an existing Model Control Protocol (MCP) server. You can modify the server name, associated applications, and enabled tools. Only the fields included in the request will be updated.++---++### DELETE `/api/v3/mcp/{id}`+**[Delete an MCP server](/reference/api-reference/mcp/delete-an-mcp-server)**++Performs a soft delete on a Model Control Protocol (MCP) server, making it unavailable for future use. This operation is reversible in the database but cannot be undone through the API. Any applications or services connected to this server will lose access after deletion.++---++### GET `/api/v3/mcp/app/{appKey}`+**[List MCP servers for a specific app](/reference/api-reference/mcp/list-mcp-servers-for-a-specific-app)**++Retrieves a paginated list of Model Control Protocol (MCP) servers that are configured for a specific application or toolkit. This endpoint allows you to find all MCP server instances that have access to a particular application, such as GitHub, Slack, or Jira.++---++### GET `/api/v3/mcp/servers/{serverId}/instances`+**[List all instances for an MCP server](/reference/api-reference/mcp/list-all-instances-for-an-mcp-server)**++Retrieves a paginated list of user instances (user IDs) associated with a specific Model Control Protocol (MCP) server. This endpoint supports pagination to handle servers with many instances.++---++### POST `/api/v3/mcp/servers/{serverId}/instances`+**[Create a new MCP server instance](/reference/api-reference/mcp/create-a-new-mcp-server-instance)**++Creates a new instance for a Model Control Protocol (MCP) server. This endpoint validates that the user has connected accounts for all auth configurations associated with the MCP server before creating the instance.++---++### DELETE `/api/v3/mcp/servers/{serverId}/instances/{instanceId}`+**[Delete an MCP server instance and associated connected accounts](/reference/api-reference/mcp/delete-an-mcp-server-instance-and-associated-connected-accounts)**++Removes a user instance from the MCP server and deletes all connected accounts for that user that are associated with the auth configurations of this specific MCP server. Connected accounts for other auth configurations are not affected.diff --git a/docs/content/reference/api-reference/migration/index.mdx b/docs/content/reference/api-reference/migration/index.mdxindex 1ad67a273..4cc2032f1 100644--- a/docs/content/reference/api-reference/migration/index.mdx+++ b/docs/content/reference/api-reference/migration/index.mdx@@ -9,4 +9,7 @@ Endpoints to help with migration from v1 to v3## Endpoints-- [Get NanoId from UUID](/reference/api-reference/migration/get-nanoid-from-uuid)+### GET `/api/v3/migration/get-nanoid`+**[Get NanoId from UUID](/reference/api-reference/migration/get-nanoid-from-uuid)**++Convert a legacy UUID to its corresponding NanoId for migration purposes. This endpoint facilitates the transition from UUID-based identifiers to the more compact NanoId format used in the v3 API.diff --git a/docs/content/reference/api-reference/projects/index.mdx b/docs/content/reference/api-reference/projects/index.mdxindex a8c59772c..21ebf278f 100644--- a/docs/content/reference/api-reference/projects/index.mdx+++ b/docs/content/reference/api-reference/projects/index.mdx@@ -9,10 +9,49 @@ Projects API endpoints## Endpoints-- [Get project configuration](/reference/api-reference/projects/get-project-configuration)-- [Update project configuration](/reference/api-reference/projects/update-project-configuration)-- [Create a new project](/reference/api-reference/projects/create-a-new-project)-- [List all projects](/reference/api-reference/projects/list-all-projects)-- [Get project details by ID With Org Api key](/reference/api-reference/projects/get-project-details-by-id-with-org-api-key)-- [Delete a project](/reference/api-reference/projects/delete-a-project)-- [Delete and generate new API key for project](/reference/api-reference/projects/delete-and-generate-new-api-key-for-project)+### GET `/api/v3/org/project/config`+**[Get project configuration](/reference/api-reference/projects/get-project-configuration)**++Retrieves the current project configuration including 2FA settings.++---++### PATCH `/api/v3/org/project/config`+**[Update project configuration](/reference/api-reference/projects/update-project-configuration)**++Updates the project configuration settings.++---++### POST `/api/v3/org/owner/project/new`+**[Create a new project](/reference/api-reference/projects/create-a-new-project)**++Creates a new project within the authenticated user's organization using the specified name. Projects are isolated environments within your organization, each with their own API keys, webhook configurations, and resources. Use this endpoint to create additional projects for different environments (e.g., development, staging, production) or for separate applications.++---++### GET `/api/v3/org/owner/project/list`+**[List all projects](/reference/api-reference/projects/list-all-projects)**++Retrieves all projects belonging to the authenticated organization. Projects are returned in descending order of creation date (newest first). This endpoint is useful for displaying project selection in dashboards or for integrations that need to list all available projects.++---++### GET `/api/v3/org/owner/project/{nano_id}`+**[Get project details by ID With Org Api key](/reference/api-reference/projects/get-project-details-by-id-with-org-api-key)**++Retrieves detailed information about a specific project using its unique identifier. This endpoint provides complete project configuration including webhook URLs, creation and update timestamps, and webhook secrets. Use this endpoint to inspect project settings or verify project configuration.++---++### DELETE `/api/v3/org/owner/project/{nano_id}`+**[Delete a project](/reference/api-reference/projects/delete-a-project)**++Soft-deletes a project within the organization by its unique identifier. When a project is deleted, it is marked as deleted but not immediately removed from the database. This operation affects all resources associated with the project including API keys, webhook configurations, and connected services. This action cannot be undone through the API.++---++### POST `/api/v3/org/owner/project/{nano_id}/regenerate_api_key`+**[Delete and generate new API key for project](/reference/api-reference/projects/delete-and-generate-new-api-key-for-project)**++Generates a new API key for the specified project, invalidating any existing API keys for that project. This operation creates a fresh API key with a new random name and key value. All existing API keys for this project will be marked as deleted.diff --git a/docs/content/reference/api-reference/tool-router/index.mdx b/docs/content/reference/api-reference/tool-router/index.mdxindex 78e6fa6a0..567e61f45 100644--- a/docs/content/reference/api-reference/tool-router/index.mdx+++ b/docs/content/reference/api-reference/tool-router/index.mdx@@ -9,10 +9,49 @@ description: "(Labs) Tool router endpoints"## Endpoints-- [Create a new tool router session](/reference/api-reference/tool-router/create-a-new-tool-router-session)-- [Execute a tool within a tool router session](/reference/api-reference/tool-router/execute-a-tool-within-a-tool-router-session)-- [Execute a meta tool within a tool router session](/reference/api-reference/tool-router/execute-a-meta-tool-within-a-tool-router-session)-- [Get a tool router session by ID](/reference/api-reference/tool-router/get-a-tool-router-session-by-id)-- [Create a link session for a toolkit in a tool router session](/reference/api-reference/tool-router/create-a-link-session-for-a-toolkit-in-a-tool-router-session)-- [Get toolkits for a tool router session](/reference/api-reference/tool-router/get-toolkits-for-a-tool-router-session)-- [List meta tools with schemas for a tool router session](/reference/api-reference/tool-router/list-meta-tools-with-schemas-for-a-tool-router-session)+### POST `/api/v3/tool_router/session`+**[Create a new tool router session](/reference/api-reference/tool-router/create-a-new-tool-router-session)**++Creates a new session for the tool router feature. This endpoint initializes a new session with specified toolkits and their authentication configurations. The session provides an isolated environment for testing and managing tool routing logic with scoped MCP server access.++---++### POST `/api/v3/tool_router/session/{session_id}/execute`+**[Execute a tool within a tool router session](/reference/api-reference/tool-router/execute-a-tool-within-a-tool-router-session)**++Executes a specific tool within a tool router session. The toolkit is automatically inferred from the tool slug. The tool must belong to an allowed toolkit and must not be disabled in the session configuration. This endpoint validates permissions, resolves connected accounts, and executes the tool with the session context.++---++### POST `/api/v3/tool_router/session/{session_id}/execute_meta`+**[Execute a meta tool within a tool router session](/reference/api-reference/tool-router/execute-a-meta-tool-within-a-tool-router-session)**++Executes a Composio meta tool (COMPOSIO_*) within a tool router session.++---++### GET `/api/v3/tool_router/session/{session_id}`+**[Get a tool router session by ID](/reference/api-reference/tool-router/get-a-tool-router-session-by-id)**++Retrieves an existing tool router session by its ID. Returns the session configuration, MCP server URL, and available tools.++---++### POST `/api/v3/tool_router/session/{session_id}/link`+**[Create a link session for a toolkit in a tool router session](/reference/api-reference/tool-router/create-a-link-session-for-a-toolkit-in-a-tool-router-session)**++Initiates an authentication link session for a specific toolkit within a tool router session. Returns a link token and redirect URL that users can use to complete the OAuth flow.++---++### GET `/api/v3/tool_router/session/{session_id}/toolkits`+**[Get toolkits for a tool router session](/reference/api-reference/tool-router/get-toolkits-for-a-tool-router-session)**++Retrieves a cursor-paginated list of toolkits available in the tool router session. Includes toolkit metadata, composio-managed auth schemes, and connected accounts if available. Optionally filter by specific toolkit slugs.++---++### GET `/api/v3/tool_router/session/{session_id}/tools`+**[List meta tools with schemas for a tool router session](/reference/api-reference/tool-router/list-meta-tools-with-schemas-for-a-tool-router-session)**++Returns the meta tools available in a tool router session with their complete schemas. This includes request and response schemas specific to the session context.diff --git a/docs/content/reference/api-reference/toolkits/index.mdx b/docs/content/reference/api-reference/toolkits/index.mdxindex d3bf75d3c..febdc104f 100644--- a/docs/content/reference/api-reference/toolkits/index.mdx+++ b/docs/content/reference/api-reference/toolkits/index.mdx@@ -9,8 +9,35 @@ Toolkit and tool management## Endpoints-- [List available toolkits](/reference/api-reference/toolkits/list-available-toolkits)-- [List toolkit categories](/reference/api-reference/toolkits/list-toolkit-categories)-- [Get toolkit by slug](/reference/api-reference/toolkits/get-toolkit-by-slug)-- [Fetch multiple toolkits](/reference/api-reference/toolkits/fetch-multiple-toolkits)-- [Get toolkits changelog](/reference/api-reference/toolkits/get-toolkits-changelog)+### GET `/api/v3/toolkits`+**[List available toolkits](/reference/api-reference/toolkits/list-available-toolkits)**++Retrieves a comprehensive list of toolkits of their latest versions that are available to the authenticated project. Toolkits represent integration points with external services and applications, each containing a collection of tools and triggers. This endpoint supports filtering by category and management type, as well as different sorting options.++---++### GET `/api/v3/toolkits/categories`+**[List toolkit categories](/reference/api-reference/toolkits/list-toolkit-categories)**++Retrieves a comprehensive list of all available toolkit categories from their latest versions. These categories can be used to filter toolkits by type or purpose when using the toolkit listing endpoint. Categories help organize toolkits into logical groups based on their functionality or industry focus.++---++### GET `/api/v3/toolkits/{slug}`+**[Get toolkit by slug](/reference/api-reference/toolkits/get-toolkit-by-slug)**++Retrieves comprehensive information about a specific toolkit using its unique slug identifier. This endpoint provides detailed metadata, authentication configuration options, and feature counts for the requested toolkit.++---++### POST `/api/v3/toolkits/multi`+**[Fetch multiple toolkits](/reference/api-reference/toolkits/fetch-multiple-toolkits)**++Retrieves a comprehensive list of toolkits of their latest versions that are available to the authenticated project. Toolkits represent integration points with external services and applications, each containing a collection of tools and triggers. This endpoint supports filtering by category and management type, as well as different sorting options. You can optionally specify a list of toolkit slugs to fetch specific toolkits.++---++### GET `/api/v3/toolkits/changelog`+**[Get toolkits changelog](/reference/api-reference/toolkits/get-toolkits-changelog)**++Retrieves the last 10 versions changelog for all toolkits. This endpoint provides version history and changelog information for each toolkit.diff --git a/docs/content/reference/api-reference/tools/index.mdx b/docs/content/reference/api-reference/tools/index.mdxindex 84a0b12fa..4d10a31b7 100644--- a/docs/content/reference/api-reference/tools/index.mdx+++ b/docs/content/reference/api-reference/tools/index.mdx@@ -9,9 +9,42 @@ Tool execution endpoints## Endpoints-- [List available tools](/reference/api-reference/tools/list-available-tools)-- [Get tool enum list](/reference/api-reference/tools/get-tool-enum-list)-- [Get tool by slug](/reference/api-reference/tools/get-tool-by-slug)-- [Execute tool](/reference/api-reference/tools/execute-tool)-- [Generate tool inputs from natural language](/reference/api-reference/tools/generate-tool-inputs-from-natural-language)-- [Execute proxy request](/reference/api-reference/tools/execute-proxy-request)+### GET `/api/v3/tools`+**[List available tools](/reference/api-reference/tools/list-available-tools)**++Retrieve a paginated list of available tools with comprehensive filtering, sorting and search capabilities. Use query parameters to narrow down results by toolkit, tags, or search terms.++---++### GET `/api/v3/tools/enum`+**[Get tool enum list](/reference/api-reference/tools/get-tool-enum-list)**++Retrieve a list of all available tool enumeration values (tool slugs) from latest version of each toolkit. This endpoint returns a comma-separated string of tool slugs that can be used in other API calls.++---++### GET `/api/v3/tools/{tool_slug}`+**[Get tool by slug](/reference/api-reference/tools/get-tool-by-slug)**++Retrieve detailed information about a specific tool using its slug identifier. This endpoint returns full metadata about a tool including input/output parameters, versions, and toolkit information.++---++### POST `/api/v3/tools/execute/{tool_slug}`+**[Execute tool](/reference/api-reference/tools/execute-tool)**++Execute a specific tool operation with provided arguments and authentication. This is the primary endpoint for integrating with third-party services and executing tools. You can provide structured arguments or use natural language processing by providing a text description of what you want to accomplish.++---++### POST `/api/v3/tools/execute/{tool_slug}/input`+**[Generate tool inputs from natural language](/reference/api-reference/tools/generate-tool-inputs-from-natural-language)**++Uses AI to translate a natural language description into structured arguments for a specific tool. This endpoint is useful when you want to let users describe what they want to do in plain language instead of providing structured parameters.++---++### POST `/api/v3/tools/execute/proxy`+**[Execute proxy request](/reference/api-reference/tools/execute-proxy-request)**++Proxy an HTTP request to a third-party API using connected account credentials. This endpoint allows making authenticated API calls to external services while abstracting away authentication details.diff --git a/docs/content/reference/api-reference/triggers/index.mdx b/docs/content/reference/api-reference/triggers/index.mdxindex 65e3638b0..49dd0a719 100644--- a/docs/content/reference/api-reference/triggers/index.mdx+++ b/docs/content/reference/api-reference/triggers/index.mdx@@ -9,10 +9,49 @@ Trigger management and execution## Endpoints-- [Create or update a trigger](/reference/api-reference/triggers/create-or-update-a-trigger)-- [List active triggers](/reference/api-reference/triggers/list-active-triggers)-- [Delete a trigger](/reference/api-reference/triggers/delete-a-trigger)-- [Enable or disable a trigger](/reference/api-reference/triggers/enable-or-disable-a-trigger)-- [List trigger type enums](/reference/api-reference/triggers/list-trigger-type-enums)-- [Get trigger type by slug](/reference/api-reference/triggers/get-trigger-type-by-slug)-- [List trigger types](/reference/api-reference/triggers/list-trigger-types)+### POST `/api/v3/trigger_instances/{slug}/upsert`+**[Create or update a trigger](/reference/api-reference/triggers/create-or-update-a-trigger)**++Creates a new trigger instance or updates an existing one with the same configuration. Triggers listen for events from external services (webhooks or polling) and can invoke your workflows. If a matching trigger already exists and is disabled, it will be re-enabled. Requires a connected account ID to associate the trigger with a specific user connection.++---++### GET `/api/v3/trigger_instances/active`+**[List active triggers](/reference/api-reference/triggers/list-active-triggers)**++Retrieves all active trigger instances for your project. Triggers listen for events from connected accounts (e.g., new emails, Slack messages, GitHub commits) and can invoke webhooks or workflows. Use filters to find triggers for specific users, connected accounts, or trigger types.++---++### DELETE `/api/v3/trigger_instances/manage/{triggerId}`+**[Delete a trigger](/reference/api-reference/triggers/delete-a-trigger)**++Permanently deletes a trigger instance. This stops the trigger from listening for events and removes it from your project. Use the PATCH endpoint with status "disable" if you want to temporarily pause a trigger instead.++---++### PATCH `/api/v3/trigger_instances/manage/{triggerId}`+**[Enable or disable a trigger](/reference/api-reference/triggers/enable-or-disable-a-trigger)**++Updates the status of a trigger instance to enable or disable it. Disabling a trigger pauses event listening without deleting the trigger configuration. Re-enabling restores the trigger to its active state. Use this for temporary maintenance or to control trigger execution.++---++### GET `/api/v3/triggers_types/list/enum`+**[List trigger type enums](/reference/api-reference/triggers/list-trigger-type-enums)**++Retrieves a list of all available trigger type enum values that can be used across the API from latest versions of the toolkit only++---++### GET `/api/v3/triggers_types/{slug}`+**[Get trigger type by slug](/reference/api-reference/triggers/get-trigger-type-by-slug)**++Retrieve detailed information about a specific trigger type using its slug identifier++---++### GET `/api/v3/triggers_types`+**[List trigger types](/reference/api-reference/triggers/list-trigger-types)**++Retrieve a list of available trigger types with optional filtering by toolkit. Results are paginated and can be filtered by toolkit.diff --git a/docs/scripts/generate-api-index.ts b/docs/scripts/generate-api-index.tsindex c48b1440d..742fefa48 100644--- a/docs/scripts/generate-api-index.ts+++ b/docs/scripts/generate-api-index.ts@@ -65,12 +65,17 @@ function generateIndexPages() {const tagSlug = slugify(tagName);const tagDescription = tagDescriptions[tagName] || `${tagName} API endpoints`;- // Generate endpoint links- const endpointLinks = operations.map(op => {+ // Generate endpoint sections with method, path, and description+ const endpointSections = operations.map(op => {const endpointSlug = slugify(op.summary);const url = `/reference/api-reference/${tagSlug}/${endpointSlug}`;- return `- [${op.summary}](${url})`;- }).join('\n');+ const description = op.description || '';++ return `### ${op.method} \`${op.path}\`+**[${op.summary}](${url})**++${description}`;+ }).join('\n\n---\n\n');const content = `---title: ${tagName}@@ -83,7 +88,7 @@ ${tagDescription}## Endpoints-${endpointLinks}+${endpointSections}`;// Create folder and write index.mdx inside