@devries-cameron20 / composio-1 / commits / b55c0710f
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs: update toolkits, API spec, and meta tools data (#3238)

github-actions[bot] committed May 7, 2026 at 11:27 UTC b55c0710f2c708a1b3f37b5003869d9380f32959
14 files changed +27173 -16704
docs/content/reference/api-reference/consumer/index.mdx new
+12
@@ -0,0 +1,12 @@
1 +---
2 +title: Consumer
3 +description: "Consumer API endpoints"
4 +---
5 +
6 +{/* Auto-generated from OpenAPI spec. Do not edit directly. */}
7 +
8 +Consumer API endpoints
9 +
10 +## Endpoints
11 +
12 +<ApiEndpointsTable endpoints={[{"method":"GET","pathV31":"/api/v3.1/consumer/connected_accounts/{nanoid}/permissions","pathV3":"/api/v3/consumer/connected_accounts/{nanoid}/permissions","summary":"Get consumer tool permissions for a connected account","href":"/reference/api-reference/consumer/getConsumerConnectedAccountsByNanoidPermissions"},{"method":"PATCH","pathV31":"/api/v3.1/consumer/connected_accounts/{nanoid}/permissions","pathV3":"/api/v3/consumer/connected_accounts/{nanoid}/permissions","summary":"Upsert consumer tool permissions for a connected account","href":"/reference/api-reference/consumer/patchConsumerConnectedAccountsByNanoidPermissions"},{"method":"PATCH","pathV31":"/api/v3.1/consumer/connected_accounts/{nanoid}/permissions/tools/{tool_slug}","pathV3":"/api/v3/consumer/connected_accounts/{nanoid}/permissions/tools/{tool_slug}","summary":"Upsert one consumer tool permission for a connected account","href":"/reference/api-reference/consumer/patchConsumerConnectedAccountsByNanoidPermissionsToolsByToolSlug"},{"method":"POST","pathV31":"/api/v3.1/consumer/permissions/resolve","pathV3":"/api/v3/consumer/permissions/resolve","summary":"Resolve consumer tool-router permissions","href":"/reference/api-reference/consumer/postConsumerPermissionsResolve"}]} />
docs/content/reference/api-reference/invite-codes/index.mdx new
+12
@@ -0,0 +1,12 @@
1 +---
2 +title: Invite Codes
3 +description: "Invite Codes API endpoints"
4 +---
5 +
6 +{/* Auto-generated from OpenAPI spec. Do not edit directly. */}
7 +
8 +Invite Codes API endpoints
9 +
10 +## Endpoints
11 +
12 +<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/org/clanker/create_claim","pathV3":"/api/v3/org/clanker/create_claim","summary":"Create a clanker-claim slug","href":"/reference/api-reference/invite-codes/postOrgClankerCreateClaim"}]} />
docs/content/reference/api-reference/tool-router/index.mdx
+1 -1
@@ -9,4 +9,4 @@ description: "(Labs) Tool router endpoints"
9
10 ## Endpoints
11
12 -<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/tool_router/session","pathV3":"/api/v3/tool_router/session","summary":"Create a new tool router session","href":"/reference/api-reference/tool-router/postToolRouterSession"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/execute","pathV3":"/api/v3/tool_router/session/{session_id}/execute","summary":"Execute a tool within a tool router session","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdExecute"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/execute_meta","pathV3":"/api/v3/tool_router/session/{session_id}/execute_meta","summary":"Execute a meta tool within a tool router session","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdExecuteMeta"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}","pathV3":"/api/v3/tool_router/session/{session_id}","summary":"Get a tool router session by ID","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionId"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/link","pathV3":"/api/v3/tool_router/session/{session_id}/link","summary":"Create a link session for a toolkit in a tool router session","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdLink"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/proxy_execute","pathV3":"/api/v3/tool_router/session/{session_id}/proxy_execute","summary":"Execute proxy request within a tool router session","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdProxyExecute"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/toolkits","pathV3":"/api/v3/tool_router/session/{session_id}/toolkits","summary":"Get toolkits for a tool router session","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdToolkits"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/tools","pathV3":"/api/v3/tool_router/session/{session_id}/tools","summary":"List meta tools with schemas for a tool router session","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdTools"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/search","pathV3":"/api/v3/tool_router/session/{session_id}/search","summary":"Search for tools using a query","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdSearch"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/items","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/items","summary":"List files in a session mount","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdMountsByMountIdItems"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/download_url","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/download_url","summary":"Create a presigned download URL for a mount file","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdDownloadUrl"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/upload_url","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/upload_url","summary":"Create a presigned upload URL for a mount file","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdUploadUrl"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/delete","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/delete","summary":"Delete a file from a session mount","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdDelete"}]} />
12 +<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/tool_router/session","pathV3":"/api/v3/tool_router/session","summary":"Create a new tool router session","href":"/reference/api-reference/tool-router/postToolRouterSession"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}","pathV3":"/api/v3/tool_router/session/{session_id}","summary":"Get a tool router session by ID (v3.1)","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionId"},{"method":"PATCH","pathV31":"/api/v3.1/tool_router/session/{session_id}","pathV3":"/api/v3/tool_router/session/{session_id}","summary":"Patch a tool router session config (v3.1)","href":"/reference/api-reference/tool-router/patchToolRouterSessionBySessionId"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/attach","pathV3":"/api/v3/tool_router/session/{session_id}/attach","summary":"Attach to an existing tool router session (v3.1)","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdAttach"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/config_history","pathV3":"/api/v3/tool_router/session/{session_id}/config_history","summary":"List a tool router session config history","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdConfigHistory"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/search","pathV3":"/api/v3/tool_router/session/{session_id}/search","summary":"Search for tools using a query","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdSearch"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/tools","pathV3":"/api/v3/tool_router/session/{session_id}/tools","summary":"List tools with schemas for a tool router session (v3.1)","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdTools"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/execute","pathV3":"/api/v3/tool_router/session/{session_id}/execute","summary":"Execute a tool within a tool router session","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdExecute"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/execute_meta","pathV3":"/api/v3/tool_router/session/{session_id}/execute_meta","summary":"Execute a meta tool within a tool router session","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdExecuteMeta"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/link","pathV3":"/api/v3/tool_router/session/{session_id}/link","summary":"Create a link session for a toolkit in a tool router session","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdLink"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/proxy_execute","pathV3":"/api/v3/tool_router/session/{session_id}/proxy_execute","summary":"Execute proxy request within a tool router session","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdProxyExecute"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/toolkits","pathV3":"/api/v3/tool_router/session/{session_id}/toolkits","summary":"Get toolkits for a tool router session","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdToolkits"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/items","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/items","summary":"List files in a session mount","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdMountsByMountIdItems"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/download_url","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/download_url","summary":"Create a presigned download URL for a mount file","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdDownloadUrl"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/upload_url","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/upload_url","summary":"Create a presigned upload URL for a mount file","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdUploadUrl"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/delete","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/delete","summary":"Delete a file from a session mount","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdDelete"}]} />
docs/content/reference/api-reference/webhooks/index.mdx
+1 -1
@@ -9,4 +9,4 @@ Webhook configuration
9
10 ## Endpoints
11
12 -<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/webhook_subscriptions","pathV3":"/api/v3/webhook_subscriptions","summary":"Create webhook subscription","href":"/reference/api-reference/webhooks/postWebhookSubscriptions"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions","pathV3":"/api/v3/webhook_subscriptions","summary":"List webhook subscriptions","href":"/reference/api-reference/webhooks/getWebhookSubscriptions"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Get webhook subscription","href":"/reference/api-reference/webhooks/getWebhookSubscriptionsById"},{"method":"PATCH","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Update webhook subscription","href":"/reference/api-reference/webhooks/patchWebhookSubscriptionsById"},{"method":"DELETE","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Delete webhook subscription","href":"/reference/api-reference/webhooks/deleteWebhookSubscriptionsById"},{"method":"POST","pathV31":"/api/v3.1/webhook_subscriptions/{id}/rotate_secret","pathV3":"/api/v3/webhook_subscriptions/{id}/rotate_secret","summary":"Rotate webhook secret","href":"/reference/api-reference/webhooks/postWebhookSubscriptionsByIdRotateSecret"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions/event_types","pathV3":"/api/v3/webhook_subscriptions/event_types","summary":"List available event types","href":"/reference/api-reference/webhooks/getWebhookSubscriptionsEventTypes"}]} />
12 +<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/webhook_subscriptions","pathV3":"/api/v3/webhook_subscriptions","summary":"Create webhook subscription","href":"/reference/api-reference/webhooks/postWebhookSubscriptions"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions","pathV3":"/api/v3/webhook_subscriptions","summary":"List webhook subscriptions","href":"/reference/api-reference/webhooks/getWebhookSubscriptions"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Get webhook subscription","href":"/reference/api-reference/webhooks/getWebhookSubscriptionsById"},{"method":"PATCH","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Update webhook subscription","href":"/reference/api-reference/webhooks/patchWebhookSubscriptionsById"},{"method":"DELETE","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Delete webhook subscription","href":"/reference/api-reference/webhooks/deleteWebhookSubscriptionsById"},{"method":"POST","pathV31":"/api/v3.1/webhook_subscriptions/{id}/rotate_secret","pathV3":"/api/v3/webhook_subscriptions/{id}/rotate_secret","summary":"Rotate webhook secret","href":"/reference/api-reference/webhooks/postWebhookSubscriptionsByIdRotateSecret"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions/event_types","pathV3":"/api/v3/webhook_subscriptions/event_types","summary":"List available event types","href":"/reference/api-reference/webhooks/getWebhookSubscriptionsEventTypes"},{"method":"POST","pathV31":"/api/v3.1/webhook_endpoints","pathV3":"/api/v3/webhook_endpoints","summary":"Create webhook endpoint","href":"/reference/api-reference/webhooks/postWebhookEndpoints"},{"method":"GET","pathV31":"/api/v3.1/webhook_endpoints","pathV3":"/api/v3/webhook_endpoints","summary":"List webhook endpoints","href":"/reference/api-reference/webhooks/getWebhookEndpoints"},{"method":"GET","pathV31":"/api/v3.1/webhook_endpoints/{nano_id}","pathV3":"/api/v3/webhook_endpoints/{nano_id}","summary":"Get webhook endpoint","href":"/reference/api-reference/webhooks/getWebhookEndpointsByNanoId"},{"method":"POST","pathV31":"/api/v3.1/webhook_endpoints/{nano_id}","pathV3":"/api/v3/webhook_endpoints/{nano_id}","summary":"Put webhook endpoint configuration","href":"/reference/api-reference/webhooks/postWebhookEndpointsByNanoId"},{"method":"PATCH","pathV31":"/api/v3.1/webhook_endpoints/{nano_id}","pathV3":"/api/v3/webhook_endpoints/{nano_id}","summary":"Update webhook endpoint configuration","href":"/reference/api-reference/webhooks/patchWebhookEndpointsByNanoId"}]} />
docs/content/reference/meta-tools/index.mdx
+2 -2
@@ -18,7 +18,7 @@ Meta tools are system-level tools available in [sessions](/docs/tools-and-toolki
18 |------|-------------|
19 | [`COMPOSIO_GET_TOOL_SCHEMAS`](/reference/meta-tools/get_tool_schemas) | Retrieve input schemas for tools by slug |
20 | [`COMPOSIO_MANAGE_CONNECTIONS`](/reference/meta-tools/manage_connections) | Create or manage connections to user's apps |
21 -| [`COMPOSIO_MULTI_EXECUTE_TOOL`](/reference/meta-tools/multi_execute_tool) | Fast and parallel tool executor for tools and recipes discovered through COMPOSIO_SEARCH_TOOLS |
21 +| [`COMPOSIO_MULTI_EXECUTE_TOOL`](/reference/meta-tools/multi_execute_tool) | Fast and parallel tool executor for tools discovered through COMPOSIO_SEARCH_TOOLS |
22 | [`COMPOSIO_REMOTE_BASH_TOOL`](/reference/meta-tools/remote_bash_tool) | Execute bash commands in a REMOTE sandbox for file operations, data processing, and system tasks |
23 | [`COMPOSIO_REMOTE_WORKBENCH`](/reference/meta-tools/remote_workbench) | Process REMOTE FILES or script BULK TOOL EXECUTIONS using Python code IN A REMOTE SANDBOX |
24 -| [`COMPOSIO_SEARCH_TOOLS`](/reference/meta-tools/search_tools) | MCP Server Info: COMPOSIO MCP connects 500+ apps—Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calen... |
24 +| [`COMPOSIO_SEARCH_TOOLS`](/reference/meta-tools/search_tools) | Tool Server Info: Composio connects 500+ apps—Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calendar... |
docs/content/reference/meta-tools/multi_execute_tool.mdx
+1 -1
@@ -1,6 +1,6 @@
1 ---
2 title: Multi Execute Tool
3 -description: "Fast and parallel tool executor for tools and recipes discovered through COMPOSIO_SEARCH_TOOLS"
3 +description: "Fast and parallel tool executor for tools discovered through COMPOSIO_SEARCH_TOOLS"
4 keywords: [COMPOSIO_MULTI_EXECUTE_TOOL, meta tool]
5 ---
6
docs/content/reference/meta-tools/search_tools.mdx
+1 -1
@@ -1,6 +1,6 @@
1 ---
2 title: Search Tools
3 -description: "MCP Server Info: COMPOSIO MCP connects 500+ apps—Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calen..."
3 +description: "Tool Server Info: Composio connects 500+ apps—Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calendar..."
4 keywords: [COMPOSIO_SEARCH_TOOLS, meta tool]
5 ---
6
docs/content/reference/v3/api-reference/tool-router/index.mdx
+1 -1
@@ -9,4 +9,4 @@ description: "(Labs) Tool router endpoints"
9
10 ## Endpoints
11
12 -<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/tool_router/session","pathV3":"/api/v3/tool_router/session","summary":"Create a new tool router session","href":"/reference/v3/api-reference/tool-router/postToolRouterSession"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/execute","pathV3":"/api/v3/tool_router/session/{session_id}/execute","summary":"Execute a tool within a tool router session","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdExecute"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/execute_meta","pathV3":"/api/v3/tool_router/session/{session_id}/execute_meta","summary":"Execute a meta tool within a tool router session","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdExecuteMeta"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}","pathV3":"/api/v3/tool_router/session/{session_id}","summary":"Get a tool router session by ID","href":"/reference/v3/api-reference/tool-router/getToolRouterSessionBySessionId"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/link","pathV3":"/api/v3/tool_router/session/{session_id}/link","summary":"Create a link session for a toolkit in a tool router session","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdLink"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/proxy_execute","pathV3":"/api/v3/tool_router/session/{session_id}/proxy_execute","summary":"Execute proxy request within a tool router session","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdProxyExecute"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/toolkits","pathV3":"/api/v3/tool_router/session/{session_id}/toolkits","summary":"Get toolkits for a tool router session","href":"/reference/v3/api-reference/tool-router/getToolRouterSessionBySessionIdToolkits"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/tools","pathV3":"/api/v3/tool_router/session/{session_id}/tools","summary":"List meta tools with schemas for a tool router session","href":"/reference/v3/api-reference/tool-router/getToolRouterSessionBySessionIdTools"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/search","pathV3":"/api/v3/tool_router/session/{session_id}/search","summary":"Search for tools using a query","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdSearch"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/items","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/items","summary":"List files in a session mount","href":"/reference/v3/api-reference/tool-router/getToolRouterSessionBySessionIdMountsByMountIdItems"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/download_url","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/download_url","summary":"Create a presigned download URL for a mount file","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdDownloadUrl"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/upload_url","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/upload_url","summary":"Create a presigned upload URL for a mount file","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdUploadUrl"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/delete","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/delete","summary":"Delete a file from a session mount","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdDelete"}]} />
12 +<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/tool_router/session","pathV3":"/api/v3/tool_router/session","summary":"Create a new tool router session","href":"/reference/v3/api-reference/tool-router/postToolRouterSession"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/execute","pathV3":"/api/v3/tool_router/session/{session_id}/execute","summary":"Execute a tool within a tool router session","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdExecute"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/execute_meta","pathV3":"/api/v3/tool_router/session/{session_id}/execute_meta","summary":"Execute a meta tool within a tool router session","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdExecuteMeta"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}","pathV3":"/api/v3/tool_router/session/{session_id}","summary":"Get a tool router session by ID","href":"/reference/v3/api-reference/tool-router/getToolRouterSessionBySessionId"},{"method":"PATCH","pathV31":"/api/v3.1/tool_router/session/{session_id}","pathV3":"/api/v3/tool_router/session/{session_id}","summary":"Patch a tool router session config","href":"/reference/v3/api-reference/tool-router/patchToolRouterSessionBySessionId"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/link","pathV3":"/api/v3/tool_router/session/{session_id}/link","summary":"Create a link session for a toolkit in a tool router session","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdLink"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/proxy_execute","pathV3":"/api/v3/tool_router/session/{session_id}/proxy_execute","summary":"Execute proxy request within a tool router session","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdProxyExecute"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/toolkits","pathV3":"/api/v3/tool_router/session/{session_id}/toolkits","summary":"Get toolkits for a tool router session","href":"/reference/v3/api-reference/tool-router/getToolRouterSessionBySessionIdToolkits"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/tools","pathV3":"/api/v3/tool_router/session/{session_id}/tools","summary":"List tools with schemas for a tool router session","href":"/reference/v3/api-reference/tool-router/getToolRouterSessionBySessionIdTools"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/search","pathV3":"/api/v3/tool_router/session/{session_id}/search","summary":"Search for tools using a query","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdSearch"},{"method":"GET","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/items","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/items","summary":"List files in a session mount","href":"/reference/v3/api-reference/tool-router/getToolRouterSessionBySessionIdMountsByMountIdItems"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/download_url","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/download_url","summary":"Create a presigned download URL for a mount file","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdDownloadUrl"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/upload_url","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/upload_url","summary":"Create a presigned upload URL for a mount file","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdUploadUrl"},{"method":"POST","pathV31":"/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/delete","pathV3":"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/delete","summary":"Delete a file from a session mount","href":"/reference/v3/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdDelete"}]} />
docs/content/reference/v3/api-reference/webhooks/index.mdx
+1 -1
@@ -9,4 +9,4 @@ Webhook configuration
9
10 ## Endpoints
11
12 -<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/webhook_subscriptions","pathV3":"/api/v3/webhook_subscriptions","summary":"Create webhook subscription","href":"/reference/v3/api-reference/webhooks/postWebhookSubscriptions"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions","pathV3":"/api/v3/webhook_subscriptions","summary":"List webhook subscriptions","href":"/reference/v3/api-reference/webhooks/getWebhookSubscriptions"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Get webhook subscription","href":"/reference/v3/api-reference/webhooks/getWebhookSubscriptionsById"},{"method":"PATCH","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Update webhook subscription","href":"/reference/v3/api-reference/webhooks/patchWebhookSubscriptionsById"},{"method":"DELETE","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Delete webhook subscription","href":"/reference/v3/api-reference/webhooks/deleteWebhookSubscriptionsById"},{"method":"POST","pathV31":"/api/v3.1/webhook_subscriptions/{id}/rotate_secret","pathV3":"/api/v3/webhook_subscriptions/{id}/rotate_secret","summary":"Rotate webhook secret","href":"/reference/v3/api-reference/webhooks/postWebhookSubscriptionsByIdRotateSecret"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions/event_types","pathV3":"/api/v3/webhook_subscriptions/event_types","summary":"List available event types","href":"/reference/v3/api-reference/webhooks/getWebhookSubscriptionsEventTypes"}]} />
12 +<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/webhook_subscriptions","pathV3":"/api/v3/webhook_subscriptions","summary":"Create webhook subscription","href":"/reference/v3/api-reference/webhooks/postWebhookSubscriptions"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions","pathV3":"/api/v3/webhook_subscriptions","summary":"List webhook subscriptions","href":"/reference/v3/api-reference/webhooks/getWebhookSubscriptions"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Get webhook subscription","href":"/reference/v3/api-reference/webhooks/getWebhookSubscriptionsById"},{"method":"PATCH","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Update webhook subscription","href":"/reference/v3/api-reference/webhooks/patchWebhookSubscriptionsById"},{"method":"DELETE","pathV31":"/api/v3.1/webhook_subscriptions/{id}","pathV3":"/api/v3/webhook_subscriptions/{id}","summary":"Delete webhook subscription","href":"/reference/v3/api-reference/webhooks/deleteWebhookSubscriptionsById"},{"method":"POST","pathV31":"/api/v3.1/webhook_subscriptions/{id}/rotate_secret","pathV3":"/api/v3/webhook_subscriptions/{id}/rotate_secret","summary":"Rotate webhook secret","href":"/reference/v3/api-reference/webhooks/postWebhookSubscriptionsByIdRotateSecret"},{"method":"GET","pathV31":"/api/v3.1/webhook_subscriptions/event_types","pathV3":"/api/v3/webhook_subscriptions/event_types","summary":"List available event types","href":"/reference/v3/api-reference/webhooks/getWebhookSubscriptionsEventTypes"},{"method":"POST","pathV31":"/api/v3.1/webhook_endpoints","pathV3":"/api/v3/webhook_endpoints","summary":"Create webhook endpoint","href":"/reference/v3/api-reference/webhooks/postWebhookEndpoints"},{"method":"GET","pathV31":"/api/v3.1/webhook_endpoints","pathV3":"/api/v3/webhook_endpoints","summary":"List webhook endpoints","href":"/reference/v3/api-reference/webhooks/getWebhookEndpoints"},{"method":"GET","pathV31":"/api/v3.1/webhook_endpoints/{nano_id}","pathV3":"/api/v3/webhook_endpoints/{nano_id}","summary":"Get webhook endpoint","href":"/reference/v3/api-reference/webhooks/getWebhookEndpointsByNanoId"},{"method":"POST","pathV31":"/api/v3.1/webhook_endpoints/{nano_id}","pathV3":"/api/v3/webhook_endpoints/{nano_id}","summary":"Put webhook endpoint configuration","href":"/reference/v3/api-reference/webhooks/postWebhookEndpointsByNanoId"},{"method":"PATCH","pathV31":"/api/v3.1/webhook_endpoints/{nano_id}","pathV3":"/api/v3/webhook_endpoints/{nano_id}","summary":"Update webhook endpoint configuration","href":"/reference/v3/api-reference/webhooks/patchWebhookEndpointsByNanoId"}]} />
docs/public/data/meta-tools.json
+36 -35
@@ -15,7 +15,7 @@
15 "inputParameters": {
16 "properties": {
17 "tool_slugs": {
18 - "description": "Array of tool slugs to retrieve schemas for. Pass slugs exactly as returned by COMPOSIO_SEARCH_TOOLS.",
18 + "description": "Array of tool slugs to retrieve schemas for. Pass valid tool slugs; never invent.",
19 "examples": [
20 [
21 "GMAIL_SEND_EMAIL",
@@ -29,11 +29,6 @@
29 },
30 "title": "Tool Slugs"
31 },
32 - "session_id": {
33 - "description": "ALWAYS pass the session_id that was provided in the SEARCH_TOOLS response.",
34 - "title": "Session ID",
35 - "type": "string"
36 - },
32 "include": {
33 "description": "Schema fields to include. Defaults to [\"input_schema\"]. Include \"output_schema\" when calling tools in the workbench to validate response structure.",
34 "type": "array",
@@ -56,6 +51,11 @@
51 "output_schema"
52 ]
53 ]
54 + },
55 + "session_id": {
56 + "description": "Pass the session_id if you received one from a prior COMPOSIO_SEARCH_TOOLS call.",
57 + "title": "Session ID",
58 + "type": "string"
59 }
60 },
61 "required": [
@@ -161,9 +161,10 @@
161 "slug": "COMPOSIO_MANAGE_CONNECTIONS",
162 "name": "manage_connections",
163 "displayName": "Manage Connections",
164 - "description": "\nCreate or manage connections to user's apps. Returns a branded authentication link that works for OAuth, API keys, and all other auth types.\n\nCall policy:\n- First call COMPOSIO_SEARCH_TOOLS for the user's query.\n- If COMPOSIO_SEARCH_TOOLS indicates there is no active connection for a toolkit, call COMPOSIO_MANAGE_CONNECTIONS with the exact toolkit name(s) returned.\n- Do not call COMPOSIO_MANAGE_CONNECTIONS if COMPOSIO_SEARCH_TOOLS returns no main tools and no related tools.\n- Toolkit names in toolkits must exactly match toolkit identifiers returned by COMPOSIO_SEARCH_TOOLS; never invent names.\n- NEVER execute any toolkit tool without an ACTIVE connection.\n\nTool Behavior:\n- If a connection is Active, the tool returns the connection details. Always use this to verify connection status and fetch metadata.\n- If a connection is not Active, returns a authentication link (redirect_url) to create new connection.\n- If reinitiate_all is true, the tool forces reconnections for all toolkits, even if they already have active connections.\n\nWorkflow after initiating connection:\n- Always show the returned redirect_url as a FORMATTED MARKDOWN LINK to the user, and ask them to click on the link to finish authentication.\n- Begin executing tools only after the connection for that toolkit is confirmed Active.\n ",
164 + "description": "\nCreate or manage connections to user's apps. Returns a branded authentication link that works for OAuth, API keys, and all other auth types.\n\nCall policy:\n- First call COMPOSIO_SEARCH_TOOLS for the user's query.\n- If COMPOSIO_SEARCH_TOOLS indicates there is no active connection for a toolkit, call COMPOSIO_MANAGE_CONNECTIONS with the exact toolkit name(s) returned.\n- Use exact toolkit slugs returned by COMPOSIO_SEARCH_TOOLS; never invent toolkit names.\n- NEVER execute any toolkit tool without an ACTIVE connection.\n\nTool Behavior:\n- If a connection is Active, the tool returns the connection details. Always use this to verify connection status and fetch metadata.\n- If a connection is not Active, returns a authentication link (redirect_url) to create new connection.\n- If reinitiate_all is true, the tool forces reconnections for all toolkits, even if they already have active connections.\n\nWorkflow after initiating connection:\n- Always show the returned redirect_url as a FORMATTED MARKDOWN LINK to the user, and ask them to click on the link to finish authentication.\n- Begin executing tools only after the connection for that toolkit is confirmed Active.\n ",
165 "tags": [
166 - "openWorldHint"
166 + "openWorldHint",
167 + "destructiveHint"
168 ],
169 "toolkit": {
170 "slug": "COMPOSIO",
@@ -173,7 +174,7 @@
174 "inputParameters": {
175 "properties": {
176 "toolkits": {
176 - "description": "List of toolkits to check or connect. Should be a valid toolkit returned by SEARCH_TOOLS (never invent one). If a toolkit is not connected, will initiate connection. Example: ['gmail', 'exa', 'github', 'outlook', 'reddit', 'googlesheets', 'one_drive']",
177 + "description": "Toolkit slugs to check or connect. Must be valid toolkit slugs; never invent. Missing connections initiate auth. Examples: ['gmail', 'github', 'slack', 'googlesheets', 'outlook'].",
178 "items": {
179 "properties": {},
180 "type": "string"
@@ -183,12 +184,12 @@
184 },
185 "reinitiate_all": {
186 "default": false,
186 - "description": "Force reconnection for ALL toolkits in the toolkits list, even if they already have Active connections.\n WHEN TO USE:\n - You suspect existing connections are stale or broken.\n - You want to refresh all connections with new credentials or settings.\n - You're troubleshooting connection issues across multiple toolkits.\n BEHAVIOR:\n - Overrides any existing active connections for all specified toolkits and initiates new link-based authentication flows.\n DEFAULT: false (preserve existing active connections)",
187 + "description": "Force reconnection for all listed toolkits, even if active connections already exist. Use when credentials may be stale, you need fresh credentials/settings, or you are troubleshooting connection issues. This replaces existing active connections with new auth-link flows. Default false.",
188 "title": "Reinitiate All",
189 "type": "boolean"
190 },
191 "session_id": {
191 - "description": "ALWAYS pass the session_id that was provided in the SEARCH_TOOLS response.",
192 + "description": "Pass the session_id if you received one from a prior COMPOSIO_SEARCH_TOOLS call.",
193 "title": "Session ID",
194 "type": "string"
195 }
@@ -417,7 +418,7 @@
418 "slug": "COMPOSIO_MULTI_EXECUTE_TOOL",
419 "name": "multi_execute_tool",
420 "displayName": "Multi Execute Tool",
420 - "description": "\n Fast and parallel tool executor for tools and recipes discovered through COMPOSIO_SEARCH_TOOLS. Use this tool to execute up to 50 tools in parallel across apps only when they're logically independent (no ordering/output dependencies). Response contains structured outputs ready for immediate analysis - avoid reprocessing them via remote bash/workbench tools.\n\nPrerequisites:\n- Always use valid tool slugs and their arguments discovered through COMPOSIO_SEARCH_TOOLS. NEVER invent tool slugs or argument fields. ALWAYS pass STRICTLY schema-compliant arguments with each tool execution.\n- Ensure an ACTIVE connection exists for the toolkits that are going to be executed. If none exists, MUST initiate one via COMPOSIO_MANAGE_CONNECTIONS before execution.\n- Only batch tools that are logically independent - no ordering, no output-to-input dependencies, and no intra-call chaining (tools in one call can't use each other's outputs). DO NOT pass dummy or placeholder inputs; always resolve required inputs using appropriate tools first.\n\nUsage guidelines:\n- Use this whenever a tool is discovered and has to be called, either as part of a multi-step workflow or as a standalone tool.\n- If COMPOSIO_SEARCH_TOOLS returns a tool that can perform the task, prefer calling it via this executor. Do not write custom API calls or ad-hoc scripts for tasks that can be completed by available Composio tools.\n- Prefer parallel execution: group independent tools into a single multi-execute call where possible.\n- Predictively set sync_response_to_workbench=true if the response may be large or needed for later scripting. It still shows response inline; if the actual response data turns out small and easy to handle, keep everything inline and SKIP workbench usage.\n- Responses contain structured outputs for each tool. RULE: Small data - process yourself inline; large data - process in the workbench.\n- ALWAYS include inline references/links to sources in MARKDOWN format directly next to the relevant text. Eg provide slack thread links alongside with summary, render document links instead of raw IDs.\n\nRestrictions: Some tools or toolkits may be disabled in this environment. If the response indicates a restriction, inform the user and STOP execution immediately. Do NOT attempt workarounds or speculative actions.\n\n\n",
421 + "description": "\n Fast and parallel tool executor for tools discovered through COMPOSIO_SEARCH_TOOLS. Use this tool to execute up to 50 tools in parallel across apps only when they're logically independent (no ordering/output dependencies). Response contains structured outputs ready for immediate analysis - avoid reprocessing them via remote bash/workbench tools.\n\nPrerequisites:\n- Always use valid tool slugs and their arguments. NEVER invent tool slugs or argument fields. ALWAYS pass STRICTLY schema-compliant arguments with each tool execution.\n- Ensure an ACTIVE connection exists for the toolkits that are going to be executed. If none exists, MUST initiate one via COMPOSIO_MANAGE_CONNECTIONS before execution.\n- Only batch tools that are logically independent - no ordering, no output-to-input dependencies, and no intra-call chaining (tools in one call can't use each other's outputs). DO NOT pass dummy or placeholder inputs; always resolve required inputs using appropriate tools first.\n\nUsage guidelines:\n- If COMPOSIO_SEARCH_TOOLS returns a tool that can perform the task, prefer calling it via this executor. Do not write custom API calls or ad-hoc scripts for tasks that can be completed by available Composio tools.\n- Prefer parallel execution: group independent tools into a single multi-execute call where possible.\n- Predictively set sync_response_to_workbench=true if the response may be large or needed for later scripting. It still shows response inline; if the actual response data turns out small and easy to handle, keep everything inline and SKIP workbench usage.\n- Responses contain structured outputs for each tool. RULE: Small data - process yourself inline; large data - process in the workbench.\n- ALWAYS include inline references/links to sources in MARKDOWN format directly next to the relevant text. Eg provide slack thread links alongside with summary, render document links instead of raw IDs.\n\nRestrictions: Some tools or toolkits may be disabled in this environment. If the response indicates a restriction, inform the user and STOP execution immediately. Do NOT attempt workarounds or speculative actions.\n\n\n",
422 "tags": [
423 "openWorldHint",
424 "destructiveHint",
@@ -435,7 +436,7 @@
436 "items": {
437 "properties": {
438 "tool_slug": {
438 - "description": "The slug of the tool to execute - must be a valid slug from SEARCH_TOOLS response.",
439 + "description": "The slug of the tool to execute — must be a valid tool slug; never invent.",
440 "examples": [
441 "GMAIL_SEND_EMAIL",
442 "SLACK_SEND_MESSAGE",
@@ -447,7 +448,7 @@
448 },
449 "arguments": {
450 "additionalProperties": true,
450 - "description": "The arguments to pass to the tool. The argument schema is defined in the SEARCH_TOOLS response. Use exact field names and types; do not diverge from returned schemas.",
451 + "description": "The arguments to pass to the tool. Use exact field names and types; do not diverge from the tool's argument schema.",
452 "examples": [
453 {
454 "body": "This is a test",
@@ -488,15 +489,10 @@
489 "type": "string"
490 },
491 "sync_response_to_workbench": {
491 - "description": "Syncs the response to the remote workbench (for later scripting/processing) while still viewable inline. Predictively set true if the output may be large or need scripting; if it turns out small/manageable, skip workbench and use inline only. Default: false",
492 + "description": "Predictively set true when the response may be large or needed for later scripting. Saves the full response to the workbench while returning an inline preview. If the result is small, keep it inline. Default false.",
493 "title": "Sync Response To Workbench",
494 "type": "boolean"
495 },
495 - "session_id": {
496 - "description": "ALWAYS pass the session_id that was provided in the SEARCH_TOOLS response.",
497 - "title": "Session ID",
498 - "type": "string"
499 - },
496 "current_step": {
497 "description": "Short enum for current step of the workflow execution. Eg FETCHING_EMAILS, GENERATING_REPLIES. Always include to keep execution aligned with the workflow.",
498 "title": "Current Step",
@@ -506,6 +502,11 @@
502 "description": "Progress metrics for the current step - use to track how far execution has advanced. Format as a string \"done/total units\" - example \"10/100 emails\", \"0/n messages\", \"3/10 pages\".",
503 "title": "Current Step Metric",
504 "type": "string"
505 + },
506 + "session_id": {
507 + "description": "Pass the session_id if you received one from a prior COMPOSIO_SEARCH_TOOLS call.",
508 + "title": "Session ID",
509 + "type": "string"
510 }
511 },
512 "required": [
@@ -671,7 +672,7 @@
672 "slug": "COMPOSIO_REMOTE_BASH_TOOL",
673 "name": "remote_bash_tool",
674 "displayName": "Remote Bash Tool",
674 - "description": "\n Execute bash commands in a REMOTE sandbox for file operations, data processing, and system tasks. Essential for handling large tool responses saved to remote files.\n PRIMARY USE CASES:\n- Process large tool responses saved by COMPOSIO_MULTI_EXECUTE_TOOL to remote sandbox\n- File system operations, extract specific information from JSON with shell tools like jq, awk, sed, grep, etc.\n- Commands run from /home/user directory by default\n ",
675 + "description": "\n Execute bash commands in a REMOTE sandbox for file operations, data processing, and system tasks. Essential for handling large tool responses saved to remote files. **Hard 3-minute (180s) execution limit** — break large tasks into smaller commands.\n PRIMARY USE CASES:\n- Process large tool responses saved by COMPOSIO_MULTI_EXECUTE_TOOL to remote sandbox\n- File system operations, extract specific information from JSON with shell tools like jq, awk, sed, grep, etc.\n- Commands run from /home/user directory by default\n ",
676 "tags": [
677 "destructiveHint",
678 "openWorldHint"
@@ -684,12 +685,12 @@
685 "inputParameters": {
686 "properties": {
687 "command": {
687 - "description": "The bash command to execute",
688 + "description": "The bash command to execute. **Hard 3-minute (180s) execution limit** — break large tasks into smaller commands.",
689 "title": "Command",
690 "type": "string"
691 },
692 "session_id": {
692 - "description": "ALWAYS pass the session_id that was provided in the SEARCH_TOOLS response.",
693 + "description": "Pass the session_id if you received one from a prior COMPOSIO_SEARCH_TOOLS call.",
694 "title": "Session ID",
695 "type": "string"
696 }
@@ -794,7 +795,7 @@
795 "slug": "COMPOSIO_REMOTE_WORKBENCH",
796 "name": "remote_workbench",
797 "displayName": "Remote Workbench",
797 - "description": "\n Process **REMOTE FILES** or script BULK TOOL EXECUTIONS using Python code IN A REMOTE SANDBOX. If you can see the data in chat, DON'T USE THIS TOOL.\n**ONLY** use this when processing **data stored in a remote file** or when scripting bulk tool executions.\n\nDO NOT USE\n- When the complete response is already inline/in-memory, or you only need quick parsing, summarization, or basic math.\n\nUSE IF\n- To parse/analyze tool outputs saved to a remote file in the sandbox or to script multi-tool chains there.\n- For bulk or repeated executions of known Composio tools (e.g., add a label to 100 emails).\n- To call APIs via proxy_execute when no Composio tool exists for that API.\n\n\nOUTPUTS\n- Returns a compact result or, if too long, artifacts under `/home/user/.code_out`.\n\nIMPORTANT CODING RULES:\n 1. Stepwise Execution: Split work into small steps. Save intermediate outputs in variables or temporary file in `/tmp/`. Call COMPOSIO_REMOTE_WORKBENCH again for the next step. This improves composability and avoids timeouts.\n 2. Notebook Persistence: This is a persistent Jupyter notebook cell: variables, functions, imports, and in-memory state from previous and future code executions are preserved in the notebook's history and available for reuse. You also have a few helper functions available.\n 3. Parallelism & Timeout (CRITICAL): There is a hard timeout of 4 minutes so complete the code within that. Prioritize PARALLEL execution using ThreadPoolExecutor with suitable concurrency for bulk operations - e.g., call run_composio_tool or invoke_llm parallelly across rows to maximize efficiency.\n 3.1 If the data is large, split into smaller batches and call the workbench multiple times to avoid timeouts.\n 4. Checkpoints: Implement checkpoints (in memory or files) so that long runs can be resumed from the last completed step.\n 5. Schema Safety: Never assume the response schema for run_composio_tool if not known already from previous tools. To inspect schema, either run a simple request **outside** the workbench via COMPOSIO_MULTI_EXECUTE_TOOL or use invoke_llm helper.\n 6. LLM Helpers: Always use invoke_llm helper for summary, analysis, or field extraction on results. This is a smart LLM that will give much better results than any adhoc filtering.\n 7. Avoid Meta Loops: Do not use run_composio_tool to call COMPOSIO_MULTI_EXECUTE_TOOL or other COMPOSIO_* meta tools to avoid cycles. Only use it for app tools.\n 8. Pagination: Use when data spans multiple pages. Continue fetching pages with the returned next_page_token or cursor until none remains. Parallelize fetching pages if tool supports page_number.\n 9. No Hardcoding: Never hardcode data in code. Always load it from files or tool responses, iterating to construct intermediate or final inputs/outputs.\n 10. If the final output is in a workbench file, use upload_local_file to download it - never expose the raw workbench file path to the user. Prefer to download useful artifacts after task is complete.\n\n\nENV & HELPERS:\n- Home directory: `/home/user`.\n- NOTE: Helper functions already initialized in the workbench - DO NOT import or redeclare them:\n - \n`run_composio_tool(tool_slug: str, arguments: dict) -> tuple[Dict[str, Any], str]`: Execute a known Composio **app** tool (from COMPOSIO_SEARCH_TOOLS). Do not invent names; match the tool's input schema. Suited for loops/parallel/bulk over datasets.\n i) run_composio_tool returns JSON with top-level \"data\". Parse carefully—structure may be nested.\n \n - \n`invoke_llm(query: str) -> tuple[str, str]`: Invoke an LLM for semantic tasks. Pass MAX 200k characters in input.\n i) NOTE Prompting guidance: When building prompts for invoke_llm, prefer f-strings (or concatenation) so literal braces stay intact. If using str.format, escape braces by doubling them ({{ }}).\n ii) Define the exact JSON schema you want and batch items into smaller groups to stay within token limit.\n\n - `upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]`: Upload files in workbench to Composio S3/R2 storage. Use this to download any generated files/artifacts from the workbench.\n - `proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None) -> tuple[Any, str]`: Call a toolkit API directly when no Composio tool exists. Only one toolkit can be invoked with proxy_execute per workbench call\n - `web_search(query: str) -> tuple[str, str]`: Search the web for information.\n - `smart_file_extract(sandbox_file_path: str, show_preview: bool = True) -> tuple[str, str]`: Extracts text from files in the sandbox (e.g., PDF, image).\n - Workbench comes with comprehensive Image Processing (PIL/Pillow, OpenCV, scikit-image), PyTorch ML libraries, Document and Report handling tools (pandoc, python-docx, pdfplumber, reportlab), and standard Data Analysis tools (pandas, numpy, matplotlib) for advanced visual, analytical, and AI tasks.\n All helper functions return a tuple (result, error). Always check error before using result.\n\n## Python Helper Functions for LLM Scripting\n\n\n### run_composio_tool(tool_slug, arguments)\nExecutes a known Composio tool via backend API. Do NOT call COMPOSIO_* meta tools to avoid cyclic calls.\n\n def run_composio_tool(tool_slug: str, arguments: Dict[str, Any]) -> tuple[Dict[str, Any], str]\n # Returns: (tool_response_dict, error_message)\n # Success: ({\"data\": {actual_data}}, \"\") - Note the top-level data\n # Error: ({}, \"error_message\") or (response_data, \"error_message\")\n\n result, error = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 1, \"user_id\": \"me\"})\n if error:\n print(\"GMAIL_FETCH_EMAILS error:\", error); return\n email_data = result.get(\"data\", {})\n print(\"Fetched:\", email_data)\n \n\n\n### invoke_llm(query)\nCalls LLM for reasoning, analysis, and semantic tasks. Pass MAX 200k characters input.\n\n def invoke_llm(query: str) -> tuple[str, str]\n # Returns: (llm_response, error_message)\n\n resp, error = invoke_llm(\"Summarize the key points from this data\")\n if not error:\n print(\"LLM:\", resp)\n\n # Example: analyze tool response with LLM\n tool_resp, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5, \"user_id\": \"me\"})\n if not err:\n parsed = tool_resp.get(\"data\", {})\n resp, err2 = invoke_llm(f\"Analyze these emails and summarize: {parsed}\")\n if not err2:\n print(\"LLM Gmail Summary:\", resp)\n # TIP: batch prompts to reduce LLM calls.\n \n\n\n### upload_local_file(*file_paths)\nUploads sandbox files to Composio S3/R2 storage. Single files upload directly, multiple files are auto-zipped.\nUse this when you need to upload/download any generated artifacts from the sandbox.\n\n def upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]\n # Returns: (result_dict, error_string)\n # Success: ({\"s3_url\": str, \"uploaded_file\": str, \"type\": str, \"id\": str, \"s3key\": str, \"message\": str}, \"\")\n # Error: ({}, \"error_message\")\n\n # Single file\n result, error = upload_local_file(\"/path/to/report.pdf\")\n\n # Multiple files (auto-zipped)\n result, error = upload_local_file(\"/home/user/doc1.txt\", \"/home/user/doc2.txt\")\n\n if not error:\n print(\"Uploaded:\", result[\"s3_url\"])\n\n\n### proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None)\nDirect API call to a connected toolkit service.\n\n def proxy_execute(\n method: Literal[\"GET\",\"POST\",\"PUT\",\"DELETE\",\"PATCH\"],\n endpoint: str,\n toolkit: str,\n query_params: Optional[Dict[str, str]] = None,\n body: Optional[object] = None,\n headers: Optional[Dict[str, str]] = None,\n ) -> tuple[Any, str]\n # Returns: (response_data, error_message)\n\n # Example: GET request with query parameters\n query_params = {\"q\": \"is:unread\", \"maxResults\": \"10\"}\n data, error = proxy_execute(\"GET\", \"/gmail/v1/users/me/messages\", \"gmail\", query_params=query_params)\n if not error:\n print(\"Success:\", data)\n\n\n### web_search(query)\nSearches the web via Exa AI.\n\n def web_search(query: str) -> tuple[str, str]\n # Returns: (search_results_text, error_message)\n\n results, error = web_search(\"latest developments in AI\")\n if not error:\n print(\"Results:\", results)\n\n## Best Practices\n\n\n### Error-first pattern and Defensive parsing (print keys while narrowing)\n res, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5})\n if err:\n print(\"error:\", err); return\n if isinstance(res, dict):\n print(\"res keys:\", list(res.keys()))\n data = res.get(\"data\") or {}\n print(\"data keys:\", list(data.keys()))\n msgs = data.get(\"messages\") or []\n print(\"messages count:\", len(msgs))\n for m in msgs:\n print(\"subject:\", m.get(\"subject\", \"<missing>\"))\n\n### Parallelize (4-min sandbox timeout)\nAdjust concurrency so all tasks finish within 4 minutes.\n\n import concurrent.futures\n\n MAX_CONCURRENCY = 10 # Adjust as needed\n\n def send_bulk_emails(email_list):\n def send_single(email):\n result, error = run_composio_tool(\"GMAIL_SEND_EMAIL\", {\n \"to\": email[\"recipient\"], \"subject\": email[\"subject\"], \"body\": email[\"body\"]\n })\n if error:\n print(f\"Failed {email['recipient']}: {error}\")\n return {\"status\": \"failed\", \"error\": error}\n return {\"status\": \"sent\", \"data\": result}\n\n results = []\n with concurrent.futures.ThreadPoolExecutor(max_workers=MAX_CONCURRENCY) as ex:\n futures = [ex.submit(send_single, e) for e in email_list]\n for f in concurrent.futures.as_completed(futures):\n results.append(f.result())\n return results\n\n email_list = [{\"recipient\": f\"user{i}@example.com\", \"subject\": \"Test\", \"body\": \"Hello\"} for i in range(1000)]\n results = send_bulk_emails(email_list)\n \n\n ",
798 + "description": "\n Process **REMOTE FILES** or script BULK TOOL EXECUTIONS using Python code IN A REMOTE SANDBOX. If you can see the data in chat, DON'T USE THIS TOOL.\n**ONLY** use this when processing **data stored in a remote file** or when scripting bulk tool executions.\n\nDO NOT USE\n- When the complete response is already inline/in-memory, or you only need quick parsing, summarization, or basic math.\n\nUSE IF\n- To parse/analyze tool outputs saved by COMPOSIO_MULTI_EXECUTE_TOOL to a remote file in the sandbox or to script multi-tool chains there.\n- For bulk or repeated executions of known Composio tools (e.g., add a label to 100 emails).\n- To call APIs via proxy_execute when no Composio tool exists for that API.\n\n\nOUTPUTS\n- Returns a compact result or, if too long, artifacts under `/mnt/files/.composio/output` (cloud-backed FUSE mount, persisted across sandbox restarts).\n\nIMPORTANT CODING RULES:\n 1. Stepwise Execution: Split work into small steps. Save intermediate outputs to `/mnt/files/` (cloud-backed, persisted across failures/timeouts) or variables. Call COMPOSIO_REMOTE_WORKBENCH again for the next step.\n 2. Notebook Persistence: This is a persistent Jupyter notebook cell: variables, functions, imports, and in-memory state persist across executions. Helper functions are preloaded.\n 3. Top-level cells: Do not use `return`; Jupyter only allows it inside functions. For final values, end with `output` or `print(output)`, not `return output`.\n 4. Parallelism & Timeout (CRITICAL): There is a **hard 3-minute (180s) execution limit** per cell. Always prioritize PARALLEL execution using ThreadPoolExecutor for bulk operations - e.g., call run_composio_tool or invoke_llm across rows. If data is large, split it into smaller batches across cells.\n 5. Checkpoints: Save checkpoints to `/mnt/files/` so that long runs can be resumed from the last completed step, even after a timeout or sandbox restart.\n 6. Schema Safety: Never assume the response schema for run_composio_tool if not known already from previous tools. To inspect schema, either run a simple request **outside** the workbench or use invoke_llm helper.\n 7. LLM Helpers: Always use invoke_llm helper for summary, analysis, or field extraction on results; prefer it for much better results over ad hoc filtering.\n 8. Avoid Meta Loops: Do not use run_composio_tool to call COMPOSIO_* meta tools. Only use it for app tools.\n 9. Pagination: Use when data spans multiple pages. Continue fetching pages with the returned next_page_token or cursor until none remains. Parallelize page fetches when the tool supports page_number.\n 10. No Hardcoding: Never hardcode data. Load it from files or tool responses, iterating to construct intermediate or final inputs/outputs.\n 11. If the final output is in a workbench file, use upload_local_file to download it - never expose the raw workbench file path to the user. Prefer to download useful artifacts after task is complete.\n\n\nENV & HELPERS:\n- Home directory: `/home/user`.\n- NOTE: Helper functions already initialized in the workbench - DO NOT import or redeclare them:\n - \n`run_composio_tool(tool_slug: str, arguments: dict) -> tuple[Dict[str, Any], str]`: Execute a known Composio **app** tool. Do not invent names; match the tool input schema. Use for loops/parallel/bulk calls.\n i) run_composio_tool returns JSON with top-level \"data\". Parse carefully—structure may be nested.\n \n - \n`invoke_llm(query: str) -> tuple[str, str]`: Invoke an LLM for semantic tasks. Pass MAX 200k characters.\n i) NOTE Prompting guidance: When building prompts for invoke_llm, prefer f-strings (or concatenation) so literal braces stay intact. If using str.format, escape braces by doubling them ({{ }}).\n ii) Define the exact JSON schema you want and batch items into smaller groups to stay within token limit.\n\n - `upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]`: Upload sandbox files to Composio S3/R2 storage for user-downloadable artifacts.\n - `proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None) -> tuple[Any, str]`: Call a toolkit API directly when no Composio tool exists. Only one toolkit can be invoked with proxy_execute per workbench call\n - `web_search(query: str) -> tuple[str, str]`: Search the web for information.\n - `smart_file_extract(sandbox_file_path: str, show_preview: bool = True) -> tuple[str, str]`: Extracts text from files in the sandbox (e.g., PDF, image).\n - Workbench comes with comprehensive Image Processing (PIL/Pillow, OpenCV, scikit-image), PyTorch ML libraries, Document and Report handling tools (pandoc, python-docx, pdfplumber, reportlab), and standard Data Analysis tools (pandas, numpy, matplotlib) for advanced visual, analytical, and AI tasks.\n All helper functions return a tuple (result, error). Always check error before using result.\n\n## Python Helper Functions for LLM Scripting\n\n\n### run_composio_tool\nExecutes a known Composio tool via backend API. Do NOT call COMPOSIO_* meta tools to avoid cycles.\n\n def run_composio_tool(tool_slug: str, arguments: Dict[str, Any]) -> tuple[Dict[str, Any], str]\n # Returns: (tool_response_dict, error_message)\n # Success: ({\"data\": {actual_data}}, \"\") - Note the top-level data\n # Error: ({}, \"error_message\") or (response_data, \"error_message\")\n\n result, error = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 1, \"user_id\": \"me\"})\n if error:\n print(\"GMAIL_FETCH_EMAILS error:\", error)\n else:\n email_data = result.get(\"data\", {})\n print(\"Fetched:\", email_data)\n \n\n\n### invoke_llm\nCalls LLM for reasoning, analysis, and semantic tasks. Pass MAX 200k characters.\n\n def invoke_llm(query: str) -> tuple[str, str]\n # Returns: (llm_response, error_message)\n\n # Example: analyze tool response with LLM\n tool_resp, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5, \"user_id\": \"me\"})\n if not err:\n parsed = tool_resp.get(\"data\", {})\n resp, err2 = invoke_llm(f\"Summarize these emails: {parsed}\")\n if not err2:\n print(resp)\n # TIP: batch prompts to reduce LLM calls.\n \n\n\n### upload_local_file\nUploads sandbox files to Composio S3/R2 storage for upload/download requests involving generated sandbox artifacts. Single files upload directly; multiple files are auto-zipped.\n\n def upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]\n # Returns: (result_dict, error_string)\n # Success: ({\"s3_url\": str, \"uploaded_file\": str, \"type\": str, \"id\": str, \"s3key\": str, \"message\": str}, \"\")\n # Error: ({}, \"error_message\")\n\n # Single file\n result, error = upload_local_file(\"/path/to/report.pdf\")\n\n # Multiple files are auto-zipped\n result, error = upload_local_file(\"/home/user/doc1.txt\", \"/home/user/doc2.txt\")\n\n if not error:\n print(\"Uploaded:\", result[\"s3_url\"])\n\n\n### proxy_execute\nDirect API call to a connected toolkit service.\n\n def proxy_execute(\n method: Literal[\"GET\",\"POST\",\"PUT\",\"DELETE\",\"PATCH\"],\n endpoint: str,\n toolkit: str,\n query_params: Optional[Dict[str, str]] = None,\n body: Optional[object] = None,\n headers: Optional[Dict[str, str]] = None,\n ) -> tuple[Any, str]\n # Returns: (response_data, error_message)\n\n # Example: GET request with query parameters\n query_params = {\"q\": \"is:unread\", \"maxResults\": \"10\"}\n data, error = proxy_execute(\"GET\", \"/gmail/v1/users/me/messages\", \"gmail\", query_params=query_params)\n if not error:\n print(\"Success:\", data)\n\n\n### web_search\nSearches the web via Exa AI.\n\n def web_search(query: str) -> tuple[str, str]\n # Returns: (search_results_text, error_message)\n\n results, error = web_search(\"latest developments in AI\")\n if not error:\n print(\"Results:\", results)\n\n## Best Practices\n\n\n### Error-first pattern and Defensive parsing (print keys while narrowing)\n res, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5})\n if err:\n print(\"error:\", err)\n elif isinstance(res, dict):\n print(\"res keys:\", list(res.keys()))\n data = res.get(\"data\") or {}\n print(\"data keys:\", list(data.keys()))\n msgs = data.get(\"messages\") or []\n print(\"messages count:\", len(msgs))\n for m in msgs:\n print(\"subject:\", m.get(\"subject\", \"<missing>\"))\n\n### Parallelize within the 3-minute cell timeout\nAdjust concurrency so all tasks finish within 3 minutes.\n\n import concurrent.futures\n\n MAX_CONCURRENCY = 10 # Adjust as needed\n\n def process_one(item):\n result, error = run_composio_tool(\"GMAIL_SEND_EMAIL\", item)\n if error:\n return {\"status\": \"failed\", \"error\": error}\n return {\"status\": \"ok\", \"data\": result}\n\n with concurrent.futures.ThreadPoolExecutor(max_workers=MAX_CONCURRENCY) as ex:\n results = list(ex.map(process_one, items))\n \n\n ",
799 "tags": [
800 "destructiveHint",
801 "openWorldHint"
@@ -805,27 +806,22 @@
806 "logo": "https://cdn.jsdelivr.net/gh/ComposioHQ/open-logos@master/composio-logo.png"
807 },
808 "inputParameters": {
808 - "description": "Remote Workbench — run analysis/orchestration in a persistent remote sandbox.\nUse only when working with remote artifacts or when you must script multiple Composio tool calls.\nAvoid if the needed data is already inline in the chat/context.",
809 + "description": "Remote Workbench - Run Python in a persistent remote sandbox for remote artifacts or scripted Composio tool calls. Avoid when needed data is already inline.",
810 "properties": {
811 "code_to_execute": {
811 - "description": "Python to run inside the persistent **remote Jupyter sandbox**. State (imports, variables, files) is preserved across executions. Keep code concise to minimize tool call latency. Avoid unnecessary comments.",
812 + "description": "Python to run inside the persistent **remote Jupyter sandbox**. State (imports, variables, files) is preserved across executions. Keep code concise. Avoid unnecessary comments. **Hard 3-minute (180s) execution limit** — break large tasks into smaller cells.",
813 "examples": [
814 "import json, glob\npaths = glob.glob(file_path)\n...",
814 - "result, error = run_composio_tool(tool_slug='SLACK_SEARCH_MESSAGES', arguments={'query': 'Rube'})\nif error: return\nmessages = result.get('data', {}).get('messages', [])"
815 + "result, error = run_composio_tool(tool_slug='SLACK_SEARCH_MESSAGES', arguments={'query': 'Rube'})\nif error:\n print(error)\nelse:\n messages = result.get('data', {}).get('messages', [])"
816 ],
817 "title": "Code To Execute",
818 "type": "string"
819 },
820 "thought": {
820 - "description": "Concise objective and high-level plan (no private chain-of-thought). 1 sentence describing what the cell should achieve and why the sandbox is needed.",
821 + "description": "Brief objective for this step.",
822 "title": "Thought",
823 "type": "string"
824 },
824 - "session_id": {
825 - "description": "ALWAYS pass the session_id that was provided in the SEARCH_TOOLS response.",
826 - "title": "Session ID",
827 - "type": "string"
828 - },
825 "current_step": {
826 "description": "Short enum for current step of the workflow execution. Eg FETCHING_EMAILS, GENERATING_REPLIES. Always include to keep execution aligned with the workflow.",
827 "title": "Current Step",
@@ -835,6 +831,11 @@
831 "description": "Progress metrics for the current step - use to track how far execution has advanced. Format as a string \"done/total units\" - example \"10/100 emails\", \"0/n messages\", \"3/10 pages\".",
832 "title": "Current Step Metric",
833 "type": "string"
834 + },
835 + "session_id": {
836 + "description": "Pass the session_id if you received one from a prior COMPOSIO_SEARCH_TOOLS call.",
837 + "title": "Session ID",
838 + "type": "string"
839 }
840 },
841 "required": [
@@ -942,7 +943,7 @@
943 "slug": "COMPOSIO_SEARCH_TOOLS",
944 "name": "search_tools",
945 "displayName": "Search Tools",
945 - "description": "\n MCP Server Info: COMPOSIO MCP connects 500+ apps—Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calendar), Microsoft (Outlook, Teams), X/Twitter, Figma, Web Search / Deep research, Browser tool (scrape URLs, browser automation), Meta apps (Instagram, Meta Ads), TikTok, AI tools like Nano Banana & Veo3, and more—for seamless cross-app automation.\n Use this MCP server to discover the right tools and the recommended step-by-step plan to execute reliably.\n ALWAYS call this tool first whenever a user mentions or implies an external app, service, or workflow—never say \"I don't have access to X/Y app\" before calling it.\n\n Tool Info: Extremely fast discovery tool that returns relevant MCP-callable tools along with a recommended execution plan and common pitfalls for reliable execution.\n\nUsage guidelines:\n - Use this tool whenever kicking off a task. Re-run it when you need additional tools/plans due to missing details, errors, or a changed use case.\n - If the user pivots to a different use case in same chat, you MUST call this tool again with the new use case and generate a new session_id.\n - Specify the use_case with a normalized description of the problem, query, or task. Be clear and precise. Queries can be simple single-app actions or multiple linked queries for complex cross-app workflows.\n - Pass known_fields along with use_case as a string of key–value hints (for example, \"channel_name: general\") to help the search resolve missing details such as IDs.\n \n\nSplitting guidelines (Important):\n 1. Atomic queries: 1 query = 1 tool call. Include hidden prerequisites (e.g., add \"get Linear issue\" before \"update Linear issue\").\n 2. Include app names: If user names a toolkit, include it in every sub query so intent stays scoped (e.g., \"fetch Gmail emails\", \"reply to Gmail email\").\n 3. English input: Translate non-English prompts while preserving intent and identifiers.\n\n Example:\n User query: \"send an email to John welcoming him and create a meeting invite for tomorrow\"\n Search call: queries: [\n {use_case: \"send an email to someone\", known_fields: \"recipient_name: John\"},\n {use_case: \"create a meeting invite\", known_fields: \"meeting_date: tomorrow\"}\n ]\n\nPlan review checklist (Important):\n - The response includes a detailed execution plan and common pitfalls. You MUST review this plan carefully, adapt it to your current context, and generate your own final step-by-step plan before execution. Execute the steps in order to ensure reliable and accurate execution. Skipping or ignoring required steps can lead to unexpected failures.\n - Check the plan and pitfalls for input parameter nuances (required fields, IDs, formats, limits). Before executing any tool, you MUST review its COMPLETE input schema and provide STRICTLY schema-compliant arguments to avoid invalid-input errors.\n - Determine whether pagination is needed; if a response returns a pagination token and completeness is implied, paginate until exhaustion and do not return partial results.\n\nResponse:\n - Tools & Input Schemas: The response lists toolkits (apps) and tools suitable for the task, along with their tool_slug, description, input schema / schemaRef, and related tools for prerequisites, alternatives, or next steps.\n - NOTE: Tools with schemaRef instead of input_schema require you to call COMPOSIO_GET_TOOL_SCHEMAS first to load their full input_schema before use.\n - Connection Info: If a toolkit has an active connection, the response includes it along with any available current user information. If no active connection exists, you MUST initiate a new connection via COMPOSIO_MANAGE_CONNECTIONS with the correct toolkit name. DO NOT execute any toolkit tool without an ACTIVE connection.\n - Time Info: The response includes the current UTC time for reference. You can reference UTC time from the response if needed.\n - The tools returned to you through this are to be called via COMPOSIO_MULTI_EXECUTE_TOOL. Ensure each tool execution specifies the correct tool_slug and arguments exactly as defined by the tool's input schema.\n \nSESSION: ALWAYS set this parameter, first for any workflow. Pass session: {generate_id: true} for new workflows OR session: {id: \"EXISTING_ID\"} to continue. ALWAYS use the returned session_id in ALL subsequent meta tool calls.\n ",
946 + "description": "\n Tool Server Info: Composio connects 500+ apps—Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calendar), Microsoft (Outlook, Teams), X/Twitter, Figma, Web Search / Deep research, Browser tool (scrape URLs, browser automation), Meta apps (Instagram, Meta Ads), TikTok, AI tools like Nano Banana & Veo3, and more—for seamless cross-app automation.\n Use this tool to discover relevant tools plus the recommended plan and common pitfalls for reliable execution.\n Always call this tool first whenever a user mentions or implies an external app, service, or workflow—never say \"I don't have access to X/Y app\" before calling it.\n\nUsage guidelines:\n - Use this tool whenever kicking off a task. Re-run it when you need additional tools/plans due to missing details, errors, or a changed use case.\n - If the user pivots to a different use case in same chat, you MUST call this tool again with the new use case and generate a new session_id.\n - Specify the use_case with a normalized description of the problem, query, or task. Be clear and precise. Queries can be simple single-app actions or multiple linked queries for complex cross-app workflows.\n - Pass known_fields along with use_case as a string of key–value hints (for example, \"channel_name: general\") to help the search resolve missing details such as IDs.\n \n\nSplitting guidelines (Important):\n 1. Atomic queries: 1 query = 1 tool call. Include hidden prerequisites (e.g., add \"get Linear issue\" before \"update Linear issue\").\n 2. Include app names: If user names a toolkit, include it in every sub query so intent stays scoped (e.g., \"fetch Gmail emails\", \"reply to Gmail email\").\n 3. English input: Translate non-English prompts while preserving intent and identifiers.\n\n Example:\n User query: \"send an email to John welcoming him and create a meeting invite for tomorrow\"\n Search call: queries: [\n {use_case: \"send an email to someone\", known_fields: \"recipient_name: John\"},\n {use_case: \"create a meeting invite\", known_fields: \"meeting_date: tomorrow\"}\n ]\n\nPlan review checklist (Important):\n - The response includes a detailed execution plan and common pitfalls. You MUST review this plan carefully, adapt it to your current context, and generate your own final step-by-step plan before execution. Execute the steps in order to ensure reliable and accurate execution. Skipping or ignoring required steps can lead to unexpected failures.\n - Check the plan and pitfalls for input parameter nuances (required fields, IDs, formats, limits). Before executing any tool, you MUST review its COMPLETE input schema and provide STRICTLY schema-compliant arguments to avoid invalid-input errors.\n - Determine whether pagination is needed; if a response returns a pagination token and completeness is implied, paginate until exhaustion and do not return partial results.\n\nResponse:\n - Tools & Input Schemas: The response lists toolkits (apps) and tools suitable for the task, along with their tool_slug, description, input schema / schemaRef, and related tools for prerequisites, alternatives, or next steps.\n - NOTE: Tools with schemaRef instead of input_schema require you to call COMPOSIO_GET_TOOL_SCHEMAS first to load their full input_schema before use.\n - Connection Info: If a toolkit has an active connection, the response includes it along with any available current user information. If no active connection exists, you MUST initiate a new connection via COMPOSIO_MANAGE_CONNECTIONS with the correct toolkit name. DO NOT execute any toolkit tool without an ACTIVE connection.\n - Time Info: The response includes the current UTC time for reference. You can reference UTC time from the response if needed.\n \n - The tools returned to you through this are to be called via COMPOSIO_MULTI_EXECUTE_TOOL. Ensure each tool execution specifies the correct tool_slug and arguments exactly as defined by the tool's input schema.\n \nSESSION: ALWAYS set this parameter, first for any workflow. Pass session: {generate_id: true} for new workflows OR session: {id: \"EXISTING_ID\"} to continue. ALWAYS use the returned session_id in ALL subsequent meta tool calls.\n ",
947 "tags": [
948 "important",
949 "openWorldHint",
@@ -957,7 +958,7 @@
958 "properties": {
959 "queries": {
960 "type": "array",
960 - "description": "List of structured search queries (in English) to process in parallel. Each query represents a specific use case or task. For multi-app or complex workflows, split them into smaller single-app, API-level actions for best accuracy, including implicit prerequisites (e.g., fetch the resource before updating it). Each query returns 5-10 tools.",
961 + "description": "Structured English search queries to process in parallel. Split independent app/API actions into separate queries, including hidden prerequisites. Each query returns 4-6 tools.",
962 "items": {
963 "type": "object",
964 "properties": {
docs/public/data/toolkits-list.json
+73 -73
@@ -4,7 +4,7 @@
4 "name": "Gmail",
5 "logo": "https://logos.composio.dev/api/gmail",
6 "category": "email",
7 - "toolCount": 62,
7 + "toolCount": 63,
8 "triggerCount": 2
9 },
10 {
@@ -28,7 +28,7 @@
28 "name": "Google Calendar",
29 "logo": "https://logos.composio.dev/api/googlecalendar",
30 "category": "scheduling & booking",
31 - "toolCount": 46,
31 + "toolCount": 48,
32 "triggerCount": 7
33 },
34 {
@@ -37,14 +37,14 @@
37 "logo": "https://logos.composio.dev/api/notion",
38 "category": "notes",
39 "toolCount": 48,
40 - "triggerCount": 5
40 + "triggerCount": 13
41 },
42 {
43 "slug": "googlesheets",
44 "name": "Google Sheets",
45 "logo": "https://logos.composio.dev/api/googlesheets",
46 "category": "spreadsheets",
47 - "toolCount": 48,
47 + "toolCount": 50,
48 "triggerCount": 16
49 },
50 {
@@ -53,7 +53,7 @@
53 "logo": "https://logos.composio.dev/api/slack",
54 "category": "team chat",
55 "toolCount": 151,
56 - "triggerCount": 5
56 + "triggerCount": 8
57 },
58 {
59 "slug": "supabase",
@@ -76,7 +76,7 @@
76 "name": "Perplexity AI",
77 "logo": "https://logos.composio.dev/api/perplexityai",
78 "category": "artificial intelligence",
79 - "toolCount": 6,
79 + "toolCount": 9,
80 "triggerCount": 0
81 },
82 {
@@ -181,14 +181,14 @@
181 "logo": "https://logos.composio.dev/api/slackbot",
182 "category": "team chat",
183 "toolCount": 89,
184 - "triggerCount": 5
184 + "triggerCount": 8
185 },
186 {
187 "slug": "canvas",
188 "name": "Canvas",
189 "logo": "https://logos.composio.dev/api/canvas",
190 "category": "online courses",
191 - "toolCount": 560,
191 + "toolCount": 574,
192 "triggerCount": 6
193 },
194 {
@@ -212,7 +212,7 @@
212 "name": "Discord",
213 "logo": "https://logos.composio.dev/api/discord",
214 "category": "team chat",
215 - "toolCount": 16,
215 + "toolCount": 28,
216 "triggerCount": 1
217 },
218 {
@@ -300,7 +300,7 @@
300 "name": "Microsoft Teams",
301 "logo": "https://logos.composio.dev/api/microsoft_teams",
302 "category": "team chat",
303 - "toolCount": 164,
303 + "toolCount": 163,
304 "triggerCount": 0
305 },
306 {
@@ -309,7 +309,7 @@
309 "logo": "https://logos.composio.dev/api/asana",
310 "category": "project management",
311 "toolCount": 153,
312 - "triggerCount": 1
312 + "triggerCount": 6
313 },
314 {
315 "slug": "peopledatalabs",
@@ -444,7 +444,7 @@
444 "name": "ClickUp",
445 "logo": "https://logos.composio.dev/api/clickup",
446 "category": "productivity",
447 - "toolCount": 163,
447 + "toolCount": 164,
448 "triggerCount": 0
449 },
450 {
@@ -651,7 +651,7 @@
651 "slug": "coinbase",
652 "name": "Coinbase",
653 "logo": "https://logos.composio.dev/api/coinbase",
654 - "category": "payment processing",
654 + "category": "developer tools",
655 "toolCount": 28,
656 "triggerCount": 0
657 },
@@ -724,7 +724,7 @@
724 "name": "Zendesk",
725 "logo": "https://logos.composio.dev/api/zendesk",
726 "category": "crm",
727 - "toolCount": 20,
727 + "toolCount": 452,
728 "triggerCount": 2
729 },
730 {
@@ -764,7 +764,7 @@
764 "name": "Google Super",
765 "logo": "https://logos.composio.dev/api/googlesuper",
766 "category": "file management & storage",
767 - "toolCount": 431,
767 + "toolCount": 440,
768 "triggerCount": 20
769 },
770 {
@@ -868,7 +868,7 @@
868 "name": "Google Ads",
869 "logo": "https://logos.composio.dev/api/googleads",
870 "category": "ads & conversion",
871 - "toolCount": 5,
871 + "toolCount": 9,
872 "triggerCount": 0
873 },
874 {
@@ -2251,7 +2251,7 @@
2251 "slug": "autobound",
2252 "name": "Autobound",
2253 "logo": "https://logos.composio.dev/api/autobound",
2254 - "category": "ai content generation",
2254 + "category": "ai sales tools",
2255 "toolCount": 2,
2256 "triggerCount": 0
2257 },
@@ -3884,7 +3884,7 @@
3884 "name": "Fal.ai",
3885 "logo": "https://logos.composio.dev/api/fal_ai",
3886 "category": "ai models",
3887 - "toolCount": 8,
3887 + "toolCount": 12,
3888 "triggerCount": 0
3889 },
3890 {
@@ -3931,7 +3931,7 @@
3931 "slug": "fidel_api",
3932 "name": "Fidel API",
3933 "logo": "https://logos.composio.dev/api/fidel_api",
3934 - "category": "payment processing",
3934 + "category": "developer tools",
3935 "toolCount": 39,
3936 "triggerCount": 0
3937 },
@@ -4091,7 +4091,7 @@
4091 "slug": "fraudlabs_pro",
4092 "name": "FraudLabs Pro",
4093 "logo": "https://www.fraudlabspro.com/images/logo.png",
4094 - "category": "payment processing",
4094 + "category": "security & identity tools",
4095 "toolCount": 8,
4096 "triggerCount": 0
4097 },
@@ -4755,7 +4755,7 @@
4755 "slug": "imagior",
4756 "name": "Imagior",
4757 "logo": "https://logos.composio.dev/api/imagior",
4758 - "category": "ai content generation",
4758 + "category": "images & design",
4759 "toolCount": 2,
4760 "triggerCount": 0
4761 },
@@ -5455,6 +5455,14 @@
5455 "toolCount": 4,
5456 "triggerCount": 0
5457 },
5458 + {
5459 + "slug": "mercury_mcp",
5460 + "name": "Mercury MCP",
5461 + "logo": "https://logos.composio.dev/api/mercury_mcp",
5462 + "category": "model context protocol",
5463 + "toolCount": 30,
5464 + "triggerCount": 0
5465 + },
5466 {
5467 "slug": "metabase",
5468 "name": "Metabase",
@@ -5511,6 +5519,14 @@
5519 "toolCount": 94,
5520 "triggerCount": 0
5521 },
5522 + {
5523 + "slug": "mobbin_mcp",
5524 + "name": "Mobbin MCP",
5525 + "logo": "https://logos.composio.dev/api/mobbin_mcp",
5526 + "category": "images & design",
5527 + "toolCount": 1,
5528 + "triggerCount": 0
5529 + },
5530 {
5531 "slug": "moco",
5532 "name": "Moco",
@@ -5643,7 +5659,7 @@
5659 "slug": "neuronwriter",
5660 "name": "Neuronwriter",
5661 "logo": "https://logos.composio.dev/api/neuronwriter",
5646 - "category": "ai content generation",
5662 + "category": "marketing automation",
5663 "toolCount": 1,
5664 "triggerCount": 0
5665 },
@@ -6003,7 +6019,7 @@
6019 "slug": "payhere",
6020 "name": "Payhere",
6021 "logo": "https://logos.composio.dev/api/payhere",
6006 - "category": "payment processing",
6022 + "category": "ecommerce",
6023 "toolCount": 13,
6024 "triggerCount": 0
6025 },
@@ -6015,6 +6031,14 @@
6031 "toolCount": 9,
6032 "triggerCount": 0
6033 },
6034 + {
6035 + "slug": "paypal",
6036 + "name": "Paypal",
6037 + "logo": "https://logos.composio.dev/api/paypal",
6038 + "category": "payment processing",
6039 + "toolCount": 74,
6040 + "triggerCount": 0
6041 + },
6042 {
6043 "slug": "paystack",
6044 "name": "Paystack",
@@ -6239,6 +6263,22 @@
6263 "toolCount": 60,
6264 "triggerCount": 0
6265 },
6266 + {
6267 + "slug": "polymarket_us",
6268 + "name": "Polymarket US",
6269 + "logo": "https://logos.composio.dev/api/polymarket_us",
6270 + "category": "commerce",
6271 + "toolCount": 44,
6272 + "triggerCount": 0
6273 + },
6274 + {
6275 + "slug": "polymarket",
6276 + "name": "Polymarket US",
6277 + "logo": "https://logos.composio.dev/api/polymarket",
6278 + "category": "commerce",
6279 + "toolCount": 44,
6280 + "triggerCount": 0
6281 + },
6282 {
6283 "slug": "poof",
6284 "name": "Poof",
@@ -6331,7 +6371,7 @@
6371 "slug": "proabono",
6372 "name": "Proabono",
6373 "logo": "https://logos.composio.dev/api/proabono",
6334 - "category": "payment processing",
6374 + "category": "ecommerce",
6375 "toolCount": 64,
6376 "triggerCount": 0
6377 },
@@ -6407,6 +6447,14 @@
6447 "toolCount": 29,
6448 "triggerCount": 0
6449 },
6450 + {
6451 + "slug": "pylon_mcp",
6452 + "name": "Pylon MCP",
6453 + "logo": "https://logos.composio.dev/api/pylon_mcp",
6454 + "category": "model context protocol",
6455 + "toolCount": 12,
6456 + "triggerCount": 0
6457 + },
6458 {
6459 "slug": "quaderno",
6460 "name": "Quaderno",
@@ -7283,7 +7331,7 @@
7331 "slug": "splitwise",
7332 "name": "Splitwise",
7333 "logo": "https://logos.composio.dev/api/splitwise",
7286 - "category": "payment processing",
7334 + "category": "accounting",
7335 "toolCount": 27,
7336 "triggerCount": 0
7337 },
@@ -7950,53 +7998,5 @@
7998 "category": "email",
7999 "toolCount": 9,
8000 "triggerCount": 0
7953 - },
7954 - {
7955 - "slug": "veriphone",
7956 - "name": "Veriphone",
7957 - "logo": "https://logos.composio.dev/api/veriphone",
7958 - "category": "developer tools",
7959 - "toolCount": 2,
7960 - "triggerCount": 0
7961 - },
7962 - {
7963 - "slug": "vestaboard",
7964 - "name": "Vestaboard",
7965 - "logo": "https://logos.composio.dev/api/vestaboard",
7966 - "category": "notifications",
7967 - "toolCount": 2,
7968 - "triggerCount": 0
7969 - },
7970 - {
7971 - "slug": "virustotal",
7972 - "name": "Virustotal",
7973 - "logo": "https://logos.composio.dev/api/virustotal",
7974 - "category": "security & identity tools",
7975 - "toolCount": 16,
7976 - "triggerCount": 0
7977 - },
7978 - {
7979 - "slug": "wachete",
7980 - "name": "Wachete",
7981 - "logo": "https://logos.composio.dev/api/wachete",
7982 - "category": "notifications",
7983 - "toolCount": 11,
7984 - "triggerCount": 0
7985 - },
7986 - {
7987 - "slug": "waiverfile",
7988 - "name": "Waiverfile",
7989 - "logo": "https://logos.composio.dev/api/waiverfile",
7990 - "category": "forms & surveys",
7991 - "toolCount": 2,
7992 - "triggerCount": 0
7993 - },
7994 - {
7995 - "slug": "wati",
7996 - "name": "Wati",
7997 - "logo": "https://logos.composio.dev/api/wati",
7998 - "category": "marketing automation",
7999 - "toolCount": 5,
8000 - "triggerCount": 0
8001 }
8002 ]
\ No newline at end of file
docs/public/data/toolkits.json
+5120 -1616
@@ -11,9 +11,9 @@
11 "composioManagedAuthSchemes": [
12 "OAUTH2"
13 ],
14 - "toolCount": 62,
14 + "toolCount": 63,
15 "triggerCount": 2,
16 - "version": "20260417_00",
16 + "version": "20260506_01",
17 "tools": [
18 {
19 "slug": "GMAIL_ADD_LABEL_TO_EMAIL",
@@ -235,6 +235,11 @@
235 "name": "Patch send-as alias",
236 "description": "Tool to patch the specified send-as alias for a Gmail user. Use when you need to update properties of an existing send-as email address such as display name, reply-to address, signature, default status, or SMTP configuration."
237 },
238 + {
239 + "slug": "GMAIL_REMOVE_LABEL",
240 + "name": "Remove label (Deprecated)",
241 + "description": "DEPRECATED: Use GMAIL_DELETE_LABEL instead. Permanently deletes a specific, existing user-created Gmail label by its ID for a user; cannot delete system labels."
242 + },
243 {
244 "slug": "GMAIL_REPLY_TO_THREAD",
245 "name": "Reply to email thread",
@@ -400,7 +405,7 @@
405 ],
406 "toolCount": 25,
407 "triggerCount": 0,
403 - "version": "20260414_00",
408 + "version": "20260429_00",
409 "tools": [
410 {
411 "slug": "COMPOSIO_CHECK_ACTIVE_CONNECTION",
@@ -465,27 +470,27 @@
470 {
471 "slug": "COMPOSIO_MANAGE_CONNECTIONS",
472 "name": "Manage connections",
468 - "description": "\nCreate or manage connections to user's apps. Returns a branded authentication link that works for OAuth, API keys, and all other auth types.\n\nCall policy:\n- First call COMPOSIO_SEARCH_TOOLS for the user's query.\n- If COMPOSIO_SEARCH_TOOLS indicates there is no active connection for a toolkit, call COMPOSIO_MANAGE_CONNECTIONS with the exact toolkit name(s) returned.\n- Do not call COMPOSIO_MANAGE_CONNECTIONS if COMPOSIO_SEARCH_TOOLS returns no main tools and no related tools.\n- Toolkit names in toolkits must exactly match toolkit identifiers returned by COMPOSIO_SEARCH_TOOLS; never invent names.\n- NEVER execute any toolkit tool without an ACTIVE connection.\n\nTool Behavior:\n- If a connection is Active, the tool returns the connection details. Always use this to verify connection status and fetch metadata.\n- If a connection is not Active, returns a authentication link (redirect_url) to create new connection.\n- If reinitiate_all is true, the tool forces reconnections for all toolkits, even if they already have active connections.\n\nWorkflow after initiating connection:\n- Always show the returned redirect_url as a FORMATTED MARKDOWN LINK to the user, and ask them to click on the link to finish authentication.\n- Begin executing tools only after the connection for that toolkit is confirmed Active.\n "
473 + "description": "\nCreate or manage connections to user's apps. Returns a branded authentication link that works for OAuth, API keys, and all other auth types.\n\nCall policy:\n- First call COMPOSIO_SEARCH_TOOLS for the user's query.\n- If COMPOSIO_SEARCH_TOOLS indicates there is no active connection for a toolkit, call COMPOSIO_MANAGE_CONNECTIONS with the exact toolkit name(s) returned.\n- Use exact toolkit slugs returned by COMPOSIO_SEARCH_TOOLS; never invent toolkit names.\n- NEVER execute any toolkit tool without an ACTIVE connection.\n\nTool Behavior:\n- If a connection is Active, the tool returns the connection details. Always use this to verify connection status and fetch metadata.\n- If a connection is not Active, returns a authentication link (redirect_url) to create new connection.\n- If reinitiate_all is true, the tool forces reconnections for all toolkits, even if they already have active connections.\n\nWorkflow after initiating connection:\n- Always show the returned redirect_url as a FORMATTED MARKDOWN LINK to the user, and ask them to click on the link to finish authentication.\n- Begin executing tools only after the connection for that toolkit is confirmed Active.\n "
474 },
475 {
476 "slug": "COMPOSIO_MULTI_EXECUTE_TOOL",
477 "name": "Multi Execute Composio Tools",
473 - "description": "\n Fast and parallel tool executor for tools and recipes discovered through COMPOSIO_SEARCH_TOOLS. Use this tool to execute up to 50 tools in parallel across apps only when they're logically independent (no ordering/output dependencies). Response contains structured outputs ready for immediate analysis - avoid reprocessing them via remote bash/workbench tools.\n\nPrerequisites:\n- Always use valid tool slugs and their arguments discovered through COMPOSIO_SEARCH_TOOLS. NEVER invent tool slugs or argument fields. ALWAYS pass STRICTLY schema-compliant arguments with each tool execution.\n- Ensure an ACTIVE connection exists for the toolkits that are going to be executed. If none exists, MUST initiate one via COMPOSIO_MANAGE_CONNECTIONS before execution.\n- Only batch tools that are logically independent - no ordering, no output-to-input dependencies, and no intra-call chaining (tools in one call can't use each other's outputs). DO NOT pass dummy or placeholder inputs; always resolve required inputs using appropriate tools first.\n\nUsage guidelines:\n- Use this whenever a tool is discovered and has to be called, either as part of a multi-step workflow or as a standalone tool.\n- If COMPOSIO_SEARCH_TOOLS returns a tool that can perform the task, prefer calling it via this executor. Do not write custom API calls or ad-hoc scripts for tasks that can be completed by available Composio tools.\n- Prefer parallel execution: group independent tools into a single multi-execute call where possible.\n- Predictively set sync_response_to_workbench=true if the response may be large or needed for later scripting. It still shows response inline; if the actual response data turns out small and easy to handle, keep everything inline and SKIP workbench usage.\n- Responses contain structured outputs for each tool. RULE: Small data - process yourself inline; large data - process in the workbench.\n- ALWAYS include inline references/links to sources in MARKDOWN format directly next to the relevant text. Eg provide slack thread links alongside with summary, render document links instead of raw IDs.\n\nRestrictions: Some tools or toolkits may be disabled in this environment. If the response indicates a restriction, inform the user and STOP execution immediately. Do NOT attempt workarounds or speculative actions.\n\n\n- CRITICAL: You MUST always include the 'memory' parameter - never omit it. Even if you think there's nothing to remember, include an empty object {} for memory.\n\nMemory Storage:\n- CRITICAL FORMAT: Memory must be a dictionary where keys are app names (strings) and values are arrays of strings. NEVER pass nested objects or dictionaries as values.\n- CORRECT format: {\"slack\": [\"Channel general has ID C1234567\"], \"gmail\": [\"John's email is john@example.com\"]}\n- Write memory entries in natural, descriptive language - NOT as key-value pairs. Use full sentences that clearly describe the relationship or information.\n- ONLY store information that will be valuable for future tool executions - focus on persistent data that saves API calls.\n- STORE: ID mappings, entity relationships, configs, stable identifiers.\n- DO NOT STORE: Action descriptions, temporary status updates, logs, or \"sent/fetched\" confirmations.\n- Examples of GOOD memory (store these):\n * \"The important channel in Slack has ID C1234567 and is called #general\"\n * \"The team's main repository is owned by user 'teamlead' with ID 98765\"\n * \"The user prefers markdown docs with professional writing, no emojis\" (user_preference)\n- Examples of BAD memory (DON'T store these):\n * \"Successfully sent email to john@example.com with message hi\"\n * \"Fetching emails from last day (Sep 6, 2025) for analysis\"\n- Do not repeat the memories stored or found previously.\n"
478 + "description": "\n Fast and parallel tool executor for tools discovered through COMPOSIO_SEARCH_TOOLS. Use this tool to execute up to 50 tools in parallel across apps only when they're logically independent (no ordering/output dependencies). Response contains structured outputs ready for immediate analysis - avoid reprocessing them via remote bash/workbench tools.\n\nPrerequisites:\n- Always use valid tool slugs and their arguments. NEVER invent tool slugs or argument fields. ALWAYS pass STRICTLY schema-compliant arguments with each tool execution.\n- Ensure an ACTIVE connection exists for the toolkits that are going to be executed. If none exists, MUST initiate one via COMPOSIO_MANAGE_CONNECTIONS before execution.\n- Only batch tools that are logically independent - no ordering, no output-to-input dependencies, and no intra-call chaining (tools in one call can't use each other's outputs). DO NOT pass dummy or placeholder inputs; always resolve required inputs using appropriate tools first.\n\nUsage guidelines:\n- If COMPOSIO_SEARCH_TOOLS returns a tool that can perform the task, prefer calling it via this executor. Do not write custom API calls or ad-hoc scripts for tasks that can be completed by available Composio tools.\n- Prefer parallel execution: group independent tools into a single multi-execute call where possible.\n- Predictively set sync_response_to_workbench=true if the response may be large or needed for later scripting. It still shows response inline; if the actual response data turns out small and easy to handle, keep everything inline and SKIP workbench usage.\n- Responses contain structured outputs for each tool. RULE: Small data - process yourself inline; large data - process in the workbench.\n- ALWAYS include inline references/links to sources in MARKDOWN format directly next to the relevant text. Eg provide slack thread links alongside with summary, render document links instead of raw IDs.\n\nRestrictions: Some tools or toolkits may be disabled in this environment. If the response indicates a restriction, inform the user and STOP execution immediately. Do NOT attempt workarounds or speculative actions.\n\n\n- CRITICAL: You MUST always include the 'memory' parameter - never omit it. Even if you think there's nothing to remember, include an empty object {} for memory.\n\nMemory Storage:\n- CRITICAL FORMAT: Memory must be a dictionary where keys are app names (strings) and values are arrays of strings. NEVER pass nested objects or dictionaries as values.\n- CORRECT format: {\"slack\": [\"Channel general has ID C1234567\"], \"gmail\": [\"John's email is john@example.com\"]}\n- Write memory entries in natural, descriptive language - NOT as key-value pairs. Use full sentences that clearly describe the relationship or information.\n- ONLY store information that will be valuable for future tool executions - focus on persistent data that saves API calls.\n- STORE: ID mappings, entity relationships, configs, stable identifiers.\n- DO NOT STORE: Action descriptions, temporary status updates, logs, or \"sent/fetched\" confirmations.\n- Examples of GOOD memory (store these):\n * \"The important channel in Slack has ID C1234567 and is called #general\"\n * \"The team's main repository is owned by user 'teamlead' with ID 98765\"\n * \"The user prefers markdown docs with professional writing, no emojis\" (user_preference)\n- Examples of BAD memory (DON'T store these):\n * \"Successfully sent email to john@example.com with message hi\"\n * \"Fetching emails from last day (Sep 6, 2025) for analysis\"\n- Do not repeat the memories stored or found previously.\n"
479 },
480 {
481 "slug": "COMPOSIO_REMOTE_BASH_TOOL",
482 "name": "Run bash commands",
478 - "description": "\n Execute bash commands in a REMOTE sandbox for file operations, data processing, and system tasks. Essential for handling large tool responses saved to remote files.\n PRIMARY USE CASES:\n- Process large tool responses saved by COMPOSIO_MULTI_EXECUTE_TOOL to remote sandbox\n- File system operations, extract specific information from JSON with shell tools like jq, awk, sed, grep, etc.\n- Commands run from /home/user directory by default\n "
483 + "description": "\n Execute bash commands in a REMOTE sandbox for file operations, data processing, and system tasks. Essential for handling large tool responses saved to remote files. **Hard 3-minute (180s) execution limit** — break large tasks into smaller commands.\n PRIMARY USE CASES:\n- Process large tool responses saved by COMPOSIO_MULTI_EXECUTE_TOOL to remote sandbox\n- File system operations, extract specific information from JSON with shell tools like jq, awk, sed, grep, etc.\n- Commands run from /home/user directory by default\n "
484 },
485 {
486 "slug": "COMPOSIO_REMOTE_WORKBENCH",
487 "name": "Execute Code remotely in work bench",
483 - "description": "\n Process **REMOTE FILES** or script BULK TOOL EXECUTIONS using Python code IN A REMOTE SANDBOX. If you can see the data in chat, DON'T USE THIS TOOL.\n**ONLY** use this when processing **data stored in a remote file** or when scripting bulk tool executions.\n\nDO NOT USE\n- When the complete response is already inline/in-memory, or you only need quick parsing, summarization, or basic math.\n\nUSE IF\n- To parse/analyze tool outputs saved to a remote file in the sandbox or to script multi-tool chains there.\n- For bulk or repeated executions of known Composio tools (e.g., add a label to 100 emails).\n- To call APIs via proxy_execute when no Composio tool exists for that API.\n\n\nOUTPUTS\n- Returns a compact result or, if too long, artifacts under `/home/user/.code_out`.\n\nIMPORTANT CODING RULES:\n 1. Stepwise Execution: Split work into small steps. Save intermediate outputs in variables or temporary file in `/tmp/`. Call COMPOSIO_REMOTE_WORKBENCH again for the next step. This improves composability and avoids timeouts.\n 2. Notebook Persistence: This is a persistent Jupyter notebook cell: variables, functions, imports, and in-memory state from previous and future code executions are preserved in the notebook's history and available for reuse. You also have a few helper functions available.\n 3. Parallelism & Timeout (CRITICAL): There is a hard timeout of 4 minutes so complete the code within that. Prioritize PARALLEL execution using ThreadPoolExecutor with suitable concurrency for bulk operations - e.g., call run_composio_tool or invoke_llm parallelly across rows to maximize efficiency.\n 3.1 If the data is large, split into smaller batches and call the workbench multiple times to avoid timeouts.\n 4. Checkpoints: Implement checkpoints (in memory or files) so that long runs can be resumed from the last completed step.\n 5. Schema Safety: Never assume the response schema for run_composio_tool if not known already from previous tools. To inspect schema, either run a simple request **outside** the workbench via COMPOSIO_MULTI_EXECUTE_TOOL or use invoke_llm helper.\n 6. LLM Helpers: Always use invoke_llm helper for summary, analysis, or field extraction on results. This is a smart LLM that will give much better results than any adhoc filtering.\n 7. Avoid Meta Loops: Do not use run_composio_tool to call COMPOSIO_MULTI_EXECUTE_TOOL or other COMPOSIO_* meta tools to avoid cycles. Only use it for app tools.\n 8. Pagination: Use when data spans multiple pages. Continue fetching pages with the returned next_page_token or cursor until none remains. Parallelize fetching pages if tool supports page_number.\n 9. No Hardcoding: Never hardcode data in code. Always load it from files or tool responses, iterating to construct intermediate or final inputs/outputs.\n 10. If the final output is in a workbench file, use upload_local_file to download it - never expose the raw workbench file path to the user. Prefer to download useful artifacts after task is complete.\n\n\nENV & HELPERS:\n- Home directory: `/home/user`.\n- NOTE: Helper functions already initialized in the workbench - DO NOT import or redeclare them:\n - \n`run_composio_tool(tool_slug: str, arguments: dict) -> tuple[Dict[str, Any], str]`: Execute a known Composio **app** tool (from COMPOSIO_SEARCH_TOOLS). Do not invent names; match the tool's input schema. Suited for loops/parallel/bulk over datasets.\n i) run_composio_tool returns JSON with top-level \"data\". Parse carefully—structure may be nested.\n \n - \n`invoke_llm(query: str) -> tuple[str, str]`: Invoke an LLM for semantic tasks. Pass MAX 200k characters in input.\n i) NOTE Prompting guidance: When building prompts for invoke_llm, prefer f-strings (or concatenation) so literal braces stay intact. If using str.format, escape braces by doubling them ({{ }}).\n ii) Define the exact JSON schema you want and batch items into smaller groups to stay within token limit.\n\n - `upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]`: Upload files in workbench to Composio S3/R2 storage. Use this to download any generated files/artifacts from the workbench.\n - `proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None) -> tuple[Any, str]`: Call a toolkit API directly when no Composio tool exists. Only one toolkit can be invoked with proxy_execute per workbench call\n - `web_search(query: str) -> tuple[str, str]`: Search the web for information.\n - `smart_file_extract(sandbox_file_path: str, show_preview: bool = True) -> tuple[str, str]`: Extracts text from files in the sandbox (e.g., PDF, image).\n - Workbench comes with comprehensive Image Processing (PIL/Pillow, OpenCV, scikit-image), PyTorch ML libraries, Document and Report handling tools (pandoc, python-docx, pdfplumber, reportlab), and standard Data Analysis tools (pandas, numpy, matplotlib) for advanced visual, analytical, and AI tasks.\n All helper functions return a tuple (result, error). Always check error before using result.\n\n## Python Helper Functions for LLM Scripting\n\n\n### run_composio_tool(tool_slug, arguments)\nExecutes a known Composio tool via backend API. Do NOT call COMPOSIO_* meta tools to avoid cyclic calls.\n\n def run_composio_tool(tool_slug: str, arguments: Dict[str, Any]) -> tuple[Dict[str, Any], str]\n # Returns: (tool_response_dict, error_message)\n # Success: ({\"data\": {actual_data}}, \"\") - Note the top-level data\n # Error: ({}, \"error_message\") or (response_data, \"error_message\")\n\n result, error = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 1, \"user_id\": \"me\"})\n if error:\n print(\"GMAIL_FETCH_EMAILS error:\", error); return\n email_data = result.get(\"data\", {})\n print(\"Fetched:\", email_data)\n \n\n\n### invoke_llm(query)\nCalls LLM for reasoning, analysis, and semantic tasks. Pass MAX 200k characters input.\n\n def invoke_llm(query: str) -> tuple[str, str]\n # Returns: (llm_response, error_message)\n\n resp, error = invoke_llm(\"Summarize the key points from this data\")\n if not error:\n print(\"LLM:\", resp)\n\n # Example: analyze tool response with LLM\n tool_resp, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5, \"user_id\": \"me\"})\n if not err:\n parsed = tool_resp.get(\"data\", {})\n resp, err2 = invoke_llm(f\"Analyze these emails and summarize: {parsed}\")\n if not err2:\n print(\"LLM Gmail Summary:\", resp)\n # TIP: batch prompts to reduce LLM calls.\n \n\n\n### upload_local_file(*file_paths)\nUploads sandbox files to Composio S3/R2 storage. Single files upload directly, multiple files are auto-zipped.\nUse this when you need to upload/download any generated artifacts from the sandbox.\n\n def upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]\n # Returns: (result_dict, error_string)\n # Success: ({\"s3_url\": str, \"uploaded_file\": str, \"type\": str, \"id\": str, \"s3key\": str, \"message\": str}, \"\")\n # Error: ({}, \"error_message\")\n\n # Single file\n result, error = upload_local_file(\"/path/to/report.pdf\")\n\n # Multiple files (auto-zipped)\n result, error = upload_local_file(\"/home/user/doc1.txt\", \"/home/user/doc2.txt\")\n\n if not error:\n print(\"Uploaded:\", result[\"s3_url\"])\n\n\n### proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None)\nDirect API call to a connected toolkit service.\n\n def proxy_execute(\n method: Literal[\"GET\",\"POST\",\"PUT\",\"DELETE\",\"PATCH\"],\n endpoint: str,\n toolkit: str,\n query_params: Optional[Dict[str, str]] = None,\n body: Optional[object] = None,\n headers: Optional[Dict[str, str]] = None,\n ) -> tuple[Any, str]\n # Returns: (response_data, error_message)\n\n # Example: GET request with query parameters\n query_params = {\"q\": \"is:unread\", \"maxResults\": \"10\"}\n data, error = proxy_execute(\"GET\", \"/gmail/v1/users/me/messages\", \"gmail\", query_params=query_params)\n if not error:\n print(\"Success:\", data)\n\n\n### web_search(query)\nSearches the web via Exa AI.\n\n def web_search(query: str) -> tuple[str, str]\n # Returns: (search_results_text, error_message)\n\n results, error = web_search(\"latest developments in AI\")\n if not error:\n print(\"Results:\", results)\n\n## Best Practices\n\n\n### Error-first pattern and Defensive parsing (print keys while narrowing)\n res, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5})\n if err:\n print(\"error:\", err); return\n if isinstance(res, dict):\n print(\"res keys:\", list(res.keys()))\n data = res.get(\"data\") or {}\n print(\"data keys:\", list(data.keys()))\n msgs = data.get(\"messages\") or []\n print(\"messages count:\", len(msgs))\n for m in msgs:\n print(\"subject:\", m.get(\"subject\", \"<missing>\"))\n\n### Parallelize (4-min sandbox timeout)\nAdjust concurrency so all tasks finish within 4 minutes.\n\n import concurrent.futures\n\n MAX_CONCURRENCY = 10 # Adjust as needed\n\n def send_bulk_emails(email_list):\n def send_single(email):\n result, error = run_composio_tool(\"GMAIL_SEND_EMAIL\", {\n \"to\": email[\"recipient\"], \"subject\": email[\"subject\"], \"body\": email[\"body\"]\n })\n if error:\n print(f\"Failed {email['recipient']}: {error}\")\n return {\"status\": \"failed\", \"error\": error}\n return {\"status\": \"sent\", \"data\": result}\n\n results = []\n with concurrent.futures.ThreadPoolExecutor(max_workers=MAX_CONCURRENCY) as ex:\n futures = [ex.submit(send_single, e) for e in email_list]\n for f in concurrent.futures.as_completed(futures):\n results.append(f.result())\n return results\n\n email_list = [{\"recipient\": f\"user{i}@example.com\", \"subject\": \"Test\", \"body\": \"Hello\"} for i in range(1000)]\n results = send_bulk_emails(email_list)\n \n\n "
488 + "description": "\n Process **REMOTE FILES** or script BULK TOOL EXECUTIONS using Python code IN A REMOTE SANDBOX. If you can see the data in chat, DON'T USE THIS TOOL.\n**ONLY** use this when processing **data stored in a remote file** or when scripting bulk tool executions.\n\nDO NOT USE\n- When the complete response is already inline/in-memory, or you only need quick parsing, summarization, or basic math.\n\nUSE IF\n- To parse/analyze tool outputs saved by COMPOSIO_MULTI_EXECUTE_TOOL to a remote file in the sandbox or to script multi-tool chains there.\n- For bulk or repeated executions of known Composio tools (e.g., add a label to 100 emails).\n- To call APIs via proxy_execute when no Composio tool exists for that API.\n\n\nOUTPUTS\n- Returns a compact result or, if too long, artifacts under `/mnt/files/.composio/output` (cloud-backed FUSE mount, persisted across sandbox restarts).\n\nIMPORTANT CODING RULES:\n 1. Stepwise Execution: Split work into small steps. Save intermediate outputs to `/mnt/files/` (cloud-backed, persisted across failures/timeouts) or variables. Call COMPOSIO_REMOTE_WORKBENCH again for the next step.\n 2. Notebook Persistence: This is a persistent Jupyter notebook cell: variables, functions, imports, and in-memory state persist across executions. Helper functions are preloaded.\n 3. Top-level cells: Do not use `return`; Jupyter only allows it inside functions. For final values, end with `output` or `print(output)`, not `return output`.\n 4. Parallelism & Timeout (CRITICAL): There is a **hard 3-minute (180s) execution limit** per cell. Always prioritize PARALLEL execution using ThreadPoolExecutor for bulk operations - e.g., call run_composio_tool or invoke_llm across rows. If data is large, split it into smaller batches across cells.\n 5. Checkpoints: Save checkpoints to `/mnt/files/` so that long runs can be resumed from the last completed step, even after a timeout or sandbox restart.\n 6. Schema Safety: Never assume the response schema for run_composio_tool if not known already from previous tools. To inspect schema, either run a simple request **outside** the workbench or use invoke_llm helper.\n 7. LLM Helpers: Always use invoke_llm helper for summary, analysis, or field extraction on results; prefer it for much better results over ad hoc filtering.\n 8. Avoid Meta Loops: Do not use run_composio_tool to call COMPOSIO_* meta tools. Only use it for app tools.\n 9. Pagination: Use when data spans multiple pages. Continue fetching pages with the returned next_page_token or cursor until none remains. Parallelize page fetches when the tool supports page_number.\n 10. No Hardcoding: Never hardcode data. Load it from files or tool responses, iterating to construct intermediate or final inputs/outputs.\n 11. If the final output is in a workbench file, use upload_local_file to download it - never expose the raw workbench file path to the user. Prefer to download useful artifacts after task is complete.\n\n\nENV & HELPERS:\n- Home directory: `/home/user`.\n- NOTE: Helper functions already initialized in the workbench - DO NOT import or redeclare them:\n - \n`run_composio_tool(tool_slug: str, arguments: dict) -> tuple[Dict[str, Any], str]`: Execute a known Composio **app** tool. Do not invent names; match the tool input schema. Use for loops/parallel/bulk calls.\n i) run_composio_tool returns JSON with top-level \"data\". Parse carefully—structure may be nested.\n \n - \n`invoke_llm(query: str) -> tuple[str, str]`: Invoke an LLM for semantic tasks. Pass MAX 200k characters.\n i) NOTE Prompting guidance: When building prompts for invoke_llm, prefer f-strings (or concatenation) so literal braces stay intact. If using str.format, escape braces by doubling them ({{ }}).\n ii) Define the exact JSON schema you want and batch items into smaller groups to stay within token limit.\n\n - `upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]`: Upload sandbox files to Composio S3/R2 storage for user-downloadable artifacts.\n - `proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None) -> tuple[Any, str]`: Call a toolkit API directly when no Composio tool exists. Only one toolkit can be invoked with proxy_execute per workbench call\n - `web_search(query: str) -> tuple[str, str]`: Search the web for information.\n - `smart_file_extract(sandbox_file_path: str, show_preview: bool = True) -> tuple[str, str]`: Extracts text from files in the sandbox (e.g., PDF, image).\n - Workbench comes with comprehensive Image Processing (PIL/Pillow, OpenCV, scikit-image), PyTorch ML libraries, Document and Report handling tools (pandoc, python-docx, pdfplumber, reportlab), and standard Data Analysis tools (pandas, numpy, matplotlib) for advanced visual, analytical, and AI tasks.\n All helper functions return a tuple (result, error). Always check error before using result.\n\n## Python Helper Functions for LLM Scripting\n\n\n### run_composio_tool\nExecutes a known Composio tool via backend API. Do NOT call COMPOSIO_* meta tools to avoid cycles.\n\n def run_composio_tool(tool_slug: str, arguments: Dict[str, Any]) -> tuple[Dict[str, Any], str]\n # Returns: (tool_response_dict, error_message)\n # Success: ({\"data\": {actual_data}}, \"\") - Note the top-level data\n # Error: ({}, \"error_message\") or (response_data, \"error_message\")\n\n result, error = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 1, \"user_id\": \"me\"})\n if error:\n print(\"GMAIL_FETCH_EMAILS error:\", error)\n else:\n email_data = result.get(\"data\", {})\n print(\"Fetched:\", email_data)\n \n\n\n### invoke_llm\nCalls LLM for reasoning, analysis, and semantic tasks. Pass MAX 200k characters.\n\n def invoke_llm(query: str) -> tuple[str, str]\n # Returns: (llm_response, error_message)\n\n # Example: analyze tool response with LLM\n tool_resp, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5, \"user_id\": \"me\"})\n if not err:\n parsed = tool_resp.get(\"data\", {})\n resp, err2 = invoke_llm(f\"Summarize these emails: {parsed}\")\n if not err2:\n print(resp)\n # TIP: batch prompts to reduce LLM calls.\n \n\n\n### upload_local_file\nUploads sandbox files to Composio S3/R2 storage for upload/download requests involving generated sandbox artifacts. Single files upload directly; multiple files are auto-zipped.\n\n def upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]\n # Returns: (result_dict, error_string)\n # Success: ({\"s3_url\": str, \"uploaded_file\": str, \"type\": str, \"id\": str, \"s3key\": str, \"message\": str}, \"\")\n # Error: ({}, \"error_message\")\n\n # Single file\n result, error = upload_local_file(\"/path/to/report.pdf\")\n\n # Multiple files are auto-zipped\n result, error = upload_local_file(\"/home/user/doc1.txt\", \"/home/user/doc2.txt\")\n\n if not error:\n print(\"Uploaded:\", result[\"s3_url\"])\n\n\n### proxy_execute\nDirect API call to a connected toolkit service.\n\n def proxy_execute(\n method: Literal[\"GET\",\"POST\",\"PUT\",\"DELETE\",\"PATCH\"],\n endpoint: str,\n toolkit: str,\n query_params: Optional[Dict[str, str]] = None,\n body: Optional[object] = None,\n headers: Optional[Dict[str, str]] = None,\n ) -> tuple[Any, str]\n # Returns: (response_data, error_message)\n\n # Example: GET request with query parameters\n query_params = {\"q\": \"is:unread\", \"maxResults\": \"10\"}\n data, error = proxy_execute(\"GET\", \"/gmail/v1/users/me/messages\", \"gmail\", query_params=query_params)\n if not error:\n print(\"Success:\", data)\n\n\n### web_search\nSearches the web via Exa AI.\n\n def web_search(query: str) -> tuple[str, str]\n # Returns: (search_results_text, error_message)\n\n results, error = web_search(\"latest developments in AI\")\n if not error:\n print(\"Results:\", results)\n\n## Best Practices\n\n\n### Error-first pattern and Defensive parsing (print keys while narrowing)\n res, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5})\n if err:\n print(\"error:\", err)\n elif isinstance(res, dict):\n print(\"res keys:\", list(res.keys()))\n data = res.get(\"data\") or {}\n print(\"data keys:\", list(data.keys()))\n msgs = data.get(\"messages\") or []\n print(\"messages count:\", len(msgs))\n for m in msgs:\n print(\"subject:\", m.get(\"subject\", \"<missing>\"))\n\n### Parallelize within the 3-minute cell timeout\nAdjust concurrency so all tasks finish within 3 minutes.\n\n import concurrent.futures\n\n MAX_CONCURRENCY = 10 # Adjust as needed\n\n def process_one(item):\n result, error = run_composio_tool(\"GMAIL_SEND_EMAIL\", item)\n if error:\n return {\"status\": \"failed\", \"error\": error}\n return {\"status\": \"ok\", \"data\": result}\n\n with concurrent.futures.ThreadPoolExecutor(max_workers=MAX_CONCURRENCY) as ex:\n results = list(ex.map(process_one, items))\n \n\n "
489 },
490 {
491 "slug": "COMPOSIO_SEARCH_TOOLS",
492 "name": "Search Composio Tools",
488 - "description": "\n MCP Server Info: COMPOSIO MCP connects 500+ apps—Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calendar), Microsoft (Outlook, Teams), X/Twitter, Figma, Web Search / Deep research, Browser tool (scrape URLs, browser automation), Meta apps (Instagram, Meta Ads), TikTok, AI tools like Nano Banana & Veo3, and more—for seamless cross-app automation.\n Use this MCP server to discover the right tools and the recommended step-by-step plan to execute reliably.\n ALWAYS call this tool first whenever a user mentions or implies an external app, service, or workflow—never say \"I don't have access to X/Y app\" before calling it.\n\n Tool Info: Extremely fast discovery tool that returns relevant MCP-callable tools along with a recommended execution plan and common pitfalls for reliable execution.\n\nUsage guidelines:\n - Use this tool whenever kicking off a task. Re-run it when you need additional tools/plans due to missing details, errors, or a changed use case.\n - If the user pivots to a different use case in same chat, you MUST call this tool again with the new use case and generate a new session_id.\n - Specify the use_case with a normalized description of the problem, query, or task. Be clear and precise. Queries can be simple single-app actions or multiple linked queries for complex cross-app workflows.\n - Pass known_fields along with use_case as a string of key–value hints (for example, \"channel_name: general\") to help the search resolve missing details such as IDs.\n \n\nSplitting guidelines (Important):\n 1. Atomic queries: 1 query = 1 tool call. Include hidden prerequisites (e.g., add \"get Linear issue\" before \"update Linear issue\").\n 2. Include app names: If user names a toolkit, include it in every sub query so intent stays scoped (e.g., \"fetch Gmail emails\", \"reply to Gmail email\").\n 3. English input: Translate non-English prompts while preserving intent and identifiers.\n\n Example:\n User query: \"send an email to John welcoming him and create a meeting invite for tomorrow\"\n Search call: queries: [\n {use_case: \"send an email to someone\", known_fields: \"recipient_name: John\"},\n {use_case: \"create a meeting invite\", known_fields: \"meeting_date: tomorrow\"}\n ]\n\nPlan review checklist (Important):\n - The response includes a detailed execution plan and common pitfalls. You MUST review this plan carefully, adapt it to your current context, and generate your own final step-by-step plan before execution. Execute the steps in order to ensure reliable and accurate execution. Skipping or ignoring required steps can lead to unexpected failures.\n - Check the plan and pitfalls for input parameter nuances (required fields, IDs, formats, limits). Before executing any tool, you MUST review its COMPLETE input schema and provide STRICTLY schema-compliant arguments to avoid invalid-input errors.\n - Determine whether pagination is needed; if a response returns a pagination token and completeness is implied, paginate until exhaustion and do not return partial results.\n\nResponse:\n - Tools & Input Schemas: The response lists toolkits (apps) and tools suitable for the task, along with their tool_slug, description, input schema / schemaRef, and related tools for prerequisites, alternatives, or next steps.\n - NOTE: Tools with schemaRef instead of input_schema require you to call COMPOSIO_GET_TOOL_SCHEMAS first to load their full input_schema before use.\n - Connection Info: If a toolkit has an active connection, the response includes it along with any available current user information. If no active connection exists, you MUST initiate a new connection via COMPOSIO_MANAGE_CONNECTIONS with the correct toolkit name. DO NOT execute any toolkit tool without an ACTIVE connection.\n - Time Info: The response includes the current UTC time for reference. You can reference UTC time from the response if needed.\n - The tools returned to you through this are to be called via COMPOSIO_MULTI_EXECUTE_TOOL. Ensure each tool execution specifies the correct tool_slug and arguments exactly as defined by the tool's input schema.\n - The response includes a memory parameter containing relevant information about the use case and the known fields that can be used to determine the flow of execution. Any user preferences in memory must be adhered to.\n\nSESSION: ALWAYS set this parameter, first for any workflow. Pass session: {generate_id: true} for new workflows OR session: {id: \"EXISTING_ID\"} to continue. ALWAYS use the returned session_id in ALL subsequent meta tool calls.\n "
493 + "description": "\n Tool Server Info: Composio connects 500+ apps—Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calendar), Microsoft (Outlook, Teams), X/Twitter, Figma, Web Search / Deep research, Browser tool (scrape URLs, browser automation), Meta apps (Instagram, Meta Ads), TikTok, AI tools like Nano Banana & Veo3, and more—for seamless cross-app automation.\n Use this tool to discover relevant tools plus the recommended plan and common pitfalls for reliable execution.\n Always call this tool first whenever a user mentions or implies an external app, service, or workflow—never say \"I don't have access to X/Y app\" before calling it.\n\nUsage guidelines:\n - Use this tool whenever kicking off a task. Re-run it when you need additional tools/plans due to missing details, errors, or a changed use case.\n - If the user pivots to a different use case in same chat, you MUST call this tool again with the new use case and generate a new session_id.\n - Specify the use_case with a normalized description of the problem, query, or task. Be clear and precise. Queries can be simple single-app actions or multiple linked queries for complex cross-app workflows.\n - Pass known_fields along with use_case as a string of key–value hints (for example, \"channel_name: general\") to help the search resolve missing details such as IDs.\n \n\nSplitting guidelines (Important):\n 1. Atomic queries: 1 query = 1 tool call. Include hidden prerequisites (e.g., add \"get Linear issue\" before \"update Linear issue\").\n 2. Include app names: If user names a toolkit, include it in every sub query so intent stays scoped (e.g., \"fetch Gmail emails\", \"reply to Gmail email\").\n 3. English input: Translate non-English prompts while preserving intent and identifiers.\n\n Example:\n User query: \"send an email to John welcoming him and create a meeting invite for tomorrow\"\n Search call: queries: [\n {use_case: \"send an email to someone\", known_fields: \"recipient_name: John\"},\n {use_case: \"create a meeting invite\", known_fields: \"meeting_date: tomorrow\"}\n ]\n\nPlan review checklist (Important):\n - The response includes a detailed execution plan and common pitfalls. You MUST review this plan carefully, adapt it to your current context, and generate your own final step-by-step plan before execution. Execute the steps in order to ensure reliable and accurate execution. Skipping or ignoring required steps can lead to unexpected failures.\n - Check the plan and pitfalls for input parameter nuances (required fields, IDs, formats, limits). Before executing any tool, you MUST review its COMPLETE input schema and provide STRICTLY schema-compliant arguments to avoid invalid-input errors.\n - Determine whether pagination is needed; if a response returns a pagination token and completeness is implied, paginate until exhaustion and do not return partial results.\n\nResponse:\n - Tools & Input Schemas: The response lists toolkits (apps) and tools suitable for the task, along with their tool_slug, description, input schema / schemaRef, and related tools for prerequisites, alternatives, or next steps.\n - NOTE: Tools with schemaRef instead of input_schema require you to call COMPOSIO_GET_TOOL_SCHEMAS first to load their full input_schema before use.\n - Connection Info: If a toolkit has an active connection, the response includes it along with any available current user information. If no active connection exists, you MUST initiate a new connection via COMPOSIO_MANAGE_CONNECTIONS with the correct toolkit name. DO NOT execute any toolkit tool without an ACTIVE connection.\n - Time Info: The response includes the current UTC time for reference. You can reference UTC time from the response if needed.\n \n - The tools returned to you through this are to be called via COMPOSIO_MULTI_EXECUTE_TOOL. Ensure each tool execution specifies the correct tool_slug and arguments exactly as defined by the tool's input schema.\n - The response includes a memory parameter containing relevant information about the use case and the known fields that can be used to determine the flow of execution. Any user preferences in memory must be adhered to.\n\nSESSION: ALWAYS set this parameter, first for any workflow. Pass session: {generate_id: true} for new workflows OR session: {id: \"EXISTING_ID\"} to continue. ALWAYS use the returned session_id in ALL subsequent meta tool calls.\n "
494 },
495 {
496 "slug": "COMPOSIO_WAIT_FOR_CONNECTION",
@@ -560,7 +565,7 @@
565 ],
566 "toolCount": 867,
567 "triggerCount": 20,
563 - "version": "20260415_00",
568 + "version": "20260501_01",
569 "tools": [
570 {
571 "slug": "GITHUB_ABORT_REPOSITORY_MIGRATION",
@@ -5063,9 +5068,9 @@
5068 "composioManagedAuthSchemes": [
5069 "OAUTH2"
5070 ],
5066 - "toolCount": 46,
5071 + "toolCount": 48,
5072 "triggerCount": 7,
5068 - "version": "20260417_00",
5073 + "version": "20260429_00",
5074 "tools": [
5075 {
5076 "slug": "GOOGLECALENDAR_ACL_DELETE",
@@ -5242,6 +5247,16 @@
5247 "name": "Get current date and time",
5248 "description": "Gets the current date and time, allowing for a specific timezone offset. Call this tool first before computing relative dates (e.g., 'tomorrow', 'next Monday') to avoid off-by-one-day errors across timezones."
5249 },
5250 + {
5251 + "slug": "GOOGLECALENDAR_LIST_BUILDINGS",
5252 + "name": "List Buildings",
5253 + "description": "Lists all buildings for a Google Workspace customer account with full details including addresses, coordinates, and floor names. Use this action when you need to retrieve the complete list of physical building locations configured in Google Workspace Calendar resources. This is useful for workspace administrators managing conference room and resource scheduling across multiple office buildings. Requires Google Workspace administrator privileges with Directory API access."
5254 + },
5255 + {
5256 + "slug": "GOOGLECALENDAR_LIST_CALENDAR_RESOURCES",
5257 + "name": "List Calendar Resources",
5258 + "description": "Retrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API. Use this action when you need to list available meeting rooms, conference spaces, or other bookable calendar resources in an organization. The action supports filtering by resource category, capacity, building location, and other criteria. IMPORTANT: This requires Admin SDK Directory API access and appropriate admin permissions - it is NOT available for personal Gmail accounts, only Google Workspace domains."
5259 + },
5260 {
5261 "slug": "GOOGLECALENDAR_LIST_CALENDARS",
5262 "name": "List Google Calendars",
@@ -5312,7 +5327,7 @@
5327 {
5328 "slug": "GOOGLECALENDAR_EVENT_STARTING_SOON_TRIGGER",
5329 "name": "Event Starting Soon",
5315 - "description": "Triggers when a calendar event is within a configured number of minutes from starting.\n Includes countdown window, start time, and event metadata."
5330 + "description": "Triggers when a calendar event is within a configured number of minutes from starting.\n Returns event details, time remaining, attendees, and join links when available."
5331 },
5332 {
5333 "slug": "GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CHANGE_TRIGGER",
@@ -5400,8 +5415,8 @@
5415 "OAUTH2"
5416 ],
5417 "toolCount": 48,
5403 - "triggerCount": 5,
5404 - "version": "20260417_00",
5418 + "triggerCount": 13,
5419 + "version": "20260501_00",
5420 "tools": [
5421 {
5422 "slug": "NOTION_ADD_MULTIPLE_PAGE_CONTENT",
@@ -5650,11 +5665,31 @@
5665 "name": "All Page Events",
5666 "description": "Triggers when any Notion page is created or updated across the workspace."
5667 },
5668 + {
5669 + "slug": "NOTION_COMMENT_CREATED",
5670 + "name": "Comment Created",
5671 + "description": "Triggers when a new comment is created in Notion.\n\n Optional `page_id` filter scopes to comments on a specific page. When\n omitted, fires for any new comment in the workspace the integration\n has access to.\n\n Requires the 'Read comments' capability on the Notion integration. If\n a connection was authorized before that capability was enabled, the\n user must re-authorize the connection for comment events to flow."
5672 + },
5673 {
5674 "slug": "NOTION_COMMENTS_ADDED_TRIGGER",
5675 "name": "New Comment",
5676 "description": "Triggers when a new comment is added to a specified Notion block or page."
5677 },
5678 + {
5679 + "slug": "NOTION_DATABASE_CREATED",
5680 + "name": "Database Created",
5681 + "description": "Triggers when a new Notion database (the container) is created.\n\n A database is the post-2025-09-03 container that holds one or more data\n sources. This trigger fires for the container's creation event\n (`database.created`), distinct from `NOTION_DATASOURCE_CREATED` which\n fires when a new data source is added to an existing database.\n\n Most customers calling Notion's `POST /v1/databases` (the legacy API)\n or creating a database via the Notion UI will see this event. Adding a\n new data source to an existing database fires `data_source.created`\n instead — use `NOTION_DATASOURCE_CREATED` for that.\n\n Notion's payload puts `entity.type: \"block\"` (the container is a\n `child_database` block in the content tree) and `entity.id` is the\n database id."
5682 + },
5683 + {
5684 + "slug": "NOTION_DATASOURCE_CREATED",
5685 + "name": "Data Source Created",
5686 + "description": "Triggers when a new Notion data source is created.\n\n Fires workspace-wide. The payload's `data.parent` carries the data\n source's tree parent (typically the teamspace) for downstream\n filtering.\n\n A single template-based database creation can fire multiple\n `data_source.created` events at once — one per data source the\n template instantiates."
5687 + },
5688 + {
5689 + "slug": "NOTION_DATASOURCE_SCHEMA_UPDATED",
5690 + "name": "Data Source Schema Updated",
5691 + "description": "Triggers when a Notion data source's schema is updated.\n\n Fires on column add / remove / rename. Payload includes\n `data.updated_properties: [{id, name, action}]` so consumers can\n discriminate the kind of change downstream.\n\n Optional `data_source_id` filter scopes to schema changes on a single\n data source. When omitted, fires for any schema change in the\n workspace the integration has access to.\n\n Note: adding a column also fires `page.properties_updated` once per\n existing row in the data source. Customers wanting a single\n structural-change signal should use this trigger."
5692 + },
5693 {
5694 "slug": "NOTION_PAGE_ADDED_TO_DATABASE",
5695 "name": "New Page",
@@ -5665,10 +5700,30 @@
5700 "name": "Page Added to Page",
5701 "description": "Fires when a new subpage (a `child_page` type block) is added under a specified parent Notion page."
5702 },
5703 + {
5704 + "slug": "NOTION_PAGE_CONTENT_UPDATED",
5705 + "name": "Page Content Updated",
5706 + "description": "Triggers when the body content of a Notion page is updated.\n\n Customer optionally scopes with at most one of:\n - data_source_id: any row in this data source\n - page_id: this specific page\n - parent_page_id: any page whose immediate parent is this page\n\n With none set, fires for any page content edit in the workspace the\n integration has access to. Notion aggregates content edits within a\n short window (~60s typical)."
5707 + },
5708 + {
5709 + "slug": "NOTION_PAGE_CREATED",
5710 + "name": "Page Created",
5711 + "description": "Triggers when a new Notion page is created.\n\n Customer optionally scopes with at most one of:\n - data_source_id: new row in this data source\n - parent_page_id: new sub-page under this page (immediate parent only)\n\n With neither set, fires for any new page in the workspace the\n integration has access to. Notion sends ~60s aggregation latency on\n most events."
5712 + },
5713 + {
5714 + "slug": "NOTION_PAGE_PROPERTIES_UPDATED",
5715 + "name": "Page Properties Updated",
5716 + "description": "Triggers when properties of a Notion page are updated.\n\n Customer optionally scopes with at most one of:\n - data_source_id: any row in this data source\n - page_id: this specific page\n - parent_page_id: any page whose immediate parent is this page\n\n With none set, fires for any property change in the workspace the\n integration has access to. Adding a column to a data source fires this\n trigger once per existing row. Customers can branch on\n `data.updated_properties` (array of property IDs) to filter downstream."
5717 + },
5718 {
5719 "slug": "NOTION_PAGE_UPDATED_TRIGGER",
5720 "name": "Page Updated",
5721 "description": "Triggers when any block within a specified Notion page is updated."
5722 + },
5723 + {
5724 + "slug": "NOTION_VIEW_CREATED",
5725 + "name": "View Created",
5726 + "description": "Triggers when a new Notion view is created.\n\n Fires workspace-wide. The payload includes `data.view_type`\n (`table`, `board`, `gallery`, `calendar`, `list`, `timeline`, `gantt`)\n and `data.parent` pointing at the view's tree parent (typically the\n teamspace), so customers can filter downstream."
5727 }
5728 ],
5729 "authConfigDetails": [
@@ -5757,9 +5812,9 @@
5812 "composioManagedAuthSchemes": [
5813 "OAUTH2"
5814 ],
5760 - "toolCount": 48,
5815 + "toolCount": 50,
5816 "triggerCount": 16,
5762 - "version": "20260417_00",
5817 + "version": "20260506_00",
5818 "tools": [
5819 {
5820 "slug": "GOOGLESHEETS_ADD_SHEET",
@@ -5831,6 +5886,11 @@
5886 "name": "Create spreadsheet row",
5887 "description": "Inserts a new, empty row into a specified sheet of a Google Spreadsheet at a given index, optionally inheriting formatting from the row above."
5888 },
5889 + {
5890 + "slug": "GOOGLESHEETS_DELETE_CHART",
5891 + "name": "Delete Chart from Google Sheets",
5892 + "description": "Delete an existing chart from a Google Sheets spreadsheet. Use this action when you need to remove a chart that is no longer needed or needs to be replaced. This action is irreversible — once a chart is deleted, it cannot be recovered. The chart data source (the cells containing the data) remains unchanged; only the chart visualization is removed."
5893 + },
5894 {
5895 "slug": "GOOGLESHEETS_DELETE_DIMENSION",
5896 "name": "Delete Dimension (Rows/Columns)",
@@ -5966,6 +6026,11 @@
6026 "name": "Batch Get Spreadsheet Values by Data Filter",
6027 "description": "Tool to return one or more ranges of values from a spreadsheet that match the specified data filters. Use when you need to retrieve specific data sets based on filtering criteria rather than entire sheets or fixed ranges."
6028 },
6029 + {
6030 + "slug": "GOOGLESHEETS_UPDATE_CHART",
6031 + "name": "Update Chart in Google Sheets",
6032 + "description": "Update the specification of an existing chart in a Google Sheets spreadsheet. Use this action when you need to modify an existing chart's properties such as its title, chart type, data ranges, colors, axes, or other visual settings. This action updates the chart's specification but does not change its position or size on the sheet."
6033 + },
6034 {
6035 "slug": "GOOGLESHEETS_UPDATE_DIMENSION_PROPERTIES",
6036 "name": "Update Dimension Properties (Hide/Unhide & Resize)",
@@ -6148,8 +6213,8 @@
6213 "OAUTH2"
6214 ],
6215 "toolCount": 151,
6151 - "triggerCount": 5,
6152 - "version": "20260417_00",
6216 + "triggerCount": 8,
6217 + "version": "20260506_02",
6218 "tools": [
6219 {
6220 "slug": "SLACK_ADD_CALL_PARTICIPANTS",
@@ -6204,7 +6269,7 @@
6269 {
6270 "slug": "SLACK_ASSISTANT_SEARCH_CONTEXT",
6271 "name": "Real-time search",
6207 - "description": "Search across Slack messages, files, channels, and users using Real-time Search API. BEFORE USING: Call SLACK_ASSISTANT_SEARCH_INFO to check workspace capabilities. - If is_ai_search_enabled=true → Use natural language queries (semantic search) - If is_ai_search_enabled=false → Pass disable_semantic_search=true (keyword search) - If SLACK_ASSISTANT_SEARCH_INFO fails or is unavailable → Default to disable_semantic_search=true (safe keyword fallback) Works on ALL Slack workspace tiers: - Free/Pro/Business: keyword search only - Business+/Enterprise with Slack AI: semantic search available Supports filtering by channel type, date range, and content type. Use `content_types` to search messages, files, channels, or users in a single call. Enable `include_context_messages` for surrounding conversation context. If you get a missing_scope error, the user needs to reconnect their Slack account."
6272 + "description": "Search Slack messages, files, channels, and users via Real-time Search API. For queries referencing entities by name (users/channels/files), first resolve with content_types (users/channels/files) to get exact ID. If multiple matches, ask user to clarify before proceeding (e.g. ask for user email)."
6273 },
6274 {
6275 "slug": "SLACK_ASSISTANT_SEARCH_INFO",
@@ -6363,8 +6428,8 @@
6428 },
6429 {
6430 "slug": "SLACK_FIND_USER_BY_EMAIL_ADDRESS",
6366 - "name": "Lookup users by email (Deprecated)",
6367 - "description": "DEPRECATED: Use FindUsers instead. Retrieves the Slack user object for an active user by their registered email address; requires the users:read.email OAuth scope. Fails with 'users_not_found' if the email is unregistered, the user is inactive, the account is a guest, or the email is hidden by workspace privacy settings."
6431 + "name": "Lookup users by email",
6432 + "description": "Retrieves the Slack user object for an active user by their registered email address; requires the users:read.email OAuth scope. Fails with 'users_not_found' if the email is unregistered, the user is inactive, the account is a guest, or the email is hidden by workspace privacy settings."
6433 },
6434 {
6435 "slug": "SLACK_FIND_USERS",
@@ -6913,25 +6978,40 @@
6978 "name": "New Channel Created Trigger",
6979 "description": "Triggered when a new channel is created in Slack."
6980 },
6981 + {
6982 + "slug": "SLACK_CHANNEL_MESSAGE_RECEIVED",
6983 + "name": "Channel Message Received",
6984 + "description": "Triggered when a message is posted in a Slack channel\n (public, private, or multi-party IM). Does NOT match direct messages."
6985 + },
6986 + {
6987 + "slug": "SLACK_DIRECT_MESSAGE_RECEIVED",
6988 + "name": "Direct Message Received",
6989 + "description": "Triggered when a new direct message (DM) is sent to a user in Slack.\n Catches all DMs across all DM channels."
6990 + },
6991 + {
6992 + "slug": "SLACK_MESSAGE_REACTION_ADDED",
6993 + "name": "Message Reaction Added",
6994 + "description": "Triggered when a reaction is added to a message in Slack.\n Supports optional filtering by channel and emoji name."
6995 + },
6996 {
6997 "slug": "SLACK_REACTION_ADDED",
6998 "name": "Reaction Added Trigger",
6919 - "description": "Triggered when a reaction is added to a message in Slack."
6999 + "description": "DEPRECATED: use `SLACK_MESSAGE_REACTION_ADDED` instead.\n\n Triggered when a reaction is added to a message in Slack."
7000 },
7001 {
7002 "slug": "SLACK_REACTION_REMOVED",
7003 "name": "Reaction Removed Trigger",
6924 - "description": "Triggered when a reaction is removed from a message."
7004 + "description": "DEPRECATED.\n\n Triggered when a reaction is removed from a message."
7005 },
7006 {
7007 "slug": "SLACK_RECEIVE_BOT_MESSAGE",
7008 "name": "New Bot Message Received Trigger",
6929 - "description": "Triggered when a new bot message is posted to a Slack channel."
7009 + "description": "DEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` with\n `is_bot_message=true` instead.\n\n Triggered when a new bot message is posted to a Slack channel."
7010 },
7011 {
7012 "slug": "SLACK_RECEIVE_MESSAGE",
7013 "name": "New Message Received Trigger",
6934 - "description": "Triggered when a new message is posted to a Slack channel."
7014 + "description": "DEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` instead.\n\n Triggered when a new message is posted to a Slack channel."
7015 }
7016 ],
7017 "authConfigDetails": [
@@ -6973,7 +7053,7 @@
7053 "type": "string",
7054 "description": "Scopes to request from the user, comma separated",
7055 "required": false,
6976 - "default": "calls:read,calls:write,channels:history,channels:read,channels:write,chat:write,dnd:read,dnd:write,emoji:read,files:read,files:write,groups:history,groups:read,groups:write,im:history,im:read,im:write,links:read,links:write,mpim:history,mpim:read,mpim:write,pins:read,pins:write,reactions:read,reactions:write,reminders:read,reminders:write,remote_files:read,remote_files:share,search:read,search:read.files,search:read.im,search:read.mpim,search:read.private,search:read.public,search:read.users,stars:read,stars:write,team:read,usergroups:read,usergroups:write,users.profile:read,users.profile:write,users:read,users:read.email,users:write"
7056 + "default": "calls:read,calls:write,channels:history,channels:read,channels:write,chat:write,dnd:read,dnd:write,emoji:read,files:read,files:write,groups:history,groups:read,groups:write,im:history,im:read,im:write,links:read,links:write,mpim:history,mpim:read,mpim:write,pins:read,pins:write,reactions:read,reactions:write,reminders:read,reminders:write,remote_files:read,remote_files:share,search:read,search:read.files,search:read.im,search:read.mpim,search:read.private,search:read.public,search:read.users,team:read,usergroups:read,usergroups:write,users.profile:read,users.profile:write,users:read,users:read.email,users:write"
7057 },
7058 {
7059 "name": "verification_token",
@@ -7008,7 +7088,7 @@
7088 ],
7089 "toolCount": 121,
7090 "triggerCount": 0,
7011 - "version": "20260414_00",
7091 + "version": "20260429_01",
7092 "tools": [
7093 {
7094 "slug": "SUPABASE_ALPHA_CREATE_API_KEY",
@@ -7723,7 +7803,7 @@
7803 ],
7804 "toolCount": 301,
7805 "triggerCount": 5,
7726 - "version": "20260417_00",
7806 + "version": "20260506_00",
7807 "tools": [
7808 {
7809 "slug": "OUTLOOK_ACCEPT_EVENT",
@@ -9018,7 +9098,7 @@
9098 {
9099 "slug": "OUTLOOK_SEND_EMAIL",
9100 "name": "Send email",
9021 - "description": "Sends an email with subject, body, recipients, and an optional attachment via Microsoft Graph API. Supports comma-separated email addresses in the to_email field for multiple recipients. Attachments require a non-empty file with valid name and mimetype."
9101 + "description": "Sends an email with subject, body, recipients, and optional attachments via Microsoft Graph API. Supports comma-separated email addresses in the to_email field for multiple recipients. Accepts either a single file or a list of files as attachments. Attachments require a non-empty file with valid name and mimetype."
9102 },
9103 {
9104 "slug": "OUTLOOK_SNOOZE_CALENDAR_GROUP_EVENT_REMINDER",
@@ -9357,19 +9437,24 @@
9437 "authSchemes": [
9438 "API_KEY"
9439 ],
9360 - "toolCount": 6,
9440 + "toolCount": 9,
9441 "triggerCount": 0,
9362 - "version": "20260413_01",
9442 + "version": "20260429_00",
9443 "tools": [
9444 {
9445 "slug": "PERPLEXITYAI_CREATE_ASYNC_CHAT_COMPLETION",
9446 "name": "Create Async Chat Completion",
9367 - "description": "Create an async chat completion request. Same as /chat/completions but designed for long-running tasks like sonar-deep-research. Returns immediately with a request_id that can be used to poll for results. Async jobs have a 7-day TTL. Use this action when you need to run resource-intensive queries that take longer than typical synchronous requests. The response includes a request ID that can be used to retrieve results later."
9447 + "description": "Create Async Chat Completion (POST /v1/async/sonar). Submits an asynchronous chat completion request for long-running tasks. Returns immediately with a request ID that can be polled using the Get Async Chat Completion action. Only the 'sonar-deep-research' model is supported for async processing. Async jobs have a 7-day TTL. Deep research generates very long responses (10K-100K+ words) with exhaustive multi-source analysis. Use the idempotency_key to prevent duplicate submissions. Poll with Get Async Chat Completion using the returned request ID to retrieve results when status is COMPLETED."
9448 },
9449 {
9450 "slug": "PERPLEXITYAI_CREATE_CHAT_COMPLETION",
9451 "name": "Create Chat Completion",
9372 - "description": "Perplexity AI Chat Completions endpoint using Sonar models. Provides web-grounded conversational AI responses with optional citations. The model searches the web to provide accurate, up-to-date answers with sources. Supports various models optimized for different use cases: - sonar: Fast, cost-effective for simple queries - sonar-pro: Enhanced quality for complex questions - sonar-reasoning-pro: Advanced reasoning capabilities Features include: - Web search grounding for accurate, current information - Citations showing sources for claims - Streaming responses for real-time interaction - Configurable temperature, top_p, and other generation parameters Note: presence_penalty and frequency_penalty cannot be used simultaneously."
9452 + "description": "Perplexity Sonar Chat Completions (POST /v1/sonar). Generates web-grounded conversational AI responses with citations. Supports multiple Sonar models optimized for different use cases: - sonar: Fast, cost-effective for simple queries - sonar-pro: Enhanced quality for complex questions - sonar-reasoning-pro: Chain-of-thought reasoning with <think> blocks - sonar-deep-research: Exhaustive multi-source research (generates very long responses, 10K+ words; prefer the async endpoint for this model) Features: web search grounding, citations, images, structured JSON output, search filtering by domain/date/language/recency, and streaming. Important constraints: - search_recency_filter and date filters (search_after_date_filter, search_before_date_filter, etc.) are mutually exclusive. Use one or the other, not both. - Messages with the 'tool' role must alternate with 'assistant' messages. A valid pattern is: system -> user -> assistant -> tool -> user. - The 'stop' parameter is not currently supported by the API."
9453 + },
9454 + {
9455 + "slug": "PERPLEXITYAI_CREATE_CONTEXTUALIZED_EMBEDDINGS",
9456 + "name": "Create Contextualized Embeddings",
9457 + "description": "Create Contextualized Embeddings (POST /v1/contextualizedembeddings). Generates document-aware embeddings where chunks from the same document share context. Unlike standard embeddings, these recognize sequential relationships within documents, improving retrieval quality. Models: pplx-embed-context-v1-0.6b (1024 dims) and pplx-embed-context-v1-4b (2560 dims). Both support Matryoshka dimension reduction and INT8/binary quantization."
9458 },
9459 {
9460 "slug": "PERPLEXITYAI_CREATE_EMBEDDINGS",
@@ -9379,17 +9464,27 @@
9464 {
9465 "slug": "PERPLEXITYAI_EXECUTE_AGENT",
9466 "name": "Execute Agent",
9382 - "description": "Agent API - Orchestrates multi-step agentic workflows with built-in tools (web search, URL fetching), reasoning, and multi-model support. Use this action when you need to run complex queries that benefit from automatic web search, URL fetching, and multi-step reasoning. The agent can automatically decide when to use tools and how to synthesize responses. Supports various models including OpenAI models (e.g., gpt-5.2) and Perplexity's sonar models. Configure tools like web_search to enable automatic information gathering."
9467 + "description": "Create Agent Response (POST /v1/agent). Orchestrates multi-step agentic workflows with built-in tools (web search, URL fetching, function calling), reasoning, and multi-model support. Streaming is not supported by this action. At least one of 'model', 'models', or 'preset' must be provided. Available presets: 'fast-search', 'pro-search', 'deep-research'. The 'deep-research' preset generates very long responses (10K-100K+ words) with exhaustive multi-source analysis. Available models include Perplexity Sonar, OpenAI, Anthropic, Google, xAI, and NVIDIA models at direct provider rates. Use the List Models action to see available model identifiers."
9468 + },
9469 + {
9470 + "slug": "PERPLEXITYAI_GET_ASYNC_CHAT_COMPLETION",
9471 + "name": "Get Async Chat Completion",
9472 + "description": "Get Async Chat Completion (GET /v1/async/sonar/{id}). Retrieves the result of an asynchronous chat completion request by its ID. Use this to poll for the result after creating an async job. The response includes the status and, when completed, the full completion."
9473 + },
9474 + {
9475 + "slug": "PERPLEXITYAI_LIST_ASYNC_CHAT_COMPLETIONS",
9476 + "name": "List Async Chat Completions",
9477 + "description": "List Async Chat Completions (GET /v1/async/sonar). Retrieves a list of all asynchronous chat completion requests for the authenticated user. Use this to see the status of all your pending, completed, and failed async jobs."
9478 },
9479 {
9385 - "slug": "PERPLEXITYAI_PERPLEXITY_AI_SEARCH",
9386 - "name": "PerplexityAISearch",
9387 - "description": "Perplexity Ai Search interfaces with Perplexity AI to perform search queries and return responses from a range of models. This action manages requests to Perplexity AI and processes the resulting completions, which may include text, citations, and images based on selected models and settings. Key features include: Autoprompting to enhance and refine queries, choice of AI models for various content and performance requirements, temperature settings to manage response randomness, Top K and Top P filters to fine-tune response generation. Beta features include citations and images in results, and response streaming for dynamic interaction. Note: The parameters 'presence_penalty' and 'frequency_penalty' are mutually exclusive and cannot be used simultaneously."
9480 + "slug": "PERPLEXITYAI_LIST_MODELS",
9481 + "name": "List Models",
9482 + "description": "List Models (GET /v1/models). Lists models available for the Agent API. Returns model identifiers that can be used with the Agent endpoint. The response follows the OpenAI List Models format for compatibility. This is a public endpoint that does not require authentication."
9483 },
9484 {
9485 "slug": "PERPLEXITYAI_SEARCH",
9486 "name": "Perplexity Search (Raw Results)",
9392 - "description": "Search API (Raw Results, No LLM) - Returns ranked web results directly from Perplexity's index without LLM processing. Faster and cheaper when you don't need a generated answer. Use this action when you need raw web search results without AI-generated summaries. Supports advanced filtering by date, domain, language, and geographic location."
9487 + "description": "Search the Web (POST /search). Returns raw, ranked web search results directly from Perplexity's index without LLM processing. Faster and cheaper than chat completions when you need raw results. Supports filtering by domain, date, language, country, and recency. Max 20 results per request. Important: search_recency_filter and date filters (search_after_date_filter, search_before_date_filter, last_updated_after_filter, last_updated_before_filter) are mutually exclusive. Use one or the other, not both."
9488 }
9489 ],
9490 "triggers": [],
@@ -9430,7 +9525,7 @@
9525 ],
9526 "toolCount": 79,
9527 "triggerCount": 0,
9433 - "version": "20260414_00",
9528 + "version": "20260501_00",
9529 "tools": [
9530 {
9531 "slug": "TWITTER_ADD_LIST_MEMBER",
@@ -9856,7 +9951,7 @@
9951 "name": "generic_id",
9952 "displayName": "Application Bearer Token",
9953 "type": "string",
9859 - "description": "Your Twitter application bearer token for authentication. Needed for TWITTER_FULL_ARCHIVE_SEARCH, TWITTER_CREATE_COMPLIANCE_JOB_REQUEST, TWITTER_RETRIEVE_COMPLIANCE_JOBS, TWITTER_RETRIEVE_COMPLIANCE_JOB_BY_ID actions.",
9954 + "description": "Bearer Token from your X Developer App (same App as the OAuth Client ID/Secret). Required for app-only actions: TWITTER_RECENT_SEARCH, TWITTER_RECENT_SEARCH_COUNTS, TWITTER_FULL_ARCHIVE_SEARCH, TWITTER_FULL_ARCHIVE_SEARCH_COUNTS, TWITTER_POST_LOOKUP_BY_POST_IDS, TWITTER_POST_USAGE, TWITTER_POSTS_LABEL_STREAM, TWITTER_CREATE_COMPLIANCE_JOB_REQUEST, TWITTER_RETRIEVE_COMPLIANCE_JOBS, TWITTER_RETRIEVE_COMPLIANCE_JOB_BY_ID.",
9955 "required": true,
9956 "default": null
9957 }
@@ -9902,7 +9997,7 @@
9997 ],
9998 "toolCount": 89,
9999 "triggerCount": 7,
9905 - "version": "20260417_00",
10000 + "version": "20260506_00",
10001 "tools": [
10002 {
10003 "slug": "GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE",
@@ -9942,7 +10037,7 @@
10037 {
10038 "slug": "GOOGLEDRIVE_CREATE_FILE",
10039 "name": "Create File or Folder",
9945 - "description": "Creates a new file or folder with metadata. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells; content must be added manually in the Google UI afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in `parents` rather than GOOGLEDRIVE_CREATE_FOLDER."
10040 + "description": "Creates a new file or folder in Google Drive. Supports both metadata-only creation (for folders and empty documents) and file upload with content. When file_to_upload is provided, uploads the actual file bytes; otherwise creates an empty file. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells when no content is provided; content must be added manually afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in `parents` rather than GOOGLEDRIVE_CREATE_FOLDER."
10041 },
10042 {
10043 "slug": "GOOGLEDRIVE_CREATE_FILE_FROM_TEXT",
@@ -10359,22 +10454,22 @@
10454 {
10455 "slug": "GOOGLEDRIVE_FILE_CREATED_TRIGGER",
10456 "name": "File Created",
10362 - "description": "Triggers when a new file is created/added in Google Drive.\n This trigger monitors files and fires when new files are detected."
10457 + "description": "Triggers when a new file is created in Google Drive."
10458 },
10459 {
10460 "slug": "GOOGLEDRIVE_FILE_DELETED_OR_TRASHED_TRIGGER",
10461 "name": "File Deleted or Trashed",
10367 - "description": "Triggers when a file is moved to trash or permanently deleted in Google Drive."
10462 + "description": "Triggers when a file is moved to trash or permanently deleted in Drive."
10463 },
10464 {
10465 "slug": "GOOGLEDRIVE_FILE_SHARED_PERMISSIONS_ADDED",
10466 "name": "File Shared (Permissions Added)",
10372 - "description": "Triggers when new sharing permissions are granted to a file or folder in Google Drive.\n\n This trigger monitors the Drive Changes API to detect files that changed and, for those files,\n compares their current permissions against previously seen permissions to identify newly\n added sharing entries."
10467 + "description": "Triggers when new sharing permissions are granted to a file or folder.\n\n Uses Drive's `changes.list` endpoint with inline `permissions` in the\n `fields` mask so each change carries the file's current permission set\n provider-atomically. We diff that against `seen_permission_keys` to\n identify newly added grants. Drive page tokens are the primary cursor;\n if Drive rejects a stored token, the trigger raises `PollingTriggerError`\n without clearing state rather than silently re-baselining and dropping\n events.\n\n Limitation: truly ephemeral permissions (added and revoked between two\n polls without any other file modification in between) are not detected.\n Drive Activity API would catch those but requires an additional OAuth\n scope and a different payload contract."
10468 },
10469 {
10470 "slug": "GOOGLEDRIVE_FILE_UPDATED_TRIGGER",
10471 "name": "File Updated",
10377 - "description": "Triggers when a file's metadata or content changes in Google Drive.\n Emits file ID, modification timestamp, and editor info."
10472 + "description": "Triggers when a file's metadata or content changes in Google Drive."
10473 },
10474 {
10475 "slug": "GOOGLEDRIVE_GOOGLE_DRIVE_CHANGES",
@@ -10384,7 +10479,7 @@
10479 {
10480 "slug": "GOOGLEDRIVE_NEW_FILE_MATCHING_QUERY_TRIGGER",
10481 "name": "New File Matching Query",
10387 - "description": "Triggers when a new Google Drive file matches a provided query."
10482 + "description": "Triggers when a new Google Drive file matches a provided query.\n\n This is the legacy query-centric trigger: it preserves Drive API query\n config such as ``corpora`` / ``driveId`` aliases and emits the historical\n ``file_matching_query`` event type. ``FileCreatedTrigger`` covers the\n broader \"new file\" case and emits ``file_created``."
10483 }
10484 ],
10485 "authConfigDetails": [
@@ -10452,7 +10547,7 @@
10547 ],
10548 "toolCount": 35,
10549 "triggerCount": 10,
10455 - "version": "20260417_00",
10550 + "version": "20260506_00",
10551 "tools": [
10552 {
10553 "slug": "GOOGLEDOCS_COPY_DOCUMENT",
@@ -10748,7 +10843,7 @@
10843 ],
10844 "toolCount": 233,
10845 "triggerCount": 2,
10751 - "version": "20260417_01",
10846 + "version": "20260501_00",
10847 "tools": [
10848 {
10849 "slug": "HUBSPOT_ADD_ASSET_ASSOCIATION",
@@ -12025,7 +12120,7 @@
12120 ],
12121 "toolCount": 33,
12122 "triggerCount": 3,
12028 - "version": "20260417_00",
12123 + "version": "20260430_00",
12124 "tools": [
12125 {
12126 "slug": "LINEAR_CREATE_ATTACHMENT",
@@ -12299,7 +12394,7 @@
12394 ],
12395 "toolCount": 25,
12396 "triggerCount": 6,
12302 - "version": "20260417_00",
12397 + "version": "20260506_00",
12398 "tools": [
12399 {
12400 "slug": "AIRTABLE_CREATE_BASE",
@@ -12544,7 +12639,7 @@
12639 ],
12640 "toolCount": 5,
12641 "triggerCount": 0,
12547 - "version": "20260414_00",
12642 + "version": "20260429_00",
12643 "tools": [
12644 {
12645 "slug": "CODEINTERPRETER_CREATE_SANDBOX",
@@ -12601,7 +12696,7 @@
12696 ],
12697 "toolCount": 48,
12698 "triggerCount": 0,
12604 - "version": "20260413_01",
12699 + "version": "20260422_01",
12700 "tools": [
12701 {
12702 "slug": "SERPAPI_BAIDU_SEARCH",
@@ -12887,7 +12982,7 @@
12982 ],
12983 "toolCount": 97,
12984 "triggerCount": 3,
12890 - "version": "20260417_00",
12985 + "version": "20260429_01",
12986 "tools": [
12987 {
12988 "slug": "JIRA_ADD_ATTACHMENT",
@@ -13551,7 +13646,7 @@
13646 ],
13647 "toolCount": 30,
13648 "triggerCount": 0,
13554 - "version": "20260417_00",
13649 + "version": "20260506_00",
13650 "tools": [
13651 {
13652 "slug": "FIRECRAWL_AGENT_CANCEL",
@@ -13819,7 +13914,7 @@
13914 ],
13915 "toolCount": 50,
13916 "triggerCount": 4,
13822 - "version": "20260417_00",
13917 + "version": "20260429_00",
13918 "tools": [
13919 {
13920 "slug": "YOUTUBE_ADD_VIDEO_TO_PLAYLIST",
@@ -14158,8 +14253,8 @@
14253 "OAUTH2"
14254 ],
14255 "toolCount": 89,
14161 - "triggerCount": 5,
14162 - "version": "20260417_00",
14256 + "triggerCount": 8,
14257 + "version": "20260506_02",
14258 "tools": [
14259 {
14260 "slug": "SLACKBOT_ADD_CALL_PARTICIPANTS",
@@ -14298,8 +14393,8 @@
14393 },
14394 {
14395 "slug": "SLACKBOT_FIND_USER_BY_EMAIL_ADDRESS",
14301 - "name": "Lookup users by email (Deprecated)",
14302 - "description": "DEPRECATED: Use FindUsers instead. Retrieves the Slack user object for an active user by their registered email address; requires the users:read.email OAuth scope. Fails with 'users_not_found' if the email is unregistered, the user is inactive, the account is a guest, or the email is hidden by workspace privacy settings."
14396 + "name": "Lookup users by email",
14397 + "description": "Retrieves the Slack user object for an active user by their registered email address; requires the users:read.email OAuth scope. Fails with 'users_not_found' if the email is unregistered, the user is inactive, the account is a guest, or the email is hidden by workspace privacy settings."
14398 },
14399 {
14400 "slug": "SLACKBOT_FIND_USERS",
@@ -14613,25 +14708,40 @@
14708 "name": "New Channel Created Trigger",
14709 "description": "Triggered when a new channel is created in Slack."
14710 },
14711 + {
14712 + "slug": "SLACKBOT_CHANNEL_MESSAGE_RECEIVED",
14713 + "name": "Channel Message Received",
14714 + "description": "Triggered when a message is posted in a Slack channel\n (public, private, or multi-party IM). Does NOT match direct messages."
14715 + },
14716 + {
14717 + "slug": "SLACKBOT_DIRECT_MESSAGE_RECEIVED",
14718 + "name": "Direct Message Received",
14719 + "description": "Triggered when a new direct message (DM) is sent to a user in Slack.\n Catches all DMs across all DM channels."
14720 + },
14721 + {
14722 + "slug": "SLACKBOT_MESSAGE_REACTION_ADDED",
14723 + "name": "Message Reaction Added",
14724 + "description": "Triggered when a reaction is added to a message in Slack.\n Supports optional filtering by channel and emoji name."
14725 + },
14726 {
14727 "slug": "SLACKBOT_REACTION_ADDED",
14728 "name": "Reaction Added Trigger",
14619 - "description": "Triggered when a reaction is added to a message in Slack."
14729 + "description": "DEPRECATED: use `SLACK_MESSAGE_REACTION_ADDED` instead.\n\n Triggered when a reaction is added to a message in Slack."
14730 },
14731 {
14732 "slug": "SLACKBOT_REACTION_REMOVED",
14733 "name": "Reaction Removed Trigger",
14624 - "description": "Triggered when a reaction is removed from a message."
14734 + "description": "DEPRECATED.\n\n Triggered when a reaction is removed from a message."
14735 },
14736 {
14737 "slug": "SLACKBOT_RECEIVE_BOT_MESSAGE",
14738 "name": "New Bot Message Received Trigger",
14629 - "description": "Triggered when a new bot message is posted to a Slack channel."
14739 + "description": "DEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` with\n `is_bot_message=true` instead.\n\n Triggered when a new bot message is posted to a Slack channel."
14740 },
14741 {
14742 "slug": "SLACKBOT_RECEIVE_MESSAGE",
14743 "name": "New Message Received Trigger",
14634 - "description": "Triggered when a new message is posted to a Slack channel."
14744 + "description": "DEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` instead.\n\n Triggered when a new message is posted to a Slack channel."
14745 }
14746 ],
14747 "authConfigDetails": [
@@ -14673,7 +14783,7 @@
14783 "type": "string",
14784 "description": "Scopes to request from the bot",
14785 "required": false,
14676 - "default": "channels:history,chat:write,chat:write,team:read,channels:read,users:read,reactions:read"
14786 + "default": "channels:history,chat:write,team:read,channels:read,users:read,reactions:read"
14787 },
14788 {
14789 "name": "verification_token",
@@ -14703,9 +14813,9 @@
14813 "OAUTH2",
14814 "API_KEY"
14815 ],
14706 - "toolCount": 560,
14816 + "toolCount": 574,
14817 "triggerCount": 6,
14708 - "version": "20260417_00",
14818 + "version": "20260429_00",
14819 "tools": [
14820 {
14821 "slug": "CANVAS_ABORT_QUIZ_REPORT_GENERATION",
@@ -16932,6 +17042,76 @@
17042 "name": "Mark group discussion topic as unread",
17043 "description": "Marks the initial text of a group discussion topic as unread for the current user. Use when you need to flag a group discussion topic as unread to track it for later review."
17044 },
17045 + {
17046 + "slug": "CANVAS_NEW_QUIZ_ACCOMMODATIONS_SET",
17047 + "name": "Set quiz accommodations",
17048 + "description": "EXPERIMENTAL: Sets quiz-level accommodations (extra time, extra attempts, reduced choices) for one or more students on a New Quiz. Sends a JSON array body; may return a partial success."
17049 + },
17050 + {
17051 + "slug": "CANVAS_NEW_QUIZ_COURSE_ACCOMMODATIONS_SET",
17052 + "name": "Set course quiz accommodations",
17053 + "description": "EXPERIMENTAL: Sets course-level accommodations (extra time, apply-to-in-progress, reduced choices) for one or more students. These accommodations apply to all New Quizzes in the course. Sends a JSON array body."
17054 + },
17055 + {
17056 + "slug": "CANVAS_NEW_QUIZ_CREATE",
17057 + "name": "Create a new quiz",
17058 + "description": "EXPERIMENTAL: Creates a New Quiz in a Canvas course with the specified title, dates, grading type, instructions, and nested quiz settings (attempts, result view, IP filtering, shuffling, time limit, etc.)."
17059 + },
17060 + {
17061 + "slug": "CANVAS_NEW_QUIZ_DELETE",
17062 + "name": "Delete a new quiz",
17063 + "description": "EXPERIMENTAL: Permanently deletes the New Quiz identified by `assignment_id` from the course identified by `course_id`; this action cannot be undone."
17064 + },
17065 + {
17066 + "slug": "CANVAS_NEW_QUIZ_GET",
17067 + "name": "Get a new quiz",
17068 + "description": "EXPERIMENTAL: Retrieves a single New Quiz from a Canvas course by its assignment ID. Use when you need to view settings, dates, instructions, or other metadata for a New Quiz."
17069 + },
17070 + {
17071 + "slug": "CANVAS_NEW_QUIZ_ITEM_CREATE",
17072 + "name": "Create a quiz item",
17073 + "description": "EXPERIMENTAL: Creates a new QuestionItem in a New Quiz. The `entry` object describes the question body, interaction type, scoring, and feedback."
17074 + },
17075 + {
17076 + "slug": "CANVAS_NEW_QUIZ_ITEM_DELETE",
17077 + "name": "Delete a quiz item",
17078 + "description": "EXPERIMENTAL: Permanently deletes a single quiz item (question) from a New Quiz; this action cannot be undone."
17079 + },
17080 + {
17081 + "slug": "CANVAS_NEW_QUIZ_ITEM_GET",
17082 + "name": "Get a quiz item",
17083 + "description": "EXPERIMENTAL: Retrieves a single quiz item (question) from a New Quiz. Use to inspect item body, scoring, and interaction data."
17084 + },
17085 + {
17086 + "slug": "CANVAS_NEW_QUIZ_ITEM_LIST",
17087 + "name": "List quiz items",
17088 + "description": "EXPERIMENTAL: Lists all items (questions) in a New Quiz. Use to enumerate items with their positions, points, and question data."
17089 + },
17090 + {
17091 + "slug": "CANVAS_NEW_QUIZ_ITEM_MEDIA_UPLOAD_URL",
17092 + "name": "Get items media upload URL",
17093 + "description": "EXPERIMENTAL: Retrieves a presigned URL that can be used to upload media (images, audio, etc.) for use in New Quiz items."
17094 + },
17095 + {
17096 + "slug": "CANVAS_NEW_QUIZ_ITEM_UPDATE",
17097 + "name": "Update a quiz item",
17098 + "description": "EXPERIMENTAL: Updates an existing quiz item (question) in a New Quiz. All body fields are optional; only supplied fields are modified."
17099 + },
17100 + {
17101 + "slug": "CANVAS_NEW_QUIZ_LIST",
17102 + "name": "List new quizzes",
17103 + "description": "EXPERIMENTAL: Lists all New Quizzes in a Canvas course. Use to enumerate New Quizzes along with their settings and metadata."
17104 + },
17105 + {
17106 + "slug": "CANVAS_NEW_QUIZ_REPORT_CREATE",
17107 + "name": "Create a new quiz report",
17108 + "description": "EXPERIMENTAL: Creates a report for a New Quiz. Starts an asynchronous job and returns a Progress object the caller can poll. Report type is 'student_analysis' or 'item_analysis'; output format is 'csv' or 'json'."
17109 + },
17110 + {
17111 + "slug": "CANVAS_NEW_QUIZ_UPDATE",
17112 + "name": "Update a new quiz",
17113 + "description": "EXPERIMENTAL: Updates an existing New Quiz in a Canvas course. All body fields are optional; only supplied fields are modified."
17114 + },
17115 {
17116 "slug": "CANVAS_POST_ASSIGNMENT_GRADES_FOR_SECTIONS",
17117 "name": "Post assignment grades for sections",
@@ -17644,7 +17824,7 @@
17824 ],
17825 "toolCount": 107,
17826 "triggerCount": 0,
17647 - "version": "20260417_00",
17827 + "version": "20260429_00",
17828 "tools": [
17829 {
17830 "slug": "BITBUCKET_APPROVE_PULL_REQUEST",
@@ -18248,7 +18428,7 @@
18428 ],
18429 "toolCount": 18,
18430 "triggerCount": 5,
18251 - "version": "20260417_00",
18431 + "version": "20260429_00",
18432 "tools": [
18433 {
18434 "slug": "GOOGLETASKS_BATCH_EXECUTE",
@@ -18431,10 +18611,40 @@
18611 "composioManagedAuthSchemes": [
18612 "OAUTH2"
18613 ],
18434 - "toolCount": 16,
18614 + "toolCount": 28,
18615 "triggerCount": 1,
18436 - "version": "20260410_00",
18616 + "version": "20260429_00",
18617 "tools": [
18618 + {
18619 + "slug": "DISCORD_CONSUME_ENTITLEMENT",
18620 + "name": "Consume Entitlement",
18621 + "description": "Marks a one-time purchase consumable entitlement as consumed for a given application. Only applicable to entitlements backed by one-time purchase consumable SKUs."
18622 + },
18623 + {
18624 + "slug": "DISCORD_DELETE_TEST_ENTITLEMENT",
18625 + "name": "Delete Test Entitlement",
18626 + "description": "Deletes a currently active test entitlement for a given application. Use this to clean up test entitlements that are no longer needed."
18627 + },
18628 + {
18629 + "slug": "DISCORD_DELETE_USER_APPLICATION_ROLE_CONNECTION",
18630 + "name": "Delete User Application Role Connection",
18631 + "description": "Deletes the current user's application role connection for the specified application. Removes the platform metadata and linked role connection."
18632 + },
18633 + {
18634 + "slug": "DISCORD_EDIT_APPLICATION_COMMAND_PERMISSIONS",
18635 + "name": "Edit Application Command Permissions",
18636 + "description": "Edits the permissions for a specific application command in a guild. Requires OAuth2 Bearer token (bot tokens will error). The authorizing user must have MANAGE_GUILD and MANAGE_ROLES permissions in the target guild."
18637 + },
18638 + {
18639 + "slug": "DISCORD_GET_APPLICATION_COMMAND_PERMISSIONS",
18640 + "name": "Get Application Command Permissions",
18641 + "description": "Retrieves the permissions for a specific application command in a guild. Requires OAuth2 Bearer token (bot tokens will error). The authorizing user must have MANAGE_GUILD and MANAGE_ROLES permissions in the target guild."
18642 + },
18643 + {
18644 + "slug": "DISCORD_GET_BATCH_APPLICATION_COMMAND_PERMISSIONS",
18645 + "name": "Get Batch Application Command Permissions",
18646 + "description": "Retrieves permissions for all commands of an application in a guild. Returns a list of permission objects for each command. Requires OAuth2 Bearer token (Bot tokens will error)."
18647 + },
18648 {
18649 "slug": "DISCORD_GET_CURRENT_USER_APPLICATION_ENTITLEMENTS",
18650 "name": "Get Current User Application Entitlements",
@@ -18468,7 +18678,7 @@
18678 {
18679 "slug": "DISCORD_GET_MY_GUILD_MEMBER",
18680 "name": "Get my guild member",
18471 - "description": "Retrieves the guild member object for the currently authenticated user within a specified guild, provided they are a member of that guild."
18681 + "description": "Retrieves the guild member object for the currently authenticated user within a specified guild, including roles, nickname, join date, and permissions."
18682 },
18683 {
18684 "slug": "DISCORD_GET_MY_OAUTH2_AUTHORIZATION",
@@ -18477,7 +18687,7 @@
18687 },
18688 {
18689 "slug": "DISCORD_GET_MY_USER",
18480 - "name": "Get my user",
18690 + "name": "Get My User",
18691 "description": "Fetches comprehensive profile information for the currently authenticated Discord user, including email if the 'email' scope is granted."
18692 },
18693 {
@@ -18490,30 +18700,60 @@
18700 "name": "Get Public Keys",
18701 "description": "Tool to retrieve Discord OAuth2 public keys. Use when you need to verify OAuth2 tokens or access public keys for cryptographic operations."
18702 },
18703 + {
18704 + "slug": "DISCORD_GET_SKU_SUBSCRIPTION",
18705 + "name": "Get SKU Subscription",
18706 + "description": "Retrieves a specific subscription by ID for a given SKU. Use to check details of a single user subscription."
18707 + },
18708 {
18709 "slug": "DISCORD_GET_USER",
18710 "name": "Get User",
18711 "description": "Retrieve information about a Discord user. With OAuth Bearer token authentication, this returns the authenticated user's information (use '@me'). With Bot token authentication, you can query any user by their ID. Use this when you need user details like username, avatar, email (if email scope is granted), locale, premium status, or other profile information."
18712 },
18713 + {
18714 + "slug": "DISCORD_GET_USER_APPLICATION_ROLE_CONNECTION",
18715 + "name": "Get User Application Role Connection",
18716 + "description": "Retrieves the application role connection for the currently authenticated user for a specified application. Requires the role_connections.write OAuth2 scope."
18717 + },
18718 {
18719 "slug": "DISCORD_INVITE_RESOLVE",
18720 "name": "Resolve Invite",
18721 "description": "Tool to resolve and retrieve information about a Discord invite code. Use when you need to get details about a guild, channel, or event associated with an invite code."
18722 },
18723 + {
18724 + "slug": "DISCORD_LEAVE_GUILD",
18725 + "name": "Leave Guild",
18726 + "description": "Leaves a Discord guild (server) on behalf of the currently authenticated user."
18727 + },
18728 {
18729 "slug": "DISCORD_LIST_MY_CONNECTIONS",
18505 - "name": "Retrieve user connections",
18730 + "name": "List My Connections",
18731 "description": "Retrieves a list of the authenticated user's connected third-party accounts on Discord."
18732 },
18733 {
18734 "slug": "DISCORD_LIST_MY_GUILDS",
18510 - "name": "List my guilds",
18735 + "name": "List My Guilds",
18736 "description": "Lists the current user's guilds, returning partial data for each; primarily used for displaying server lists or verifying memberships."
18737 },
18738 + {
18739 + "slug": "DISCORD_LIST_SKU_SUBSCRIPTIONS",
18740 + "name": "List SKU Subscriptions",
18741 + "description": "Lists all subscriptions for a given SKU. When using a Bot token, the user_id query parameter is required. Returns paginated subscription objects."
18742 + },
18743 {
18744 "slug": "DISCORD_LIST_STICKER_PACKS",
18745 "name": "List Sticker Packs",
18746 "description": "Tool to retrieve all available Discord Nitro sticker packs. Use when you need to list or browse official Discord sticker packs."
18747 + },
18748 + {
18749 + "slug": "DISCORD_MODIFY_CURRENT_USER",
18750 + "name": "Modify Current User",
18751 + "description": "Modifies the currently authenticated Discord user's profile. Can update username (limited to 2 changes per hour) and avatar."
18752 + },
18753 + {
18754 + "slug": "DISCORD_UPDATE_USER_APPLICATION_ROLE_CONNECTION",
18755 + "name": "Update User Application Role Connection",
18756 + "description": "Updates the application role connection for the currently authenticated user for a specified application. Requires the role_connections.write OAuth2 scope."
18757 }
18758 ],
18759 "triggers": [
@@ -18589,7 +18829,7 @@
18829 ],
18830 "toolCount": 53,
18831 "triggerCount": 0,
18592 - "version": "20260415_00",
18832 + "version": "20260506_01",
18833 "tools": [
18834 {
18835 "slug": "FIGMA_ADD_A_COMMENT_TO_A_FILE",
@@ -18959,7 +19199,7 @@
19199 ],
19200 "toolCount": 23,
19201 "triggerCount": 0,
18962 - "version": "20260413_00",
19202 + "version": "20260424_00",
19203 "tools": [
19204 {
19205 "slug": "COMPOSIO_SEARCH_AMAZON",
@@ -19109,7 +19349,7 @@
19349 ],
19350 "toolCount": 23,
19351 "triggerCount": 0,
19112 - "version": "20260414_00",
19352 + "version": "20260424_00",
19353 "tools": [
19354 {
19355 "slug": "REDDIT_CREATE_REDDIT_POST",
@@ -19294,7 +19534,7 @@
19534 ],
19535 "toolCount": 175,
19536 "triggerCount": 0,
19297 - "version": "20260414_00",
19537 + "version": "20260506_00",
19538 "tools": [
19539 {
19540 "slug": "CAL_ADD_ATTENDEE",
@@ -19819,7 +20059,7 @@
20059 {
20060 "slug": "CAL_LIST_BOOKING_REFERENCES",
20061 "name": "List booking references",
19822 - "description": "Tool to find all booking references in Cal.com. Use when you need to retrieve a list of all booking references that link bookings to external platforms or calendars."
20062 + "description": "Fetches one page of booking references in Cal.com. The Cal.com v2 API does not expose `/booking-references` for Bearer-token auth, so this action paginates the v2 `/bookings` endpoint and extracts each booking's `references` array. ONE Cal.com API call is made per invocation; pagination is caller-driven via the `cursor` parameter (Cal's keyset-by-booking-ID cursor) and the `next_cursor` field in the response."
20063 },
20064 {
20065 "slug": "CAL_LIST_EVENT_TYPES",
@@ -20278,7 +20518,7 @@
20518 ],
20519 "toolCount": 144,
20520 "triggerCount": 0,
20281 - "version": "20260417_00",
20521 + "version": "20260429_00",
20522 "tools": [
20523 {
20524 "slug": "WRIKE_BULK_MODIFY_GROUPS",
@@ -21072,7 +21312,7 @@
21312 ],
21313 "toolCount": 18,
21314 "triggerCount": 0,
21075 - "version": "20260414_00",
21315 + "version": "20260506_00",
21316 "tools": [
21317 {
21318 "slug": "EXA_ANSWER",
@@ -21206,7 +21446,7 @@
21446 ],
21447 "toolCount": 207,
21448 "triggerCount": 0,
21209 - "version": "20260417_00",
21449 + "version": "20260429_00",
21450 "tools": [
21451 {
21452 "slug": "SENTRY_ACCESS_PROJECT_INFORMATION",
@@ -22307,7 +22547,7 @@
22547 ],
22548 "toolCount": 15,
22549 "triggerCount": 0,
22310 - "version": "20260413_00",
22550 + "version": "20260429_00",
22551 "tools": [
22552 {
22553 "slug": "SNOWFLAKE_CANCEL_STATEMENT_EXECUTION",
@@ -22559,7 +22799,7 @@
22799 ],
22800 "toolCount": 155,
22801 "triggerCount": 0,
22562 - "version": "20260414_00",
22802 + "version": "20260506_00",
22803 "tools": [
22804 {
22805 "slug": "ELEVENLABS_ADD_A_PRONUNCIATION_DICTIONARY",
@@ -23377,9 +23617,9 @@
23617 "composioManagedAuthSchemes": [
23618 "OAUTH2"
23619 ],
23380 - "toolCount": 164,
23620 + "toolCount": 163,
23621 "triggerCount": 0,
23382 - "version": "20260417_00",
23622 + "version": "20260504_00",
23623 "tools": [
23624 {
23625 "slug": "MICROSOFT_TEAMS_ADD_CHAT_MEMBER",
@@ -23676,11 +23916,6 @@
23916 "name": "Get group team channel (Deprecated)",
23917 "description": "DEPRECATED: Use MICROSOFT_TEAMS_GET_CHANNEL instead. Tool to get a specific channel from a group's team. Use when you have a group ID and channel ID to fetch channel details."
23918 },
23679 - {
23680 - "slug": "MICROSOFT_TEAMS_GET_GROUP_TEAM_OPERATION",
23681 - "name": "Get Group Team Operation Status",
23682 - "description": "Tool to retrieve the status of a Teams async operation using groupId and operationId. Use when you need to poll and track the progress of long-running operations like team creation or archiving for a Microsoft 365 group."
23683 - },
23919 {
23920 "slug": "MICROSOFT_TEAMS_GET_MY_PROFILE",
23921 "name": "Get User Profile",
@@ -23814,7 +24049,7 @@
24049 {
24050 "slug": "MICROSOFT_TEAMS_LIST_CHAT_MEMBERS",
24051 "name": "List chat members (Deprecated)",
23817 - "description": "DEPRECATED: Use MICROSOFT_TEAMS_MICROSOFT_TEAMS_USERS_CHATS_LIST_MEMBERS instead. Tool to list members of a Microsoft Teams chat. Use when you need to retrieve the members of a specific one-on-one chat, group chat, or meeting chat."
24052 + "description": "DEPRECATED: Use MICROSOFT_TEAMS_USERS_CHATS_LIST_MEMBERS instead. Tool to list members of a Microsoft Teams chat. Use when you need to retrieve the members of a specific one-on-one chat, group chat, or meeting chat."
24053 },
24054 {
24055 "slug": "MICROSOFT_TEAMS_LIST_COMMUNICATIONS_CALLS_OPERATIONS",
@@ -23859,7 +24094,7 @@
24094 {
24095 "slug": "MICROSOFT_TEAMS_LIST_ONLINE_MEETINGS",
24096 "name": "List user online meetings",
23862 - "description": "Tool to list online meetings for a specific user in Microsoft Teams. Use when you need to retrieve meetings for a user. NOTE: With delegated permissions, a filter parameter is typically required (e.g., by JoinWebUrl or joinMeetingId)."
24097 + "description": "Look up a Microsoft Teams online meeting for a user by identifier. This is effectively a 'lookup-by-identifier' endpoint, NOT a general-purpose list or search. Microsoft Graph REQUIRES an OData $filter predicate on /me/onlineMeetings and /users/{user_id}/onlineMeetings; without it the API returns HTTP 400 'Filter expression expected'. The only supported filter properties on this endpoint are JoinWebUrl and joinMeetingIdSettings/joinMeetingId (e.g. \"JoinWebUrl eq 'https://teams.microsoft.com/l/meetup-join/...'\" or \"joinMeetingIdSettings/joinMeetingId eq '1234567890'\"). subject and VideoTeleconferenceId are NOT supported here. If you already know the meeting id, prefer MICROSOFT_TEAMS_USERS_GET_ONLINE_MEETING. There is no Graph API for free-text searching a user's meetings by title."
24098 },
24099 {
24100 "slug": "MICROSOFT_TEAMS_LIST_OPEN_SHIFT_CHANGE_REQUESTS",
@@ -24306,8 +24541,8 @@
24541 "OAUTH2"
24542 ],
24543 "toolCount": 153,
24309 - "triggerCount": 1,
24310 - "version": "20260414_00",
24544 + "triggerCount": 6,
24545 + "version": "20260506_00",
24546 "tools": [
24547 {
24548 "slug": "ASANA_ADD_FOLLOWERS_TO_PROJECT",
@@ -25077,9 +25312,34 @@
25312 ],
25313 "triggers": [
25314 {
25080 - "slug": "ASANA_TASK_TRIGGER",
25081 - "name": "Task Trigger",
25082 - "description": "Task Trigger"
25315 + "slug": "ASANA_TASK_ATTACHMENT_ADDED",
25316 + "name": "Attachment Added to Task",
25317 + "description": "Triggers when an attachment is added to a task."
25318 + },
25319 + {
25320 + "slug": "ASANA_TASK_COMMENT_ADDED",
25321 + "name": "New Comment on Task",
25322 + "description": "Triggers when a comment is added to a task in a project."
25323 + },
25324 + {
25325 + "slug": "ASANA_TASK_CREATED",
25326 + "name": "New Task Created",
25327 + "description": "Triggers when a new task is created in a project."
25328 + },
25329 + {
25330 + "slug": "ASANA_TASK_MOVED_TO_SECTION",
25331 + "name": "Task Moved to Section",
25332 + "description": "Triggers when a task is moved to a section in a project."
25333 + },
25334 + {
25335 + "slug": "ASANA_TASK_TAG_ADDED",
25336 + "name": "Tag Added to Task",
25337 + "description": "Triggers when a tag is added to a task.\n\n Note: Asana's event structure is inverted for tag events — the resource\n is the task and the parent is the tag. So parent.gid gives the tag GID."
25338 + },
25339 + {
25340 + "slug": "ASANA_TASK_UPDATED",
25341 + "name": "Task Updated",
25342 + "description": "Triggers when a task is updated in a project."
25343 }
25344 ],
25345 "authConfigDetails": [
@@ -25144,7 +25404,7 @@
25404 ],
25405 "toolCount": 24,
25406 "triggerCount": 0,
25147 - "version": "20260413_00",
25407 + "version": "20260422_01",
25408 "tools": [
25409 {
25410 "slug": "PEOPLEDATALABS_CLEAN_COMPANY_DATA",
@@ -25302,11 +25562,12 @@
25562 "category": "ecommerce",
25563 "authSchemes": [
25564 "API_KEY",
25305 - "OAUTH2"
25565 + "OAUTH2",
25566 + "S2S_OAUTH2"
25567 ],
25568 "toolCount": 394,
25569 "triggerCount": 0,
25309 - "version": "20260414_00",
25570 + "version": "20260506_00",
25571 "tools": [
25572 {
25573 "slug": "SHOPIFY_ACTIVATE_ONE_TIME_CHARGE",
@@ -27368,6 +27629,46 @@
27629 "optional": []
27630 }
27631 }
27632 + },
27633 + {
27634 + "mode": "S2S_OAUTH2",
27635 + "name": "shopify_s2s_oauth2",
27636 + "fields": {
27637 + "auth_config_creation": {
27638 + "required": [
27639 + {
27640 + "name": "client_id",
27641 + "displayName": "Client ID",
27642 + "type": "string",
27643 + "description": "The Client ID from your Shopify Dev Dashboard app. Find it under your app's Configuration / Client credentials section in the Dev Dashboard. Required for the OAuth client_credentials grant introduced for new Shopify apps after the 2026-01-01 admin token deprecation. Note: scopes are NOT requested at token-exchange time for Shopify — configure required scopes (e.g. read_products, write_products, read_orders, write_orders) in your Dev Dashboard app's Configuration or shopify.app.toml before installing the app on the store.",
27644 + "required": true,
27645 + "default": null
27646 + },
27647 + {
27648 + "name": "client_secret",
27649 + "displayName": "Client Secret",
27650 + "type": "string",
27651 + "description": "The Client Secret from your Shopify Dev Dashboard app, listed alongside the Client ID. Treat as confidential. Used to obtain a short-lived (24h) access token via the client_credentials grant.",
27652 + "required": true,
27653 + "default": null
27654 + }
27655 + ],
27656 + "optional": []
27657 + },
27658 + "connected_account_initiation": {
27659 + "required": [
27660 + {
27661 + "name": "subdomain",
27662 + "displayName": "Store Subdomain",
27663 + "type": "string",
27664 + "description": "Your Shopify store's subdomain (e.g., your-store-name in your-store-name.myshopify.com)",
27665 + "required": true,
27666 + "default": null
27667 + }
27668 + ],
27669 + "optional": []
27670 + }
27671 + }
27672 }
27673 ]
27674 },
@@ -27385,7 +27686,7 @@
27686 ],
27687 "toolCount": 22,
27688 "triggerCount": 0,
27388 - "version": "20260415_00",
27689 + "version": "20260424_00",
27690 "tools": [
27691 {
27692 "slug": "LINKEDIN_CREATE_ARTICLE_OR_URL_SHARE",
@@ -27565,7 +27866,7 @@
27866 ],
27867 "toolCount": 22,
27868 "triggerCount": 0,
27568 - "version": "20260414_00",
27869 + "version": "20260506_00",
27870 "tools": [
27871 {
27872 "slug": "GOOGLE_MAPS_AUTOCOMPLETE",
@@ -27768,7 +28069,7 @@
28069 ],
28070 "toolCount": 60,
28071 "triggerCount": 9,
27771 - "version": "20260417_00",
28072 + "version": "20260429_01",
28073 "tools": [
28074 {
28075 "slug": "ONE_DRIVE_CHECKIN_ITEM",
@@ -28219,7 +28520,7 @@
28520 ],
28521 "toolCount": 338,
28522 "triggerCount": 0,
28222 - "version": "20260414_00",
28523 + "version": "20260506_00",
28524 "tools": [
28525 {
28526 "slug": "DOCUSIGN_ADD_CONTACTS_TO_CONTACTS_LIST",
@@ -29986,222 +30287,222 @@
30287 ],
30288 "toolCount": 165,
30289 "triggerCount": 0,
29989 - "version": "20260414_00",
30290 + "version": "20260429_01",
30291 "tools": [
30292 {
30293 "slug": "DISCORDBOT_ADD_GROUP_DM_USER",
30294 "name": "Add recipient to group channel",
29994 - "description": "Adds a user to a Discord group Direct Message (DM) channel. IMPORTANT: This action requires a user OAuth2 access token with the 'gdm.join' scope in the access_token parameter. Bot tokens cannot be used for this endpoint as bots cannot join or manage group DMs per Discord's API limitations. The user being added must also have authorized your application with the gdm.join scope. Note: This endpoint was designed for the deprecated GameBridge SDK and may have limited functionality."
30295 + "description": "Adds a user to a Discord group DM channel. Requires a user OAuth2 access token with the gdm.join scope. Bot tokens cannot be used for this endpoint."
30296 },
30297 {
30298 "slug": "DISCORDBOT_ADD_GUILD_MEMBER",
30299 "name": "Add guild member",
29999 - "description": "Adds a user (who is not already a member) to a guild using their `access_token` (which must have `guilds.join` scope), optionally setting nickname, roles, mute/deaf status, or flags."
30300 + "description": "Adds a user to a Discord guild using their OAuth2 access token (which must have guilds.join scope). Returns the guild member object on 201 Created, or indicates the user is already a member on 204."
30301 },
30302 {
30303 "slug": "DISCORDBOT_ADD_GUILD_MEMBER_ROLE",
30304 "name": "Assign role to guild member",
30004 - "description": "Assigns a role to a guild member, provided the bot has 'Manage Roles' permission in the guild and the role to be assigned is hierarchically lower than the bot's highest role."
30305 + "description": "Assigns a role to a guild member. Requires MANAGE_ROLES permission and the role must be lower in hierarchy than the bot's highest role. Returns 204 on success."
30306 },
30307 {
30308 "slug": "DISCORDBOT_ADD_MY_MESSAGE_REACTION",
30008 - "name": "Add reaction to message",
30009 - "description": "Adds an emoji reaction (Unicode or custom) from the authenticated bot to a specific message in a Discord channel. Returns 204 No Content on success. Requires READ_MESSAGE_HISTORY permission, and ADD_REACTIONS permission if no one else has reacted with this emoji yet. Supports both Unicode emojis (e.g., 👍) and custom server emojis using 'name:id' format."
30309 + "name": "Add Reaction To Message",
30310 + "description": "Adds an emoji reaction from the bot to a message. Requires READ_MESSAGE_HISTORY, and ADD_REACTIONS if no one else has reacted with this emoji yet."
30311 },
30312 {
30313 "slug": "DISCORDBOT_ADD_THREAD_MEMBER",
30314 "name": "Add thread member",
30014 - "description": "Adds a user to a specific, unarchived thread; the user must have access to the thread's parent channel, and for private threads, the bot must already be a member."
30315 + "description": "Adds a user to a specific, unarchived thread. The user must have access to the parent channel."
30316 },
30317 {
30318 "slug": "DISCORDBOT_BAN_USER_FROM_GUILD",
30319 "name": "Ban user from guild",
30019 - "description": "Permanently bans a user from a Discord guild, optionally deleting their recent messages (specify deletion period in seconds OR days, not both)."
30320 + "description": "Permanently bans a user from a Discord guild, optionally deleting their recent messages."
30321 },
30322 {
30323 "slug": "DISCORDBOT_BULK_BAN_USERS_FROM_GUILD",
30023 - "name": "Bulk ban users in guild with message deletion option",
30024 - "description": "Bans up to 200 users from a Discord guild, optionally deleting their recent messages; the bot must have 'Ban Members' permission in the guild, and this action is irreversible."
30324 + "name": "Bulk ban users from guild",
30325 + "description": "Bans up to 200 users from a Discord guild, optionally deleting their recent messages. Requires BAN_MEMBERS permission."
30326 },
30327 {
30328 "slug": "DISCORDBOT_BULK_DELETE_MESSAGES",
30028 - "name": "Bulk delete messages in channel",
30029 - "description": "Atomically bulk deletes messages in a Discord channel for moderation or maintenance; deletion may not be instantaneous and messages are unrecoverable."
30329 + "name": "Bulk Delete Messages",
30330 + "description": "Bulk deletes messages in a Discord channel. Requires MANAGE_MESSAGES permission. Messages must be less than 14 days old. Between 2 and 100 messages can be deleted at once."
30331 },
30332 {
30333 "slug": "DISCORDBOT_CREATE_APPLICATION_COMMAND",
30033 - "name": "Create application command objects",
30034 - "description": "Creates a new global Discord application command, accessible across guilds and in DMs (if `dm_permission` is true), noting global commands can take up to an hour to propagate and have registration limits; for guild-specific commands, use a different action."
30334 + "name": "Create global application command",
30335 + "description": "Creates a new global Discord application command. Global commands can take up to an hour to propagate. Command names must be unique per type within the application scope."
30336 },
30337 {
30338 "slug": "DISCORDBOT_CREATE_AUTO_MODERATION_RULE",
30038 - "name": "Create guild auto moderation rule",
30039 - "description": "Creates a new auto moderation rule for a Discord guild to automatically moderate content. Requires 'MANAGE_GUILD' permission. Use this to set up filters for profanity, spam, excessive mentions, or custom keywords. Each rule has a trigger type (what to look for), trigger metadata (specific configuration), and actions (what to do when triggered)."
30339 + "name": "Create auto moderation rule",
30340 + "description": "Creates a new auto moderation rule for a Discord guild. Requires MANAGE_GUILD permission. Use this to set up filters for profanity, spam, excessive mentions, or custom keywords."
30341 },
30342 {
30343 "slug": "DISCORDBOT_CREATE_CHANNEL_INVITE",
30043 - "name": "Create Channel Invite",
30044 - "description": "Creates a new invite link for the specified Discord channel. The bot must have 'CREATE_INSTANT_INVITE' permission for that channel. Optionally configure the invite's expiration time, usage limit, and other properties. Returns the invite code and details including a shareable invite URL (format: https://discord.gg/{code})."
30344 + "name": "Create channel invite",
30345 + "description": "Creates a new invite link for a Discord channel. Requires CREATE_INSTANT_INVITE permission."
30346 },
30347 {
30348 "slug": "DISCORDBOT_CREATE_DM",
30349 "name": "Initiate user channel with recipient",
30049 - "description": "Creates a new direct message (DM) channel or retrieves an existing one, using `recipient_id` for a 1-on-1 DM or `access_tokens` for a group DM; this action only establishes or fetches the channel and does not send messages."
30350 + "description": "Creates a new direct message (DM) channel or retrieves an existing one, using recipient_id for a 1-on-1 DM or access_tokens for a group DM; this action only establishes or fetches the channel and does not send messages."
30351 },
30352 {
30353 "slug": "DISCORDBOT_CREATE_GUILD",
30053 - "name": "Create new guild object",
30054 - "description": "Creates a new Discord guild (server) with the specified name, roles, and channels; icon must be a base64 encoded 128x128 image, and if `afk_channel_id` is set, `afk_timeout` must also be set."
30354 + "name": "Create new guild",
30355 + "description": "Creates a new Discord guild (server). The bot must be in fewer than 10 guilds to use this endpoint. Icon must be a base64 encoded 128x128 image, and if afk_channel_id is set, afk_timeout must also be set."
30356 },
30357 {
30358 "slug": "DISCORDBOT_CREATE_GUILD_APPLICATION_COMMAND",
30359 "name": "Create guild application command",
30059 - "description": "Creates a new guild-specific application command (slash, user, or message) in Discord; command name must be unique per type within the guild (max 100 total commands), and client UI updates may take up to an hour."
30360 + "description": "Creates a new guild-specific application command. Command names must be unique per type within the guild (max 100 total commands)."
30361 },
30362 {
30363 "slug": "DISCORDBOT_CREATE_GUILD_CHANNEL",
30364 "name": "Create guild channel",
30064 - "description": "Creates a new Discord channel (text, voice, category, etc.) within a guild, with options for permissions, topic, and type-specific settings."
30365 + "description": "Creates a new Discord channel (text, voice, category, etc.) within a guild. Requires MANAGE_CHANNELS permission."
30366 },
30367 {
30368 "slug": "DISCORDBOT_CREATE_GUILD_EMOJI",
30369 "name": "Create guild emoji",
30069 - "description": "Creates a new custom emoji in a specified Discord guild, requiring `CREATE_EXPRESSIONS` permission and adherence to guild emoji limits."
30370 + "description": "Creates a new custom emoji in a specified Discord guild, requiring CREATE_EXPRESSIONS permission and adherence to guild emoji limits."
30371 },
30372 {
30373 "slug": "DISCORDBOT_CREATE_GUILD_FROM_TEMPLATE",
30073 - "name": "Post guild template by code",
30074 - "description": "Creates a new Discord guild by applying channels, roles, and settings from a specified, valid, and accessible guild template code."
30374 + "name": "Create guild from template",
30375 + "description": "Creates a new Discord guild by applying channels, roles, and settings from a specified guild template code."
30376 },
30377 {
30378 "slug": "DISCORDBOT_CREATE_GUILD_ROLE",
30379 "name": "Create role with guild id",
30079 - "description": "Creates a new role in a Discord guild with customizable name, permissions, color, hoist, mentionability, and icon; `icon` (custom image hash) and `unicode_emoji` (standard emoji) are mutually exclusive."
30380 + "description": "Creates a new role in a Discord guild with customizable name, permissions, color, hoist, mentionability, and icon. Requires MANAGE_ROLES permission. The icon and unicode_emoji fields are mutually exclusive."
30381 },
30382 {
30383 "slug": "DISCORDBOT_CREATE_GUILD_SCHEDULED_EVENT",
30384 "name": "Create guild scheduled event",
30084 - "description": "Creates a new scheduled event in a Discord guild. Events can be hosted in stage channels, voice channels, or external locations. Required fields vary by entity_type: STAGE_INSTANCE/VOICE require channel_id, while EXTERNAL requires entity_metadata with a location and scheduled_end_time."
30385 + "description": "Creates a new scheduled event in a Discord guild. Events can be hosted in stage channels, voice channels, or external locations. STAGE_INSTANCE/VOICE require channel_id, while EXTERNAL requires entity_metadata with a location and scheduled_end_time."
30386 },
30387 {
30388 "slug": "DISCORDBOT_CREATE_GUILD_STICKER",
30389 "name": "Create guild sticker",
30089 - "description": "Uploads a PNG, APNG, or Lottie JSON file (max 512KB) as a new custom sticker to the specified Discord guild; requires 'Manage Expressions' permissions and sufficient server boost level for sticker slots."
30390 + "description": "Uploads a PNG, APNG, GIF, or Lottie JSON file (max 512KB) as a new custom sticker to the specified Discord guild; requires Manage Expressions permission."
30391 },
30392 {
30393 "slug": "DISCORDBOT_CREATE_GUILD_TEMPLATE",
30394 "name": "Create guild template",
30094 - "description": "Creates a template of an existing Discord guild's structure (settings, roles, channels) but not its content (e.g., messages, members)."
30395 + "description": "Creates a template of an existing Discord guild's structure (settings, roles, channels) but not its content (messages, members)."
30396 },
30397 {
30398 "slug": "DISCORDBOT_CREATE_INTERACTION_RESPONSE",
30399 "name": "Post interaction callback",
30099 - "description": "Sends a response to a Discord interaction (e.g., slash command, component); ensure response type is context-appropriate and initial reply is within 3 seconds."
30400 + "description": "Sends a response to a Discord interaction (e.g., slash command, component). Ensure response type is context-appropriate and initial reply is within 3 seconds."
30401 },
30402 {
30403 "slug": "DISCORDBOT_CREATE_MESSAGE",
30103 - "name": "Post message to channel",
30104 - "description": "Sends a message to a specified Discord channel (text, embeds, stickers, components, attachments); requires `SEND_MESSAGES` permission and one of `content`, `embeds`, `sticker_ids`, or `attachments`."
30404 + "name": "Send Message To Channel",
30405 + "description": "Sends a message to a Discord channel. Supports text content, embeds, stickers, components, and replies. Requires SEND_MESSAGES permission and at least one of content, embeds, sticker_ids, or components."
30406 },
30407 {
30408 "slug": "DISCORDBOT_CREATE_STAGE_INSTANCE",
30108 - "name": "Create Stage Instance",
30109 - "description": "Creates a new Stage instance in a Stage channel (channel type 13) for hosting live audio events with speakers and listeners. Requires MANAGE_CHANNELS, MUTE_MEMBERS, and MOVE_MEMBERS permissions. A Stage channel can only have one active Stage instance at a time."
30409 + "name": "Create stage instance",
30410 + "description": "Creates a new Stage instance in a Stage channel for hosting live audio events. Requires MANAGE_CHANNELS, MUTE_MEMBERS, and MOVE_MEMBERS permissions. A Stage channel can only have one active instance at a time."
30411 },
30412 {
30413 "slug": "DISCORDBOT_CREATE_THREAD",
30414 "name": "Create new thread in channel",
30114 - "description": "Creates a new thread in a text or announcement Discord channel; requires a 'name' and optionally other details (e.g., 'auto_archive_duration', an initial 'message') in the request body."
30415 + "description": "Creates a new thread in a text, announcement, forum, or media channel."
30416 },
30417 {
30418 "slug": "DISCORDBOT_CREATE_THREAD_FROM_MESSAGE",
30419 "name": "Create thread from message",
30119 - "description": "Creates a new thread from a specific message in a Discord channel, requiring `CREATE_PUBLIC_THREADS` permission (and `SEND_MESSAGES` if in a forum/media channel)."
30420 + "description": "Creates a new thread from a specific message in a Discord channel, requiring CREATE_PUBLIC_THREADS permission."
30421 },
30422 {
30423 "slug": "DISCORDBOT_CREATE_WEBHOOK",
30424 "name": "Create channel webhook",
30124 - "description": "Creates a webhook in a specified Discord channel for external applications to post messages, provided the caller has 'MANAGE_WEBHOOKS' permission in that channel."
30425 + "description": "Creates a new webhook in a specified Discord channel, requiring MANAGE_WEBHOOKS permission."
30426 },
30427 {
30428 "slug": "DISCORDBOT_CROSSPOST_MESSAGE",
30128 - "name": "Crosspost channel message",
30129 - "description": "Crossposts a message from an announcement channel to all following channels, provided the message has not been previously crossposted and is not a system message or a message sent by a webhook."
30429 + "name": "Crosspost Message",
30430 + "description": "Crossposts a message from an announcement channel to all channels following it. The message must not have been previously crossposted and must not be a system message."
30431 },
30432 {
30433 "slug": "DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS",
30133 - "name": "Delete all reactions from message",
30134 - "description": "Deletes all reactions from a message in a Discord channel. This removes reactions from all users, not just the bot. Requires the bot to have the 'MANAGE_MESSAGES' permission in the channel. Returns HTTP 204 No Content on success."
30434 + "name": "Delete All Reactions",
30435 + "description": "Removes all reactions from a message. Requires MANAGE_MESSAGES permission. This removes reactions from all users, not just the bot."
30436 },
30437 {
30438 "slug": "DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS_BY_EMOJI",
30138 - "name": "Delete channel message reaction by emoji",
30139 - "description": "Removes all reactions for a specific emoji from a message in a Discord channel. This action deletes all user reactions for a given emoji on a specific message. It requires the bot to have the MANAGE_MESSAGES permission in the channel. The operation is irreversible and will fire a Message Reaction Remove Emoji Gateway event. Common use cases: - Cleaning up unwanted reactions from a specific emoji - Managing reactions in moderation scenarios - Resetting poll or voting mechanisms that use reactions Note: This removes ALL user reactions for the specified emoji, not just the bot's reaction. To remove only the bot's reaction, use the delete_my_message_reaction action instead."
30439 + "name": "Delete All Reactions By Emoji",
30440 + "description": "Removes all reactions for a specific emoji from a message. Requires MANAGE_MESSAGES permission. Removes reactions from all users, not just the bot."
30441 },
30442 {
30443 "slug": "DISCORDBOT_DELETE_APPLICATION_COMMAND",
30143 - "name": "Delete application command",
30144 - "description": "Permanently deletes a global application command (slash command, user command, or message command) from your Discord bot. This action is irreversible and removes the command globally. The command will no longer appear in Discord clients. To delete guild-specific commands, use the delete_guild_application_command action instead. Note: This deletes global commands which can take up to 1 hour to fully propagate across all Discord clients."
30444 + "name": "Delete global application command",
30445 + "description": "Permanently deletes a global application command. This is irreversible and the command will no longer appear in Discord clients. Global command deletions can take up to 1 hour to propagate."
30446 },
30447 {
30448 "slug": "DISCORDBOT_DELETE_AUTO_MODERATION_RULE",
30148 - "name": "Delete guild auto moderation rule",
30149 - "description": "Deletes a specific auto-moderation rule from a Discord guild."
30449 + "name": "Delete auto moderation rule",
30450 + "description": "Permanently deletes a specific auto moderation rule from a Discord guild. Requires MANAGE_GUILD permission."
30451 },
30452 {
30453 "slug": "DISCORDBOT_DELETE_CHANNEL",
30454 "name": "Delete channel by id",
30154 - "description": "Permanently deletes a Discord channel by its ID; this action is irreversible and the channel must exist and be deletable."
30455 + "description": "Permanently deletes a Discord channel by its ID. This action is irreversible. Returns the deleted channel object (not 204)."
30456 },
30457 {
30458 "slug": "DISCORDBOT_DELETE_CHANNEL_PERMISSION_OVERWRITE",
30459 "name": "Delete channel permission override",
30159 - "description": "Removes channel-specific permission overwrites for a user or role, reverting them to default permissions inherited from the server or category. Requires MANAGE_ROLES permission. Only works for guild channels (not DMs). Use this to revoke special channel access or restrictions previously set via permission overwrites. Fires a Channel Update Gateway event. Returns 204 No Content on success. This action is irreversible - to restore permissions, you must recreate the overwrite."
30460 + "description": "Removes channel-specific permission overwrites for a user or role, reverting them to default permissions inherited from the server or category. Requires MANAGE_ROLES permission. This action is irreversible."
30461 },
30462 {
30463 "slug": "DISCORDBOT_DELETE_GROUP_DM_USER",
30464 "name": "Remove user from group DM",
30164 - "description": "Remove a recipient from a Discord group DM channel. Removes a user from a group DM channel (type 3), revoking their access. This action fires a Channel Recipient Remove Gateway event when successful. **Important**: This endpoint requires OAuth2 user access tokens with the 'gdm.join' scope. Bot tokens cannot access group DM functionality as Discord bots cannot participate in group DM channels. Only the group DM owner or managing application can remove recipients."
30465 + "description": "Removes a recipient from a Discord group DM channel. Requires OAuth2 user access tokens with the gdm.join scope. Only the group DM owner or managing application can remove recipients."
30466 },
30467 {
30468 "slug": "DISCORDBOT_DELETE_GUILD",
30469 "name": "Delete guild by id",
30169 - "description": "Permanently deletes a specified Discord guild (server); the authenticated user must be the owner of the guild."
30470 + "description": "Permanently deletes a specified Discord guild (server). The authenticated user must be the owner of the guild. This action is irreversible."
30471 },
30472 {
30473 "slug": "DISCORDBOT_DELETE_GUILD_APPLICATION_COMMAND",
30173 - "name": "Delete guild command",
30174 - "description": "Permanently deletes a specific application command (e.g., slash, user, or message) for an application from a Discord guild, used to remove outdated or unnecessary commands."
30474 + "name": "Delete guild application command",
30475 + "description": "Permanently deletes a guild-specific application command. This is irreversible."
30476 },
30477 {
30478 "slug": "DISCORDBOT_DELETE_GUILD_EMOJI",
30479 "name": "Delete guild emoji by id",
30179 - "description": "Permanently deletes a specified custom emoji from a guild, requiring 'Manage Expressions' permissions; cannot delete default emojis and is irreversible."
30480 + "description": "Permanently deletes a specified custom emoji from a guild, requiring Manage Expressions permissions; cannot delete default emojis and is irreversible."
30481 },
30482 {
30483 "slug": "DISCORDBOT_DELETE_GUILD_INTEGRATION",
30484 "name": "Delete guild integration",
30184 - "description": "Permanently deletes a specific integration from a Discord guild, removing any associated webhooks and kicking the bot if present. Requires MANAGE_GUILD permission. Important: Bots can only delete their own integration; attempting to delete other integrations returns 403 Missing Access."
30485 + "description": "Permanently deletes a specific integration from a Discord guild, removing any associated webhooks and kicking the bot if present. Requires MANAGE_GUILD permission."
30486 },
30487 {
30488 "slug": "DISCORDBOT_DELETE_GUILD_MEMBER",
30489 "name": "Delete guild member by id",
30189 - "description": "Removes (kicks) a member from a Discord guild; the user must be an existing member of the specified guild, and this action is permanent."
30490 + "description": "Removes (kicks) a member from a Discord guild. The user must be an existing member of the specified guild. Requires KICK_MEMBERS permission."
30491 },
30492 {
30493 "slug": "DISCORDBOT_DELETE_GUILD_MEMBER_ROLE",
30494 "name": "Delete guild member role",
30194 - "description": "Removes a specified role from a member of a Discord guild. This action requires the bot to have the MANAGE_ROLES permission in the guild, and the role being removed must be hierarchically lower than the bot's highest role. The operation is idempotent - it succeeds (HTTP 204) even if the member does not currently have the specified role. Fires a Guild Member Update Gateway event when successful."
30495 + "description": "Removes a specified role from a member of a Discord guild. Requires MANAGE_ROLES permission and the role must be lower in hierarchy than the bot's highest role. Idempotent - succeeds even if member does not have the role."
30496 },
30497 {
30498 "slug": "DISCORDBOT_DELETE_GUILD_ROLE",
30499 "name": "Delete role from guild",
30199 - "description": "Permanently deletes a specified role from a Discord guild, revoking it from all members; requires 'Manage Roles' permission and the target role must be lower in hierarchy than the bot's highest role."
30500 + "description": "Permanently deletes a specified role from a Discord guild, revoking it from all members. Requires MANAGE_ROLES permission and the target role must be lower in hierarchy than the bot's highest role."
30501 },
30502 {
30503 "slug": "DISCORDBOT_DELETE_GUILD_SCHEDULED_EVENT",
30504 "name": "Delete guild scheduled event",
30204 - "description": "Permanently deletes a specific scheduled event from a Discord guild; this action is irreversible."
30505 + "description": "Permanently deletes a specific scheduled event from a Discord guild. This action is irreversible."
30506 },
30507 {
30508 "slug": "DISCORDBOT_DELETE_GUILD_STICKER",
@@ -30215,132 +30516,132 @@
30516 },
30517 {
30518 "slug": "DISCORDBOT_DELETE_MESSAGE",
30218 - "name": "Delete channel message",
30219 - "description": "Permanently and irreversibly deletes a message from a specified Discord channel."
30519 + "name": "Delete Message",
30520 + "description": "Permanently deletes a message from a Discord channel. The bot can delete its own messages or, with MANAGE_MESSAGES permission, delete messages from other users."
30521 },
30522 {
30523 "slug": "DISCORDBOT_DELETE_MY_MESSAGE_REACTION",
30223 - "name": "Delete user reaction on message",
30224 - "description": "Removes the authenticated user's own emoji reaction, which they must have previously added, from a specific message in a Discord channel; this action is irreversible and cannot remove others' reactions."
30524 + "name": "Remove My Reaction",
30525 + "description": "Removes the bot's own emoji reaction from a message. Only removes the bot's reaction, not other users' reactions."
30526 },
30527 {
30528 "slug": "DISCORDBOT_DELETE_ORIGINAL_WEBHOOK_MESSAGE",
30529 "name": "Delete original webhook message",
30229 - "description": "Permanently deletes an existing original message posted by a webhook (using its ID and token), optionally within a specific thread."
30530 + "description": "Permanently deletes the original (@original) message posted by a webhook or interaction response."
30531 },
30532 {
30533 "slug": "DISCORDBOT_DELETE_STAGE_INSTANCE",
30233 - "name": "Delete stage instance by channel id",
30234 - "description": "Deletes the Stage Instance for the given `channel_id`, permanently ending its live audio event."
30534 + "name": "Delete stage instance",
30535 + "description": "Permanently deletes the Stage instance for a given stage channel, ending the live audio event."
30536 },
30537 {
30538 "slug": "DISCORDBOT_DELETE_THREAD_MEMBER",
30238 - "name": "Delete channel thread member",
30239 - "description": "Removes a user from a specified, unarchived thread in a Discord channel."
30539 + "name": "Remove thread member",
30540 + "description": "Removes a user from a specified, unarchived thread. Requires MANAGE_THREADS permission."
30541 },
30542 {
30543 "slug": "DISCORDBOT_DELETE_USER_MESSAGE_REACTION",
30243 - "name": "Delete user reaction from message",
30244 - "description": "Removes a specific user's emoji reaction from a message; requires 'Manage Messages' permission if deleting reactions from other users."
30544 + "name": "Remove User Reaction",
30545 + "description": "Removes a specific user's emoji reaction from a message. Requires MANAGE_MESSAGES permission."
30546 },
30547 {
30548 "slug": "DISCORDBOT_DELETE_WEBHOOK",
30549 "name": "Delete webhook by id",
30249 - "description": "Permanently deletes a specified, existing Discord webhook by its unique ID; this action is irreversible."
30550 + "description": "Permanently deletes a Discord webhook by its unique ID. This action is irreversible."
30551 },
30552 {
30553 "slug": "DISCORDBOT_DELETE_WEBHOOK_BY_TOKEN",
30253 - "name": "Delete webhook using id and token",
30254 - "description": "Permanently deletes a Discord webhook specified by its ID and token; this action is irreversible."
30554 + "name": "Delete webhook by token",
30555 + "description": "Permanently deletes a Discord webhook using its ID and token, without bot authentication."
30556 },
30557 {
30558 "slug": "DISCORDBOT_DELETE_WEBHOOK_MESSAGE",
30559 "name": "Delete webhook message",
30259 - "description": "Deletes a message previously sent by the specified webhook, optionally within a specific thread."
30560 + "description": "Deletes a message previously sent by a Discord webhook."
30561 },
30562 {
30563 "slug": "DISCORDBOT_EXECUTE_GITHUB_COMPATIBLE_WEBHOOK",
30263 - "name": "Github action webhooks processing",
30264 - "description": "Forwards GitHub event notifications to a Discord channel via a webhook configured for GitHub-formatted payloads (URL ending in `/github`)."
30564 + "name": "Execute GitHub-compatible webhook",
30565 + "description": "Forwards GitHub event notifications to a Discord channel via a GitHub-compatible webhook endpoint."
30566 },
30567 {
30568 "slug": "DISCORDBOT_EXECUTE_SLACK_COMPATIBLE_WEBHOOK",
30268 - "name": "Post to slack webhook",
30269 - "description": "Sends richly formatted messages to Discord via its Slack-compatible webhook endpoint; requires at least one of `text` or `attachments` and adherence to content limits."
30569 + "name": "Execute Slack-compatible webhook",
30570 + "description": "Sends messages to Discord via its Slack-compatible webhook endpoint, supporting Slack attachment formatting."
30571 },
30572 {
30573 "slug": "DISCORDBOT_EXECUTE_WEBHOOK",
30273 - "name": "Post webhook with embeds and components",
30274 - "description": "Executes a Discord webhook to send messages, embeds, or interactive components to a specific Discord channel or thread."
30574 + "name": "Execute webhook",
30575 + "description": "Executes a Discord webhook to send messages, embeds, or interactive components to a channel or thread."
30576 },
30577 {
30578 "slug": "DISCORDBOT_FOLLOW_CHANNEL",
30579 "name": "Add follower to channel via webhook",
30279 - "description": "Follows an Announcement Channel (News Channel) to relay its messages to a target channel via webhook. The bot must have MANAGE_WEBHOOKS permission in the target channel (`webhook_channel_id`). The source channel must be an Announcement Channel (requires server to have Community features enabled)."
30580 + "description": "Follows an Announcement Channel to relay its messages to a target channel via webhook. The bot must have MANAGE_WEBHOOKS permission in the target channel."
30581 },
30582 {
30583 "slug": "DISCORDBOT_GET_ACTIVE_GUILD_THREADS",
30584 "name": "List active threads in guild",
30284 - "description": "Retrieves all active (non-archived) threads in a Discord guild that the bot can access. Returns both public and private threads that are currently active, along with thread member information for threads the bot has joined. Archived threads are excluded from results."
30585 + "description": "Retrieves all active (non-archived) threads in a Discord guild that the bot can access."
30586 },
30587 {
30588 "slug": "DISCORDBOT_GET_APPLICATION",
30288 - "name": "Retrieve application details",
30289 - "description": "Retrieves the full details of a Discord application using its unique `application_id`."
30589 + "name": "Get application details",
30590 + "description": "Retrieves the full details of a Discord application by its application_id."
30591 },
30592 {
30593 "slug": "DISCORDBOT_GET_APPLICATION_COMMAND",
30293 - "name": "Fetch application command by id",
30294 - "description": "Fetches the details of a specific, existing application command, identified by its application Snowflake ID and command Snowflake ID."
30594 + "name": "Get global application command",
30595 + "description": "Retrieves a specific global application command by its application ID and command ID."
30596 },
30597 {
30598 "slug": "DISCORDBOT_GET_APPLICATION_ROLE_CONNECTIONS_METADATA",
30298 - "name": "Retrieve application role metadata",
30299 - "description": "Retrieves all role connection metadata records for a given Discord application ID; an empty list is returned if none are configured."
30599 + "name": "Get application role connections metadata",
30600 + "description": "Retrieves all role connection metadata records for a Discord application. Returns an empty list if none are configured."
30601 },
30602 {
30603 "slug": "DISCORDBOT_GET_APPLICATION_USER_ROLE_CONNECTION",
30604 "name": "Get user role connection",
30304 - "description": "Fetches the role connection object for the current user for a specified Discord application."
30605 + "description": "Fetches the role connection object for the current user for a specified Discord application. Requires OAuth2 with the role_connections.write scope."
30606 },
30607 {
30608 "slug": "DISCORDBOT_GET_AUTO_MODERATION_RULE",
30308 - "name": "Retrieve auto moderation rule",
30309 - "description": "Retrieves the complete configuration details of a specific auto-moderation rule within a Discord guild for inspection or verification."
30609 + "name": "Get auto moderation rule",
30610 + "description": "Retrieves the complete configuration of a specific auto moderation rule within a Discord guild."
30611 },
30612 {
30613 "slug": "DISCORDBOT_GET_BOT_GATEWAY",
30313 - "name": "Retrieve bot gateway",
30314 - "description": "Retrieves the WSS URL, recommended shard count, and session start limits, which are prerequisite for a bot to connect to the Discord Gateway and receive events."
30614 + "name": "Get bot gateway",
30615 + "description": "Retrieves the WSS URL, recommended shard count, and session start limits for connecting a bot to the Discord Gateway."
30616 },
30617 {
30618 "slug": "DISCORDBOT_GET_CHANNEL",
30619 "name": "Retrieve channel details",
30319 - "description": "Retrieves detailed metadata for a specific Discord channel using its `channel_id`, which must be a valid and accessible channel ID; note that this action returns only channel metadata, not message content or member lists."
30620 + "description": "Retrieves detailed metadata for a specific Discord channel by its channel_id. Returns only channel metadata, not message content or member lists."
30621 },
30622 {
30623 "slug": "DISCORDBOT_GET_GATEWAY",
30323 - "name": "Get gateway details",
30324 - "description": "Retrieves the WebSocket URL to connect to Discord's Gateway for receiving real-time events."
30624 + "name": "Get gateway URL",
30625 + "description": "Retrieves the WebSocket URL to connect to Discord's Gateway for receiving real-time events. This is a public endpoint that does not require authentication."
30626 },
30627 {
30628 "slug": "DISCORDBOT_GET_GUILD",
30629 "name": "Retrieve guild details",
30329 - "description": "Retrieves detailed information for a specified Discord guild (server) by its `guild_id`, optionally including approximate member and presence counts if `with_counts` is true."
30630 + "description": "Retrieves detailed information for a specified Discord guild (server) by its guild_id, optionally including approximate member and presence counts if with_counts is true."
30631 },
30632 {
30633 "slug": "DISCORDBOT_GET_GUILD_APPLICATION_COMMAND",
30333 - "name": "Fetch guild application command by id",
30334 - "description": "Fetches detailed information for a specific application command within a Discord guild, identified by `application_id`, `guild_id`, and `command_id`."
30634 + "name": "Get guild application command",
30635 + "description": "Retrieves detailed information for a specific application command within a Discord guild."
30636 },
30637 {
30638 "slug": "DISCORDBOT_GET_GUILD_APPLICATION_COMMAND_PERMISSIONS",
30338 - "name": "Retrieve guild command permissions",
30339 - "description": "Fetches the permissions for a specific application command within a guild, used to inspect its current access settings."
30639 + "name": "Get guild command permissions",
30640 + "description": "Retrieves the permissions for a specific application command within a guild."
30641 },
30642 {
30643 "slug": "DISCORDBOT_GET_GUILD_BAN",
30343 - "name": "Retrieve guild user ban details",
30644 + "name": "Get guild ban",
30645 "description": "Fetches the ban details for a specific user in a Discord guild, if that user is currently banned."
30646 },
30647 {
@@ -30351,7 +30652,7 @@
30652 {
30653 "slug": "DISCORDBOT_GET_GUILD_MEMBER",
30654 "name": "Retrieve guild member by user id",
30354 - "description": "Retrieves detailed information for a specific member of a Discord guild, provided the bot belongs to the guild and has necessary permissions (e.g., GUILD_MEMBERS intent)."
30655 + "description": "Retrieves detailed information for a specific member of a Discord guild, provided the bot belongs to the guild and has necessary permissions."
30656 },
30657 {
30658 "slug": "DISCORDBOT_GET_GUILD_PREVIEW",
@@ -30360,13 +30661,13 @@
30661 },
30662 {
30663 "slug": "DISCORDBOT_GET_GUILD_SCHEDULED_EVENT",
30363 - "name": "Get guild scheduled event by id",
30664 + "name": "Get guild scheduled event",
30665 "description": "Retrieves a specific scheduled event from a Discord guild by its ID, optionally including the count of subscribed users."
30666 },
30667 {
30668 "slug": "DISCORDBOT_GET_GUILDS_ONBOARDING",
30368 - "name": "Get guild onboarding by id",
30369 - "description": "Retrieves the onboarding settings for a specified Discord guild, including prompts, options, default channels, and enabled status, to examine its new member guidance process when the guild_id is known and accessible."
30669 + "name": "Get guild onboarding",
30670 + "description": "Retrieves the onboarding settings for a specified Discord guild, including prompts, options, default channels, and enabled status."
30671 },
30672 {
30673 "slug": "DISCORDBOT_GET_GUILD_STICKER",
@@ -30376,22 +30677,22 @@
30677 {
30678 "slug": "DISCORDBOT_GET_GUILD_TEMPLATE",
30679 "name": "Retrieve guild template with code",
30379 - "description": "Retrieves the complete structure and details of a Discord guild template using its unique code; the code must be valid and refer to an existing, accessible template."
30680 + "description": "Retrieves the complete structure and details of a Discord guild template using its unique code."
30681 },
30682 {
30683 "slug": "DISCORDBOT_GET_GUILD_VANITY_URL",
30684 "name": "Retrieve guild vanity url",
30384 - "description": "Retrieves the vanity URL invite code and usage count for a Discord guild. The guild must have the VANITY_URL feature enabled (available for partnered, verified, or Level 3 boosted servers), and the bot must have MANAGE_GUILD permission. Returns the vanity URL code (or null if not set) and the number of times the vanity invite has been used."
30685 + "description": "Retrieves the vanity URL invite code and usage count for a Discord guild. Requires MANAGE_GUILD permission and the VANITY_URL feature."
30686 },
30687 {
30688 "slug": "DISCORDBOT_GET_GUILD_WEBHOOKS",
30689 "name": "Retrieve guild webhooks",
30389 - "description": "Retrieves all webhook objects for a specified Discord guild; requires 'MANAGE_WEBHOOKS' permission for the authenticated entity."
30690 + "description": "Retrieves all webhooks for a specified Discord guild, requiring MANAGE_WEBHOOKS permission."
30691 },
30692 {
30693 "slug": "DISCORDBOT_GET_GUILD_WELCOME_SCREEN",
30694 "name": "Retrieve guild welcome screen",
30394 - "description": "Retrieves the welcome screen configuration for a Discord guild with the Community feature enabled. Returns the welcome screen description and up to 5 suggested channels. If the welcome screen is disabled, the bot requires MANAGE_GUILD permission to view it."
30695 + "description": "Retrieves the welcome screen configuration for a Discord guild with the Community feature enabled. Returns the welcome screen description and up to 5 suggested channels."
30696 },
30697 {
30698 "slug": "DISCORDBOT_GET_GUILD_WIDGET",
@@ -30400,143 +30701,143 @@
30701 },
30702 {
30703 "slug": "DISCORDBOT_GET_GUILD_WIDGET_PNG",
30403 - "name": "Get guild widget png",
30404 - "description": "Retrieves the widget PNG image for a Discord guild. Returns a PNG shield-style badge showing guild information. Use when you need to display guild widget as an image. The widget must be enabled for the guild."
30704 + "name": "Get Guild Widget PNG",
30705 + "description": "Tool to retrieve a PNG image widget for a Discord guild. Use when you need a visual representation of the guild widget that can be displayed on external websites. The widget must be enabled in the guild's server settings."
30706 },
30707 {
30708 "slug": "DISCORDBOT_GET_GUILD_WIDGET_SETTINGS",
30408 - "name": "Retrieve guild widget information",
30409 - "description": "Retrieves the widget settings for a specified Discord guild, indicating if the widget is enabled and its configured channel ID; requires a valid `guild_id`."
30709 + "name": "Retrieve guild widget settings",
30710 + "description": "Retrieves the widget settings for a specified Discord guild, indicating if the widget is enabled and its configured channel ID."
30711 },
30712 {
30713 "slug": "DISCORDBOT_GET_MESSAGE",
30413 - "name": "Retrieve message from channel",
30414 - "description": "Retrieves a specific message from a Discord channel, identified by `channel_id` and `message_id`, if the channel and message exist and are accessible."
30714 + "name": "Get Message",
30715 + "description": "Retrieves a specific message from a Discord channel by channel and message ID."
30716 },
30717 {
30718 "slug": "DISCORDBOT_GET_MY_APPLICATION",
30418 - "name": "Get your applications",
30419 - "description": "Retrieves detailed information about the current authenticated Discord application."
30719 + "name": "Get my application",
30720 + "description": "Retrieves detailed information about the current authenticated Discord application via /applications/@me."
30721 },
30722 {
30723 "slug": "DISCORDBOT_GET_MY_OAUTH2_APPLICATION",
30423 - "name": "Get oauth2 applications for current user",
30424 - "description": "Retrieves detailed information about the OAuth2 application associated with the current authentication; cannot query other applications."
30724 + "name": "Get my OAuth2 application",
30725 + "description": "Retrieves detailed information about the OAuth2 application associated with the current authentication."
30726 },
30727 {
30728 "slug": "DISCORDBOT_GET_ORIGINAL_WEBHOOK_MESSAGE",
30729 "name": "Retrieve original webhook message",
30429 - "description": "Retrieves the initial response message from a Discord interaction webhook (slash commands, buttons, etc.) or regular webhook. This fetches the '@original' message, which is the first message sent when responding to an interaction or executing a webhook with wait=true. For interaction responses, the interaction token is valid for 15 minutes after the interaction was created."
30730 + "description": "Retrieves the original (@original) message from a Discord webhook or interaction response."
30731 },
30732 {
30733 "slug": "DISCORDBOT_GET_PUBLIC_KEYS",
30433 - "name": "Get oauth2 keys",
30434 - "description": "Retrieves Discord's OAuth2 public keys (JWK format) for verifying access tokens; keys may rotate, so refresh caches periodically."
30734 + "name": "Get OAuth2 public keys",
30735 + "description": "Retrieves Discord's OAuth2 public keys in JWK format for verifying access tokens. Keys may rotate, so refresh caches periodically."
30736 },
30737 {
30738 "slug": "DISCORDBOT_GET_STAGE_INSTANCE",
30438 - "name": "Retrieve stage instance by channel id",
30439 - "description": "Gets the active stage instance associated with a stage channel (type 13). Returns the stage instance object if one exists, or a 404 error if the channel has no active stage instance. A stage instance represents a live stage event with a topic, privacy level, and optional scheduled event association."
30739 + "name": "Get stage instance",
30740 + "description": "Retrieves the active Stage instance for a specified stage channel. Returns 404 if no active Stage instance exists."
30741 },
30742 {
30743 "slug": "DISCORDBOT_GET_STICKER",
30443 - "name": "Retrieve sticker by id",
30744 + "name": "Get sticker",
30745 "description": "Retrieves a specific Discord sticker by its unique ID."
30746 },
30747 {
30748 "slug": "DISCORDBOT_GET_THREAD_MEMBER",
30749 "name": "Retrieve thread member by id",
30449 - "description": "Retrieves a member from a specified thread using their user ID, optionally including the full guild member object."
30750 + "description": "Retrieves a member from a specified thread using their user ID, optionally including guild member details."
30751 },
30752 {
30753 "slug": "DISCORDBOT_GET_USER",
30453 - "name": "Retrieve user by id",
30454 - "description": "Fetches public information for a Discord user, requiring a valid and existing user ID (snowflake)."
30754 + "name": "Get user",
30755 + "description": "Fetches public information for a Discord user by their user ID."
30756 },
30757 {
30758 "slug": "DISCORDBOT_GET_WEBHOOK",
30759 "name": "Retrieve webhook by id",
30459 - "description": "Retrieves detailed information for an existing Discord webhook, identified by its unique ID, to verify settings or manage the webhook."
30760 + "description": "Retrieves detailed information for a Discord webhook by its unique ID."
30761 },
30762 {
30763 "slug": "DISCORDBOT_GET_WEBHOOK_BY_TOKEN",
30463 - "name": "Retrieve webhook information",
30464 - "description": "Fetches a Discord webhook's configuration details (e.g., name, avatar, channel ID) using its ID and token; this excludes message history or usage statistics."
30764 + "name": "Retrieve webhook by token",
30765 + "description": "Retrieves a Discord webhook's configuration using its ID and token, without requiring bot authentication."
30766 },
30767 {
30768 "slug": "DISCORDBOT_GET_WEBHOOK_MESSAGE",
30468 - "name": "Retrieve webhook message by id",
30469 - "description": "Retrieves a specific message previously sent by a Discord webhook using its `message_id`, requiring `thread_id` if the message is part of a thread."
30769 + "name": "Retrieve webhook message",
30770 + "description": "Retrieves a specific message previously sent by a Discord webhook."
30771 },
30772 {
30773 "slug": "DISCORDBOT_INVITE_RESOLVE",
30473 - "name": "Retrieve invite by code",
30474 - "description": "Resolves a Discord invite code to get its details, optionally including member counts or data for a specific guild scheduled event; visibility of some details may depend on bot permissions."
30774 + "name": "Resolve invite by code",
30775 + "description": "Resolves a Discord invite code to get its details, optionally including member counts and expiration."
30776 },
30777 {
30778 "slug": "DISCORDBOT_INVITE_REVOKE",
30478 - "name": "Delete invite via code",
30479 - "description": "Revokes a Discord server invite using its unique code, permanently preventing new joins via this link (does not affect existing members); requires 'Manage Server' or 'Manage Invites' permissions on the server."
30779 + "name": "Revoke invite by code",
30780 + "description": "Revokes a Discord invite using its code, permanently preventing new joins via this link."
30781 },
30782 {
30783 "slug": "DISCORDBOT_JOIN_THREAD",
30784 "name": "Join thread",
30484 - "description": "Joins the authenticated user to a thread specified by `channel_id`; use this when the user is not already a member, for archived threads, or for threads requiring explicit joining, provided the thread is joinable, not locked or full, and the user has permissions."
30785 + "description": "Joins the authenticated user to a thread specified by channel_id."
30786 },
30787 {
30788 "slug": "DISCORDBOT_LEAVE_GUILD",
30789 "name": "Leave Guild",
30489 - "description": "Enables the bot to leave a specified Discord guild (server) of which it is a member but not the owner; this action is irreversible and the bot must be re-invited to rejoin."
30790 + "description": "Enables the bot to leave a specified Discord guild (server). This action is irreversible and the bot must be re-invited to rejoin."
30791 },
30792 {
30793 "slug": "DISCORDBOT_LEAVE_THREAD",
30493 - "name": "Remove current user from thread",
30494 - "description": "Removes the currently authenticated user from a specified, existing, and accessible Discord thread of which they are currently a member."
30794 + "name": "Leave thread",
30795 + "description": "Removes the currently authenticated user from a specified thread."
30796 },
30797 {
30798 "slug": "DISCORDBOT_LIST_APPLICATION_COMMANDS",
30498 - "name": "List commands for application",
30499 - "description": "Fetches all global application commands for the specified Discord application ID; does not fetch guild-specific commands."
30799 + "name": "List global application commands",
30800 + "description": "Fetches all global application commands for the specified Discord application. Does not include guild-specific commands."
30801 },
30802 {
30803 "slug": "DISCORDBOT_LIST_AUTO_MODERATION_RULES",
30503 - "name": "Retrieve guild auto moderation rules",
30504 - "description": "Fetches all auto moderation rules for a specified Discord guild to review or audit its configuration; requires `VIEW_AUDIT_LOG` permissions and the action does not modify rules."
30804 + "name": "List auto moderation rules",
30805 + "description": "Retrieves all auto moderation rules for a specified Discord guild. Requires MANAGE_GUILD permission."
30806 },
30807 {
30808 "slug": "DISCORDBOT_LIST_CHANNEL_INVITES",
30508 - "name": "List Channel Invites",
30509 - "description": "Fetches all active invites for a given Discord channel (read-only). Requires MANAGE_CHANNELS permission. Returns a list of invite objects with metadata (uses, max_uses, creator, timestamps, etc.). Response structures vary by invite type (guild, DM, stage instance, scheduled event)."
30809 + "name": "List channel invites",
30810 + "description": "Fetches all active invites for a given Discord channel. Requires MANAGE_CHANNELS permission."
30811 },
30812 {
30813 "slug": "DISCORDBOT_LIST_CHANNEL_WEBHOOKS",
30513 - "name": "Retrieve channel webhooks",
30514 - "description": "Fetches detailed information for all webhooks in a given valid Discord channel, useful for review or auditing purposes."
30814 + "name": "List Channel Webhooks",
30815 + "description": "Retrieves all webhooks configured in a given Discord channel. Requires the MANAGE_WEBHOOKS permission."
30816 },
30817 {
30818 "slug": "DISCORDBOT_LIST_GUILD_APPLICATION_COMMAND_PERMISSIONS",
30518 - "name": "Get application guild command permissions",
30519 - "description": "Call this action to retrieve all explicitly set guild-level permission settings for all commands of a specific application within a given guild, typically for auditing or troubleshooting command access."
30819 + "name": "List guild command permissions",
30820 + "description": "Retrieves all guild-level permission settings for all commands of a specific application within a guild."
30821 },
30822 {
30823 "slug": "DISCORDBOT_LIST_GUILD_APPLICATION_COMMANDS",
30523 - "name": "Fetch guild commands via application id",
30524 - "description": "Fetches all application command definitions (slash, user, and message types) for a specific application within a given Discord guild, optionally including localizations; does not return permissions or usage statistics."
30824 + "name": "List guild application commands",
30825 + "description": "Fetches all application commands registered for a specific guild. Does not include global commands."
30826 },
30827 {
30828 "slug": "DISCORDBOT_LIST_GUILD_AUDIT_LOG_ENTRIES",
30528 - "name": "Get guild audit logs by guild id",
30529 - "description": "Retrieves audit log entries (e.g., message deletions, member kicks/bans, role changes) for a specified Discord guild, requiring 'VIEW_AUDIT_LOG' permission."
30829 + "name": "Get guild audit logs",
30830 + "description": "Retrieves audit log entries for a specified Discord guild, requiring VIEW_AUDIT_LOG permission. Supports filtering by user, action type, and pagination."
30831 },
30832 {
30833 "slug": "DISCORDBOT_LIST_GUILD_BANS",
30834 "name": "List guild bans",
30534 - "description": "Fetches a list of users banned from a specified Discord guild; `before`/`after` parameters require user IDs from previous results for correct pagination."
30835 + "description": "Fetches a list of users banned from a specified Discord guild. Requires BAN_MEMBERS permission."
30836 },
30837 {
30838 "slug": "DISCORDBOT_LIST_GUILD_CHANNELS",
30839 "name": "Retrieve guild channels",
30539 - "description": "Fetches all channels (e.g., text, voice, category, threads) and their structural information for a specified Discord guild ID; does not include message content."
30840 + "description": "Fetches all channels (text, voice, category, etc.) for a specified Discord guild. Does not include threads or message content."
30841 },
30842 {
30843 "slug": "DISCORDBOT_LIST_GUILD_EMOJIS",
@@ -30546,32 +30847,32 @@
30847 {
30848 "slug": "DISCORDBOT_LIST_GUILD_INTEGRATIONS",
30849 "name": "List guild integrations",
30549 - "description": "Lists all integration objects for a specified Discord guild."
30850 + "description": "Lists all integration objects for a specified Discord guild. Requires MANAGE_GUILD permission."
30851 },
30852 {
30853 "slug": "DISCORDBOT_LIST_GUILD_INVITES",
30553 - "name": "Retrieve guild invites by id",
30554 - "description": "Retrieves all currently active invite codes for a specified Discord guild, typically for administration, analytics, or managing guild invitations."
30854 + "name": "List guild invites",
30855 + "description": "Retrieves all currently active invite codes for a specified Discord guild."
30856 },
30857 {
30858 "slug": "DISCORDBOT_LIST_GUILD_MEMBERS",
30859 "name": "Get guild members",
30559 - "description": "Retrieves members for a Discord guild; requires a valid guild_id for an existing guild."
30860 + "description": "Retrieves a list of members for a Discord guild. Requires GUILD_MEMBERS intent. Supports pagination via limit and after parameters."
30861 },
30862 {
30863 "slug": "DISCORDBOT_LIST_GUILD_ROLES",
30864 "name": "List guild roles",
30564 - "description": "Fetches all roles in a Discord guild, providing details for each role but not user assignments; `guild_id` must be valid."
30865 + "description": "Fetches all roles in a Discord guild, providing details for each role including permissions, color, position, and other attributes."
30866 },
30867 {
30868 "slug": "DISCORDBOT_LIST_GUILD_SCHEDULED_EVENTS",
30568 - "name": "Retrieve guild scheduled events",
30569 - "description": "Retrieves a list of scheduled events for a specified Discord guild, optionally including subscribed user counts, provided the authenticated user/bot has access to the guild."
30869 + "name": "List guild scheduled events",
30870 + "description": "Retrieves a list of scheduled events for a specified Discord guild, optionally including subscribed user counts."
30871 },
30872 {
30873 "slug": "DISCORDBOT_LIST_GUILD_SCHEDULED_EVENT_USERS",
30573 - "name": "Retrieve users for scheduled event",
30574 - "description": "Fetches users who have expressed interest in a specific scheduled event, requiring valid guild and event IDs."
30874 + "name": "List scheduled event users",
30875 + "description": "Fetches users who have expressed interest in a specific scheduled event within a Discord guild. Supports pagination and optional guild member data."
30876 },
30877 {
30878 "slug": "DISCORDBOT_LIST_GUILD_STICKERS",
@@ -30581,92 +30882,92 @@
30882 {
30883 "slug": "DISCORDBOT_LIST_GUILD_TEMPLATES",
30884 "name": "Get guild templates by guild id",
30584 - "description": "Retrieves all guild templates for an existing Discord guild, specified by its ID."
30885 + "description": "Retrieves all guild templates for an existing Discord guild, specified by its ID. Requires MANAGE_GUILD permission."
30886 },
30887 {
30888 "slug": "DISCORDBOT_LIST_GUILD_VOICE_REGIONS",
30588 - "name": "List guild regions",
30889 + "name": "List guild voice regions",
30890 "description": "Fetches a list of available voice regions for a specified Discord guild."
30891 },
30892 {
30893 "slug": "DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI",
30593 - "name": "Get channel message reaction by emoji",
30594 - "description": "Fetches a list of users who reacted to a specific message with a given emoji in a Discord channel; retrieves users for one emoji at a time."
30894 + "name": "List Reactions By Emoji",
30895 + "description": "Lists users who reacted to a message with a specific emoji. Supports pagination."
30896 },
30897 {
30898 "slug": "DISCORDBOT_LIST_MESSAGES",
30598 - "name": "Fetch messages from channel",
30599 - "description": "Retrieves historical messages from a specified, accessible Discord channel, typically newest first; for real-time messages, use Discord's WebSocket Gateway API."
30899 + "name": "Fetch Messages From Channel",
30900 + "description": "Retrieves messages from a Discord channel, ordered newest first. Supports pagination via before/after/around parameters."
30901 },
30902 {
30903 "slug": "DISCORDBOT_LIST_MY_PRIVATE_ARCHIVED_THREADS",
30603 - "name": "Get private archived threads for user",
30604 - "description": "Retrieves private archived threads from a specified channel that the current user is a member of."
30904 + "name": "List my private archived threads",
30905 + "description": "Retrieves private archived threads from a channel that the current user is a member of."
30906 },
30907 {
30908 "slug": "DISCORDBOT_LIST_PINNED_MESSAGES",
30608 - "name": "Retrieve pinned messages in channel",
30609 - "description": "Retrieves all currently pinned messages from a Discord channel. Returns up to 50 pinned messages (Discord's maximum) in the channel. The bot must have permission to view the channel and read message history. Returns an empty list if no messages are pinned."
30909 + "name": "List Pinned Messages",
30910 + "description": "Retrieves all pinned messages from a Discord channel. Returns up to 50 pinned messages."
30911 },
30912 {
30913 "slug": "DISCORDBOT_LIST_PRIVATE_ARCHIVED_THREADS",
30613 - "name": "Get archived private threads by channel id",
30614 - "description": "Lists a channel's private archived threads, sorted by most recent archival, requiring view access to them."
30914 + "name": "List private archived threads",
30915 + "description": "Lists private archived threads in a Discord channel, sorted by most recent archival. Requires view access."
30916 },
30917 {
30918 "slug": "DISCORDBOT_LIST_PUBLIC_ARCHIVED_THREADS",
30618 - "name": "Get archived public threads by channel id",
30619 - "description": "Lists public archived threads in an accessible Discord channel, returning an empty list if none exist; does not list private or active threads."
30919 + "name": "List public archived threads",
30920 + "description": "Lists public archived threads in a Discord channel, sorted by most recent archival."
30921 },
30922 {
30923 "slug": "DISCORDBOT_LIST_STICKER_PACKS",
30924 "name": "List sticker packs",
30624 - "description": "Fetches sticker packs available to Nitro subscribers on Discord, excluding custom or guild-specific ones."
30925 + "description": "Fetches all available Nitro sticker packs from Discord, excluding custom or guild-specific sticker packs."
30926 },
30927 {
30928 "slug": "DISCORDBOT_LIST_THREAD_MEMBERS",
30628 - "name": "List thread members in channel",
30629 - "description": "Retrieves members of a specified Discord thread, with an option to include full guild member objects for each."
30929 + "name": "List thread members",
30930 + "description": "Retrieves members of a specified Discord thread, with an option to include full guild member objects."
30931 },
30932 {
30933 "slug": "DISCORDBOT_LIST_VOICE_REGIONS",
30633 - "name": "Fetch voice regions list",
30634 - "description": "Lists all available Discord voice regions with their ID, name, operational status (custom, deprecated, optimal), noting that availability may vary by server."
30934 + "name": "List voice regions",
30935 + "description": "Lists all available Discord voice regions that can be used when setting a voice or stage channel's region."
30936 },
30937 {
30938 "slug": "DISCORDBOT_PIN_MESSAGE",
30638 - "name": "Pin message in channel",
30639 - "description": "Pins a message in a Discord channel for increased visibility. Requires the 'Pin Messages' permission (separate from 'Manage Messages' as of Jan 2026). Channel pin limit is 250 messages. Returns HTTP 204 on success. Fails with 403 if missing permissions or 400 if pin limit exceeded."
30939 + "name": "Pin Message",
30940 + "description": "Pins a message in a Discord channel. Requires MANAGE_MESSAGES permission. A channel can have at most 50 pinned messages."
30941 },
30942 {
30943 "slug": "DISCORDBOT_PREVIEW_PRUNE_GUILD",
30643 - "name": "Retrieve guild prune info",
30644 - "description": "Previews the number of members that would be pruned from a Discord guild based on inactivity days and optional roles; this action only returns a count and does not remove members."
30944 + "name": "Preview guild prune",
30945 + "description": "Previews the number of members that would be pruned from a Discord guild based on inactivity days and optional roles; does not remove members."
30946 },
30947 {
30948 "slug": "DISCORDBOT_PRUNE_GUILD",
30949 "name": "Prune inactive guild members",
30649 - "description": "Removes inactive members from a Discord guild. Requires 'KICK_MEMBERS' permission. Set compute_prune_count=false for large guilds to avoid timeouts (returns null instead of count). To preview the prune count without removing members, use the preview_prune_guild action instead."
30950 + "description": "Removes inactive members from a Discord guild. Requires KICK_MEMBERS permission. Set compute_prune_count=false for large guilds to avoid timeouts."
30951 },
30952 {
30953 "slug": "DISCORDBOT_PUT_GUILDS_ONBOARDING",
30954 "name": "Update guild onboarding configuration",
30654 - "description": "Configures or updates a Discord guild's new member onboarding flow, including defining prompts with options, assigning roles/channels, setting default channels, and managing the flow's active status."
30955 + "description": "Configures or updates a Discord guild's new member onboarding flow, including prompts, options, default channels, and enabled status."
30956 },
30957 {
30958 "slug": "DISCORDBOT_SEARCH_GUILD_MEMBERS",
30959 "name": "Search guild members by username or nickname",
30659 - "description": "Searches for members in a specific Discord guild, allowing filtering by a query string."
30960 + "description": "Searches for members in a specific Discord guild by matching a query string against usernames and nicknames. Returns matching guild member objects."
30961 },
30962 {
30963 "slug": "DISCORDBOT_SET_CHANNEL_PERMISSION_OVERWRITE",
30964 "name": "Modify channel permissions",
30664 - "description": "Updates or creates a permission overwrite for a role (type `0`) or member (type `1`) specified by `overwrite_id` within an existing Discord channel (`channel_id`), using `allow` and `deny` bitwise values to precisely control permissions."
30965 + "description": "Updates or creates a permission overwrite for a role (type 0) or member (type 1) within a Discord channel using allow and deny bitwise values. Requires MANAGE_ROLES permission."
30966 },
30967 {
30968 "slug": "DISCORDBOT_SYNC_GUILD_TEMPLATE",
30668 - "name": "Update guild template by code",
30669 - "description": "Synchronizes a guild template (by `code`) with its source guild (`guild_id`), updating it to match the source's current configuration; this does not affect guilds already created from this template."
30969 + "name": "Sync guild template",
30970 + "description": "Synchronizes a guild template with its source guild, updating it to match the source's current configuration; does not affect guilds already created from this template."
30971 },
30972 {
30973 "slug": "DISCORDBOT_TEST_AUTH",
@@ -30676,52 +30977,52 @@
30977 {
30978 "slug": "DISCORDBOT_TRIGGER_TYPING_INDICATOR",
30979 "name": "Trigger typing indicator",
30679 - "description": "Shows the bot is 'typing' in a Discord channel, typically before sending a message; indicator stops after 10 seconds or upon message send, so use when actively preparing a response."
30980 + "description": "Shows the bot is typing in a Discord channel. The indicator stops after 10 seconds or upon message send. Use when actively preparing a response."
30981 },
30982 {
30983 "slug": "DISCORDBOT_UNBAN_USER_FROM_GUILD",
30683 - "name": "Remove guild ban",
30684 - "description": "Revokes a ban for a user from a Discord guild, allowing them to rejoin if they choose. Requires BAN_MEMBERS permission."
30984 + "name": "Unban user from guild",
30985 + "description": "Revokes a ban for a user from a Discord guild, allowing them to rejoin. Requires BAN_MEMBERS permission."
30986 },
30987 {
30988 "slug": "DISCORDBOT_UNPIN_MESSAGE",
30688 - "name": "Unpin message from channel",
30689 - "description": "Unpins a message that is currently pinned in a specified Discord channel; the message itself is not deleted, only removed from the pinned messages list."
30989 + "name": "Unpin Message",
30990 + "description": "Unpins a message from a Discord channel. The message is not deleted, only removed from the pinned list. Requires MANAGE_MESSAGES permission."
30991 },
30992 {
30993 "slug": "DISCORDBOT_UPDATE_APPLICATION",
30693 - "name": "Modify application by id",
30694 - "description": "Updates a Discord application's settings using its `application_id`; `max_participants` requires the `APPLICATION_EMBEDDED_ACTIVITIES` flag, and `team_id`, `type`, or `install_params` must be `null` if specified."
30994 + "name": "Update application",
30995 + "description": "Updates a Discord application's settings using its application_id."
30996 },
30997 {
30998 "slug": "DISCORDBOT_UPDATE_APPLICATION_COMMAND",
30698 - "name": "Patch command for application",
30699 - "description": "Updates specified properties of a Discord application command (e.g., name, description); omitted properties remain unchanged, and the `options` field, if provided, overwrites all existing options."
30999 + "name": "Update global application command",
31000 + "description": "Updates properties of a global application command. Omitted properties remain unchanged. The options field, if provided, overwrites all existing options."
31001 },
31002 {
31003 "slug": "DISCORDBOT_UPDATE_APPLICATION_USER_ROLE_CONNECTION",
31004 "name": "Update user application role connection",
30704 - "description": "Updates the current user's application role connection metadata for Discord's Linked Roles feature. This endpoint requires OAuth2 authentication with the 'role_connections.write' scope - it cannot be used with a Bot token. The application must have role connection metadata configured before users can update their connection data. Use case: Update user metadata (e.g., subscription tier, account level) that Discord servers can use as requirements for linked roles."
31005 + "description": "Updates the current user's application role connection metadata for Discord's Linked Roles feature. Requires OAuth2 with the role_connections.write scope."
31006 },
31007 {
31008 "slug": "DISCORDBOT_UPDATE_AUTO_MODERATION_RULE",
30708 - "name": "Modify guild auto moderation rule",
30709 - "description": "Updates an existing auto-moderation rule, identified by `guild_id` and `rule_id` in the path, with new values for rule properties (e.g., `name`, `event_type`) provided in the request body. All body parameters are optional - only include the fields you want to update."
31009 + "name": "Update auto moderation rule",
31010 + "description": "Updates an existing auto moderation rule in a Discord guild. Only fields provided in the request body are changed. Requires MANAGE_GUILD permission."
31011 },
31012 {
31013 "slug": "DISCORDBOT_UPDATE_CHANNEL",
31014 "name": "Update channel settings",
30714 - "description": "Updates a Discord channel's settings (name, topic, permissions, etc.). Requires MANAGE_CHANNELS permission. All body parameters are optional - only include fields you want to change. Different parameters apply to different channel types (text, voice, forum, etc.). Fires a Channel Update event on success."
31015 + "description": "Updates a Discord channel's settings (name, topic, permissions, etc.). Requires MANAGE_CHANNELS permission. All body parameters are optional -- only include fields you want to change."
31016 },
31017 {
31018 "slug": "DISCORDBOT_UPDATE_GUILD",
31019 "name": "Update guild settings",
30719 - "description": "Updates settings for a Discord guild (server), such as name, region, icon, verification level, and notification settings. Requires the MANAGE_GUILD permission. Transferring ownership requires being the current owner. Managing features or certain visual elements (e.g., banners, splashes) may require specific guild features like 'COMMUNITY' or 'VIP'. All parameters are optional - only include the settings you want to change."
31020 + "description": "Updates settings for a Discord guild (server). Requires the MANAGE_GUILD permission. All parameters except guild_id are optional -- only include the settings you want to change."
31021 },
31022 {
31023 "slug": "DISCORDBOT_UPDATE_GUILD_APPLICATION_COMMAND",
30723 - "name": "Update application guild command",
30724 - "description": "Updates a specific Discord application command's properties (like name, description, options, or permissions) within a given guild; `application_id`, `guild_id`, and `command_id` must refer to valid entities."
31024 + "name": "Update guild application command",
31025 + "description": "Updates properties of a guild-specific application command. Omitted properties remain unchanged."
31026 },
31027 {
31028 "slug": "DISCORDBOT_UPDATE_GUILD_EMOJI",
@@ -30731,87 +31032,87 @@
31032 {
31033 "slug": "DISCORDBOT_UPDATE_GUILD_MEMBER",
31034 "name": "Modify guild member details",
30734 - "description": "Updates a guild member's attributes including nickname, roles, voice state (mute/deaf/channel), timeout status, and flags. All parameters are optional - only provided fields will be updated. Returns the updated guild member object on success. Requires appropriate permissions for each operation (e.g., MANAGE_NICKNAMES, MANAGE_ROLES, MUTE_MEMBERS, DEAFEN_MEMBERS, MODERATE_MEMBERS)."
31035 + "description": "Updates a guild member's attributes including nickname, roles, voice state, timeout status, and flags. Only provided fields will be updated. Requires appropriate permissions for each operation."
31036 },
31037 {
31038 "slug": "DISCORDBOT_UPDATE_GUILD_ROLE",
31039 "name": "Modify guild role",
30739 - "description": "Updates a Discord guild role's attributes (name, permissions, color, etc.); requires `MANAGE_ROLES` permission, and the `ROLE_ICONS` guild feature if using `unicode_emoji`; unspecified attributes remain unchanged."
31040 + "description": "Updates a Discord guild role's attributes (name, permissions, color, etc.). Requires MANAGE_ROLES permission. Unspecified attributes remain unchanged. The icon and unicode_emoji fields are mutually exclusive."
31041 },
31042 {
31043 "slug": "DISCORDBOT_UPDATE_GUILD_SCHEDULED_EVENT",
31044 "name": "Update guild scheduled event",
30744 - "description": "Updates attributes such as name, description, schedule, status, or location for an existing Discord guild event; only fields in the request body are changed."
31045 + "description": "Updates an existing scheduled event in a Discord guild. Only fields provided in the request body are changed. Supports updating name, description, schedule, status, location, and other event attributes."
31046 },
31047 {
31048 "slug": "DISCORDBOT_UPDATE_GUILD_STICKER",
31049 "name": "Update guild sticker info",
30749 - "description": "Modifies a guild sticker's name, description, or tags. Requires MANAGE_EXPRESSIONS permission (or CREATE_EXPRESSIONS for stickers created by the current user)."
31050 + "description": "Modifies a guild sticker's name, description, or tags. Requires MANAGE_EXPRESSIONS permission."
31051 },
31052 {
31053 "slug": "DISCORDBOT_UPDATE_GUILD_TEMPLATE",
30753 - "name": "Patch guild template information",
30754 - "description": "Updates a Discord guild template's `name` and/or `description` given its `guild_id` and template `code`; omitted fields retain current values, and an empty string for `description` clears it."
31054 + "name": "Update guild template",
31055 + "description": "Updates a Discord guild template's name and/or description; omitted fields retain current values, and an empty string for description clears it."
31056 },
31057 {
31058 "slug": "DISCORDBOT_UPDATE_GUILD_WELCOME_SCREEN",
31059 "name": "Update guild welcome screen",
30759 - "description": "Updates a guild's welcome screen configuration, including description, enabled status, and up to 5 welcome channels. Requires MANAGE_GUILD permission and the guild must have the COMMUNITY feature enabled. All parameters are optional - you can update individual fields without providing all values. When specifying channel emojis, use `emoji_name` (unicode emoji like '👋' or custom emoji name) while `emoji_id` must be `null` if sent."
31060 + "description": "Updates a guild's welcome screen configuration, including description, enabled status, and up to 5 welcome channels. Requires MANAGE_GUILD permission and the COMMUNITY feature."
31061 },
31062 {
31063 "slug": "DISCORDBOT_UPDATE_GUILD_WIDGET_SETTINGS",
30763 - "name": "Update Guild Widget Settings",
30764 - "description": "Updates an existing Discord guild's widget settings, such as its enabled state or invite channel. Requires MANAGE_GUILD permission. Widget settings control the public widget that can be embedded on external websites to show server information."
31064 + "name": "Update guild widget settings",
31065 + "description": "Updates a Discord guild's widget settings, such as its enabled state or invite channel. Requires MANAGE_GUILD permission."
31066 },
31067 {
31068 "slug": "DISCORDBOT_UPDATE_MESSAGE",
30768 - "name": "Update channel message",
30769 - "description": "Updates a message previously sent by the bot in a Discord channel, by modifying its content, embeds, components, flags, or attachment metadata (new attachments cannot be uploaded); only provide fields to change, using null or an empty list to clear existing values."
31069 + "name": "Edit Message",
31070 + "description": "Edits a message previously sent by the bot. Only provide fields you want to change; use null or empty list to clear values."
31071 },
31072 {
31073 "slug": "DISCORDBOT_UPDATE_MY_APPLICATION",
30773 - "name": "Update application description",
30774 - "description": "Modifies settings for the current authenticated Discord application (e.g., description, icon, interaction URLs); setting `team_id` to `null` (None) transfers team ownership, while `null` (None) for `type` or `install_params` clears/resets them."
31074 + "name": "Update my application",
31075 + "description": "Updates settings for the current authenticated Discord application via /applications/@me."
31076 },
31077 {
31078 "slug": "DISCORDBOT_UPDATE_MY_GUILD_MEMBER",
31079 "name": "Update bot's nickname in guild",
30779 - "description": "Modifies the current bot's member profile (nickname) in a Discord guild. This endpoint allows the bot to change its own nickname in the specified guild. The bot must be a member of the guild to use this endpoint."
31080 + "description": "Modifies the current bot's member profile (nickname) in a Discord guild. The bot must be a member of the guild and have CHANGE_NICKNAME permission."
31081 },
31082 {
31083 "slug": "DISCORDBOT_UPDATE_MY_USER",
31084 "name": "Update current bot user profile",
30784 - "description": "Updates the current bot user's Discord username and/or avatar. This endpoint only works with bot tokens, not OAuth2 user tokens. At least one field (username or avatar) must be provided to update the profile. Username changes are rate-limited to 2 per hour per account."
31085 + "description": "Updates the current bot user's Discord username and/or avatar. Only works with bot tokens. Username changes are rate-limited to 2 per hour."
31086 },
31087 {
31088 "slug": "DISCORDBOT_UPDATE_ORIGINAL_WEBHOOK_MESSAGE",
30788 - "name": "Patch webhook original message",
30789 - "description": "Updates the original editable message previously sent by a webhook, allowing partial modification of its content (max 2000 chars), embeds (max 10), attachments (kept by `id`, metadata updatable), components, allowed mentions, and flags."
31089 + "name": "Update original webhook message",
31090 + "description": "Updates the original (@original) message previously sent by a webhook or interaction response."
31091 },
31092 {
31093 "slug": "DISCORDBOT_UPDATE_SELF_VOICE_STATE",
30793 - "name": "Modify guild voice state for me",
30794 - "description": "Updates the bot's voice state in a guild Stage channel (e.g., suppress/unsuppress audio, request to speak). Requires the bot to already be connected to a stage channel via Gateway API. Cannot be used to join, switch, or disconnect from voice channels."
31094 + "name": "Update own voice state",
31095 + "description": "Updates the bot's own voice state in a guild Stage channel, such as toggling suppress or requesting to speak. The bot must already be connected to a stage channel via the Gateway API."
31096 },
31097 {
31098 "slug": "DISCORDBOT_UPDATE_VOICE_STATE",
30798 - "name": "Patch guild voice state",
30799 - "description": "Updates another user's voice state in a Discord stage channel. IMPORTANT: This endpoint ONLY works for stage channels (not regular voice channels). Primary use is toggling the 'suppress' state to control speaking permissions. Requires the user to already be in the specified stage channel and the bot must have MUTE_MEMBERS permission. Returns 204 No Content on success."
31099 + "name": "Update user voice state",
31100 + "description": "Updates another user's voice state in a Discord stage channel. Only works for stage channels, not regular voice channels. Primarily used to toggle suppress state for speaking permissions. Requires MUTE_MEMBERS permission."
31101 },
31102 {
31103 "slug": "DISCORDBOT_UPDATE_WEBHOOK",
30803 - "name": "Update webhook details patch",
30804 - "description": "Updates properties (e.g., name, avatar, channel ID) of an existing Discord webhook; the webhook and any new channel (if specified) must exist, with the new channel being in the same server."
31104 + "name": "Update webhook details",
31105 + "description": "Updates properties of an existing Discord webhook such as name, avatar, or channel."
31106 },
31107 {
31108 "slug": "DISCORDBOT_UPDATE_WEBHOOK_BY_TOKEN",
30808 - "name": "Update webhook name and avatar",
30809 - "description": "Updates the default name and/or avatar for an existing Discord webhook, using its ID and token."
31109 + "name": "Update webhook by token",
31110 + "description": "Updates a Discord webhook's name and/or avatar using its ID and token, without bot authentication."
31111 },
31112 {
31113 "slug": "DISCORDBOT_UPDATE_WEBHOOK_MESSAGE",
30813 - "name": "Update discord message with webhook",
30814 - "description": "Updates a message previously sent by the *same* webhook, allowing partial modification of content, embeds, attachments, or components; will not edit user/bot messages."
31114 + "name": "Update webhook message",
31115 + "description": "Updates a message previously sent by a webhook, allowing modification of content, embeds, attachments, or components."
31116 }
31117 ],
31118 "triggers": [],
@@ -30897,7 +31198,7 @@
31198 ],
31199 "toolCount": 216,
31200 "triggerCount": 7,
30900 - "version": "20260417_00",
31201 + "version": "20260501_00",
31202 "tools": [
31203 {
31204 "slug": "SALESFORCE_ACCOUNT_CREATION_WITH_CONTENT_TYPE_OPTION",
@@ -32074,9 +32375,9 @@
32375 "name": "suffix.one",
32376 "displayName": "Instance endpoint",
32377 "type": "string",
32077 - "description": "The service endpoint for your Salesforce instance eg /services/data/v61.0, used for API requests.",
32378 + "description": "The service endpoint for your Salesforce instance eg /services/data/v62.0, used for API requests.",
32379 "required": true,
32079 - "default": "/services/data/v61.0"
32380 + "default": "/services/data/v62.0"
32381 }
32382 ],
32383 "optional": []
@@ -32122,9 +32423,9 @@
32423 "name": "suffix.one",
32424 "displayName": "Instance endpoint",
32425 "type": "string",
32125 - "description": "The service endpoint for your Salesforce instance e.g. /services/data/v61.0",
32426 + "description": "The service endpoint for your Salesforce instance e.g. /services/data/v62.0",
32427 "required": true,
32127 - "default": "/services/data/v61.0"
32428 + "default": "/services/data/v62.0"
32429 }
32430 ],
32431 "optional": []
@@ -32147,7 +32448,7 @@
32448 ],
32449 "toolCount": 55,
32450 "triggerCount": 0,
32150 - "version": "20260414_00",
32451 + "version": "20260429_00",
32452 "tools": [
32453 {
32454 "slug": "CALENDLY_CANCEL_SCHEDULED_EVENT",
@@ -32491,7 +32792,7 @@
32792 ],
32793 "toolCount": 329,
32794 "triggerCount": 5,
32494 - "version": "20260414_00",
32795 + "version": "20260429_00",
32796 "tools": [
32797 {
32798 "slug": "TRELLO_ADD_BOARDS",
@@ -34228,7 +34529,7 @@
34529 ],
34530 "toolCount": 48,
34531 "triggerCount": 0,
34231 - "version": "20260414_00",
34532 + "version": "20260429_00",
34533 "tools": [
34534 {
34535 "slug": "APOLLO_ADD_CONTACTS_TO_SEQUENCE",
@@ -34735,7 +35036,7 @@
35036 ],
35037 "toolCount": 47,
35038 "triggerCount": 0,
34738 - "version": "20260414_00",
35039 + "version": "20260429_00",
35040 "tools": [
35041 {
35042 "slug": "MEM0_ADD_MEMBER_TO_PROJECT",
@@ -35011,7 +35312,7 @@
35312 ],
35313 "toolCount": 110,
35314 "triggerCount": 0,
35014 - "version": "20260414_00",
35315 + "version": "20260429_00",
35316 "tools": [
35317 {
35318 "slug": "NEON_ACCEPT_PROJECTS_TRANSFER_REQUESTS",
@@ -35602,7 +35903,7 @@
35903 ],
35904 "toolCount": 2,
35905 "triggerCount": 0,
35605 - "version": "20260407_00",
35906 + "version": "20260424_00",
35907 "tools": [
35908 {
35909 "slug": "WEATHERMAP_GEOCODE_LOCATION",
@@ -35644,7 +35945,7 @@
35945 ],
35946 "toolCount": 506,
35947 "triggerCount": 0,
35647 - "version": "20260417_00",
35948 + "version": "20260506_00",
35949 "tools": [
35950 {
35951 "slug": "POSTHOG_ADD_DASHBOARD_COLLABORATORS_WITH_ACCESS_LEVEL",
@@ -38226,9 +38527,9 @@
38527 "composioManagedAuthSchemes": [
38528 "OAUTH2"
38529 ],
38229 - "toolCount": 163,
38530 + "toolCount": 164,
38531 "triggerCount": 0,
38231 - "version": "20260414_00",
38532 + "version": "20260506_00",
38533 "tools": [
38534 {
38535 "slug": "CLICKUP_ADD_DEPENDENCY",
@@ -38560,6 +38861,11 @@
38861 "name": "Get all tags from time entries",
38862 "description": "Retrieves all unique tags applied to time entries within a specified ClickUp Team (Workspace)."
38863 },
38864 + {
38865 + "slug": "CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES",
38866 + "name": "Get authorized teams workspaces",
38867 + "description": "Retrieves a list of Workspaces (Teams) the authenticated user can access."
38868 + },
38869 {
38870 "slug": "CLICKUP_GET_AUTHORIZED_USER",
38871 "name": "Get authorized user",
@@ -39133,7 +39439,7 @@
39439 ],
39440 "toolCount": 21,
39441 "triggerCount": 0,
39136 - "version": "20260414_00",
39442 + "version": "20260424_00",
39443 "tools": [
39444 {
39445 "slug": "BREVO_CREATE_A_COMPANY",
@@ -39331,7 +39637,7 @@
39637 ],
39638 "toolCount": 422,
39639 "triggerCount": 7,
39334 - "version": "20260414_00",
39640 + "version": "20260430_00",
39641 "tools": [
39642 {
39643 "slug": "STRIPE_ACCEPT_QUOTE",
@@ -41567,7 +41873,7 @@
41873 ],
41874 "toolCount": 225,
41875 "triggerCount": 0,
41570 - "version": "20260414_00",
41876 + "version": "20260506_01",
41877 "tools": [
41878 {
41879 "slug": "KLAVIYO_ADD_PROFILE_TO_LIST",
@@ -42781,7 +43087,7 @@
43087 ],
43088 "toolCount": 19,
43089 "triggerCount": 0,
42784 - "version": "20260414_00",
43090 + "version": "20260429_00",
43091 "tools": [
43092 {
43093 "slug": "BROWSERBASE_TOOL_CONTEXTS_CREATE",
@@ -42920,7 +43226,7 @@
43226 ],
43227 "toolCount": 275,
43228 "triggerCount": 4,
42923 - "version": "20260414_00",
43229 + "version": "20260429_00",
43230 "tools": [
43231 {
43232 "slug": "MAILCHIMP_ADD_AUTOMATION",
@@ -44394,7 +44700,7 @@
44700 ],
44701 "toolCount": 108,
44702 "triggerCount": 0,
44397 - "version": "20260414_00",
44703 + "version": "20260504_00",
44704 "tools": [
44705 {
44706 "slug": "ATTIO_ASSERT_COMPANY",
@@ -45003,7 +45309,7 @@
45309 ],
45310 "toolCount": 15,
45311 "triggerCount": 0,
45006 - "version": "20260417_00",
45312 + "version": "20260429_00",
45313 "tools": [
45314 {
45315 "slug": "GOOGLEMEET_CREATE_MEET",
@@ -45144,7 +45450,7 @@
45450 ],
45451 "toolCount": 6,
45452 "triggerCount": 0,
45147 - "version": "20260414_00",
45453 + "version": "20260424_00",
45454 "tools": [
45455 {
45456 "slug": "TEXT_TO_PDF_CONVERT_TEXT_TO_PDF",
@@ -45209,7 +45515,7 @@
45515 ],
45516 "toolCount": 14,
45517 "triggerCount": 0,
45212 - "version": "20260417_00",
45518 + "version": "20260501_00",
45519 "tools": [
45520 {
45521 "slug": "ZOHO_CONVERT_ZOHO_LEAD",
@@ -45509,7 +45815,7 @@
45815 ],
45816 "toolCount": 177,
45817 "triggerCount": 0,
45512 - "version": "20260417_00",
45818 + "version": "20260429_00",
45819 "tools": [
45820 {
45821 "slug": "DROPBOX_ACTIVATE_TEAM_FOLDER",
@@ -46460,7 +46766,7 @@
46766 ],
46767 "toolCount": 142,
46768 "triggerCount": 0,
46463 - "version": "20260414_00",
46769 + "version": "20260429_00",
46770 "tools": [
46771 {
46772 "slug": "SHORTCUT_CREATE_CATEGORY",
@@ -47216,7 +47522,7 @@
47522 ],
47523 "toolCount": 62,
47524 "triggerCount": 20,
47219 - "version": "20260417_00",
47525 + "version": "20260429_00",
47526 "tools": [
47527 {
47528 "slug": "CONFLUENCE_ADD_CONTENT_LABEL",
@@ -47782,7 +48088,7 @@
48088 ],
48089 "toolCount": 178,
48090 "triggerCount": 0,
47785 - "version": "20260414_00",
48091 + "version": "20260506_00",
48092 "tools": [
48093 {
48094 "slug": "FRESHDESK_ADD_NOTE_TO_TICKET",
@@ -48722,7 +49028,7 @@
49028 ],
49029 "toolCount": 153,
49030 "triggerCount": 0,
48725 - "version": "20260414_00",
49031 + "version": "20260429_00",
49032 "tools": [
49033 {
49034 "slug": "BORNEO_ACCESS_SCAN_ITERATION_BY_ID",
@@ -49601,7 +49907,7 @@
49907 ],
49908 "toolCount": 50,
49909 "triggerCount": 0,
49604 - "version": "20260414_00",
49910 + "version": "20260430_00",
49911 "tools": [
49912 {
49913 "slug": "MIXPANEL_ADD_UNIQUE_TO_PROFILE_LIST_PROPERTY",
@@ -49909,7 +50215,7 @@
50215 ],
50216 "toolCount": 110,
50217 "triggerCount": 4,
49912 - "version": "20260414_00",
50218 + "version": "20260506_00",
50219 "tools": [
50220 {
50221 "slug": "CODA_ADD_A_CATEGORY_FOR_PACK",
@@ -50521,7 +50827,7 @@
50827 ],
50828 "toolCount": 8,
50829 "triggerCount": 0,
50524 - "version": "20260414_00",
50830 + "version": "20260424_00",
50831 "tools": [
50832 {
50833 "slug": "ACCULYNX_ADD_JOB_APPOINTMENT",
@@ -50602,7 +50908,7 @@
50908 ],
50909 "toolCount": 40,
50910 "triggerCount": 0,
50605 - "version": "20260407_00",
50911 + "version": "20260424_00",
50912 "tools": [
50913 {
50914 "slug": "AHREFS_BACKLINKS_STATS_RETRIEVAL",
@@ -50843,7 +51149,7 @@
51149 ],
51150 "toolCount": 20,
51151 "triggerCount": 0,
50846 - "version": "20260407_00",
51152 + "version": "20260424_00",
51153 "tools": [
51154 {
51155 "slug": "AFFINITY_GET_A_COMPANY_S_LIST_ENTRIES",
@@ -50984,7 +51290,7 @@
51290 ],
51291 "toolCount": 54,
51292 "triggerCount": 0,
50987 - "version": "20260414_00",
51293 + "version": "20260506_00",
51294 "tools": [
51295 {
51296 "slug": "AMPLITUDE_ASSIGN_ANNOTATIONS_TO_CATEGORY",
@@ -51311,7 +51617,7 @@
51617 ],
51618 "toolCount": 71,
51619 "triggerCount": 0,
51314 - "version": "20260414_00",
51620 + "version": "20260506_00",
51621 "tools": [
51622 {
51623 "slug": "HEYGEN_ADD_LOOKS_TO_PHOTO_AVATAR_GROUP",
@@ -51708,7 +52014,7 @@
52014 ],
52015 "toolCount": 99,
52016 "triggerCount": 0,
51711 - "version": "20260414_00",
52017 + "version": "20260429_00",
52018 "tools": [
52019 {
52020 "slug": "AGENCYZOOM_AUTHENTICATE_FOR_JWTVIA_V4_SSO",
@@ -52279,7 +52585,7 @@
52585 ],
52586 "toolCount": 63,
52587 "triggerCount": 0,
52282 - "version": "20260417_00",
52588 + "version": "20260429_00",
52589 "tools": [
52590 {
52591 "slug": "GOOGLEBIGQUERY_CANCEL_JOB",
@@ -52723,13 +53029,13 @@
53029 "name": "Coinbase",
53030 "logo": "https://logos.composio.dev/api/coinbase",
53031 "description": "Coinbase is a platform for buying, selling, transferring, and storing cryptocurrency.",
52726 - "category": "payment processing",
53032 + "category": "developer tools",
53033 "authSchemes": [
53034 "API_KEY"
53035 ],
53036 "toolCount": 28,
53037 "triggerCount": 0,
52732 - "version": "20260410_00",
53038 + "version": "20260506_00",
53039 "tools": [
53040 {
53041 "slug": "COINBASE_GET_ASSET_DETAILS",
@@ -52921,7 +53227,7 @@
53227 ],
53228 "toolCount": 125,
53229 "triggerCount": 0,
52924 - "version": "20260414_00",
53230 + "version": "20260429_00",
53231 "tools": [
53232 {
53233 "slug": "MONDAY_ACCOUNT_TRIGGER_STATISTICS",
@@ -53758,7 +54064,7 @@
54064 ],
54065 "toolCount": 364,
54066 "triggerCount": 0,
53761 - "version": "20260414_00",
54067 + "version": "20260429_00",
54068 "tools": [
54069 {
54070 "slug": "SENDGRID_ACTIVATE_TEMPLATE_VERSION",
@@ -55699,7 +56005,7 @@
56005 ],
56006 "toolCount": 401,
56007 "triggerCount": 3,
55702 - "version": "20260415_00",
56008 + "version": "20260506_00",
56009 "tools": [
56010 {
56011 "slug": "PIPEDRIVE_ADD_ACTIVITY_TYPE",
@@ -57827,7 +58133,7 @@
58133 ],
58134 "toolCount": 41,
58135 "triggerCount": 0,
57830 - "version": "20260413_00",
58136 + "version": "20260429_00",
58137 "tools": [
58138 {
58139 "slug": "BAMBOOHR_ATS_CREATE_CANDIDATE",
@@ -58142,7 +58448,7 @@
58448 ],
58449 "toolCount": 17,
58450 "triggerCount": 1,
58145 - "version": "20260414_00",
58451 + "version": "20260424_00",
58452 "tools": [
58453 {
58454 "slug": "WHATSAPP_CREATE_MESSAGE_TEMPLATE",
@@ -58498,35 +58804,615 @@
58804 "composioManagedAuthSchemes": [
58805 "OAUTH2"
58806 ],
58501 - "toolCount": 20,
58807 + "toolCount": 452,
58808 "triggerCount": 2,
58503 - "version": "20260414_00",
58809 + "version": "20260429_01",
58810 "tools": [
58811 + {
58812 + "slug": "ZENDESK_APPLY_ZENDESK_MACRO",
58813 + "name": "Apply Zendesk Macro Preview",
58814 + "description": "Preview how a Zendesk macro would affect a ticket without actually applying it. Returns the ticket object as it would appear after the macro is applied, showing any changes to fields, comments, status, or other properties. Use this action to review macro changes before applying them to ensure the outcome is as expected."
58815 + },
58816 + {
58817 + "slug": "ZENDESK_AUTOCOMPLETE_PROBLEMS",
58818 + "name": "Autocomplete Problems",
58819 + "description": "Autocomplete problems in Zendesk. Use when you need to find problem suggestions based on a partial search text for ticket categorization or troubleshooting."
58820 + },
58821 + {
58822 + "slug": "ZENDESK_AUTOCOMPLETE_USERS",
58823 + "name": "Autocomplete Users",
58824 + "description": "Search for Zendesk users by name prefix using the POST /api/v2/users/autocomplete endpoint. Returns an array of users whose name starts with the provided query. Use when you need to find users by name prefix for quick user lookup and autocomplete functionality."
58825 + },
58826 + {
58827 + "slug": "ZENDESK_CHECK_HOST_MAPPING_VALIDITY_FOR_EXISTING_BRAND",
58828 + "name": "Check Host Mapping Validity for Existing Brand",
58829 + "description": "Check the host mapping validity for an existing brand in Zendesk. Returns the current CNAME record, expected CNAME values, validity status, and the reason for validity or invalidity. Use this action when you need to verify that DNS records are correctly configured for an existing brand that has already been created in Zendesk. This action requires a brand ID rather than subdomain/host_mapping parameters."
58830 + },
58831 + {
58832 + "slug": "ZENDESK_COUNT_DELETED_USERS",
58833 + "name": "Count Deleted Users",
58834 + "description": "Count deleted users in Zendesk. Returns the total number of deleted users. Use when you need to know how many users have been deleted for reporting, cleanup, or operational purposes."
58835 + },
58836 + {
58837 + "slug": "ZENDESK_COUNT_USER_CCD_TICKETS",
58838 + "name": "Count User CCD Tickets",
58839 + "description": "Count tickets where the specified user is CCD (carbon copy distribution). Returns an approximate count of tickets where the user appears in the CCD field. Use when you need to know how many tickets a user is copied on for reporting or operational purposes."
58840 + },
58841 + {
58842 + "slug": "ZENDESK_COUNT_ZENDESK_CUSTOM_OBJECT_RECORDS",
58843 + "name": "Count Custom Object Records",
58844 + "description": "Count the number of records in a specific Zendesk custom object. Use when you need to determine the total number of records for a custom object type, which is useful for reporting, capacity planning, or validation before creating new records. This is a read-only, idempotent operation. Example use cases: - Check if a custom object has records before deleting - Get record count for reporting dashboards - Verify capacity before bulk operations"
58845 + },
58846 {
58847 "slug": "ZENDESK_COUNT_ZENDESK_ORGANIZATIONS",
58848 "name": "Count Zendesk Organizations",
58508 - "description": "Count the number of organizations in Zendesk. Returns a single numeric total only — no names, IDs, or custom fields. Use ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS for per-organization detail."
58849 + "description": "Count the number of organizations in Zendesk. Returns an approximate count of organizations with the timestamp of when the count was last calculated. This is a read-only, idempotent operation. Use when you need to know the total number of organizations for reporting, capacity planning, or operational purposes. For detailed per-organization information, use ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS instead."
58850 + },
58851 + {
58852 + "slug": "ZENDESK_CREATE_ACCESS_RULE",
58853 + "name": "Create Access Rule",
58854 + "description": "Create an access rule for a custom object in Zendesk. Access rules control which users can view or modify custom object records based on conditions. Use when you need to set up data access policies for custom objects, such as limiting access to records created by the current user or records assigned to specific groups. Returns the created access rule with its ID, title, description, conditions, and timestamps."
58855 + },
58856 + {
58857 + "slug": "ZENDESK_CREATE_APPS_INSTALLATION",
58858 + "name": "Install Zendesk App",
58859 + "description": "Install a Zendesk app in the account. Use when you need to add an app from the Zendesk marketplace or a private app to your Zendesk instance. You must provide the app_id and settings. This action is irreversible once installed."
58860 + },
58861 + {
58862 + "slug": "ZENDESK_CREATE_APPS_NOTIFY",
58863 + "name": "Send Notification to App",
58864 + "description": "Send a notification to currently open instances of a Zendesk app. Use when you need to push real-time notifications or data to a Zendesk app that is currently open in an agent's interface. The notification triggers an event in the app, which can then respond with custom behavior (e.g., display a popup, update UI, trigger a workflow). Only works with apps that are currently open in the Zendesk interface."
58865 + },
58866 + {
58867 + "slug": "ZENDESK_CREATE_AUTOCOMPLETE_TAGS",
58868 + "name": "Create Autocomplete Tags",
58869 + "description": "Search for Zendesk tags using autocomplete via POST request body. Use when you need to find tag suggestions based on a partial tag name for tagging tickets or organizing content."
58870 + },
58871 + {
58872 + "slug": "ZENDESK_CREATE_AUTOMATION",
58873 + "name": "Create Automation",
58874 + "description": "Create a new automation in Zendesk. Automations are business rules that automatically perform actions on tickets when certain conditions are met. Automations run server-side and don't require user interaction. Use this action when you need to: - Automatically assign tickets based on conditions - Change ticket priority/status based on rules - Add tags to tickets matching certain criteria - Notify agents or teams based on ticket properties - Implement escalation workflows Note: Automations must have at least one condition that is time-based (like created_at, updated_at) OR check one of: status, type, group_id, assignee_id, or requester_id."
58875 + },
58876 + {
58877 + "slug": "ZENDESK_CREATE_BOOKMARK",
58878 + "name": "Create Bookmark",
58879 + "description": "Create a bookmark for a ticket in Zendesk. Bookmarks allow you to save references to tickets for quick access. Use this action when you need to: - Save a ticket for later reference - Mark an important ticket for quick access - Create a watchlist-like functionality for specific tickets"
58880 + },
58881 + {
58882 + "slug": "ZENDESK_CREATE_COMMENT_REDACTION",
58883 + "name": "Redact Zendesk Comment",
58884 + "description": "Redact sensitive content from a ticket comment in Zendesk using the Agent Workspace method. Use when you need to permanently remove or hide sensitive information such as personal data, credentials, or inappropriate content from ticket comments. This action is irreversible — redacted content cannot be recovered once removed. Note: Requires Agent Workspace to be enabled and (for Enterprise accounts) agents need a custom role with redaction permissions. Closed tickets cannot have comments redacted."
58885 + },
58886 + {
58887 + "slug": "ZENDESK_CREATE_CUSTOM_OBJECT_BULK_JOB",
58888 + "name": "Create Custom Object Bulk Job",
58889 + "description": "Create a bulk job to perform batch operations (create, update, delete, upsert) on custom object records in Zendesk. Use when you need to process multiple records of a custom object type efficiently in a single API call. Returns a job ID for tracking the operation progress via GET /api/v2/custom_objects/{custom_object_key}/jobs/{job_id}."
58890 + },
58891 + {
58892 + "slug": "ZENDESK_CREATE_CUSTOM_OBJECT_RECORD",
58893 + "name": "Create Custom Object Record",
58894 + "description": "Create a new record for a custom object in Zendesk. Use when you need to add a new entry to a custom object type. The record is identified by its unique ID returned in the response. This action creates a new custom object record and returns the complete record data including the generated ID and timestamps."
58895 + },
58896 + {
58897 + "slug": "ZENDESK_CREATE_CUSTOM_OBJECT_RECORD_ATTACHMENT",
58898 + "name": "Create Custom Object Record Attachment",
58899 + "description": "Create an attachment for a custom object record in Zendesk. Use when you need to attach files (documents, images, etc.) to a custom object record. The file is uploaded as a multipart/form-data request. The response includes the attachment details and malware scan status."
58900 + },
58901 + {
58902 + "slug": "ZENDESK_CREATE_CUSTOM_STATUSES",
58903 + "name": "Create Custom Ticket Status",
58904 + "description": "Create a new custom ticket status in Zendesk. Custom statuses allow agents to define more granular ticket states beyond the default status categories. Use when you need to add custom ticket workflow states to better reflect your support process. Both `agent_label`, `status_category`, `end_user_label`, and `description` are required. The status category determines which lifecycle phase the custom status belongs to."
58905 + },
58906 + {
58907 + "slug": "ZENDESK_CREATE_DELETION_SCHEDULE",
58908 + "name": "Create Deletion Schedule",
58909 + "description": "Create a new deletion schedule in Zendesk that automatically deletes records matching specified conditions on a schedule. Deletion schedules are used for data retention and cleanup policies. Use this action when you need to: - Automatically clean up old closed tickets - Remove inactive users or attachments - Enforce data retention policies - Schedule periodic deletion of bot conversations Note: The 'object' field (entity type to delete) cannot be modified after creation. Use conditions to specify which records to delete - for time-based deletion, use 'duration_since_last_update' field with 'greater_than' operator and ISO 8601 duration values (e.g., 'P30D' for 30 days)."
58910 + },
58911 + {
58912 + "slug": "ZENDESK_CREATE_DYNAMIC_CONTENT_ITEMS",
58913 + "name": "Create Zendesk Dynamic Content Item",
58914 + "description": "Create a new dynamic content item with locale variants in Zendesk. Dynamic content items enable localized content for ticket fields, macros, and other text-based content. Use when setting up multilingual support or creating template content that varies by user locale. The item's name cannot be changed after creation. Ensure the name is descriptive and follows your naming conventions."
58915 + },
58916 + {
58917 + "slug": "ZENDESK_CREATE_DYNAMIC_CONTENT_ITEMS_VARIANTS",
58918 + "name": "Create Zendesk Dynamic Content Item Variant",
58919 + "description": "Create a new locale variant for an existing dynamic content item in Zendesk. Use when you need to add support for a new locale to an existing dynamic content item. Note: You can only create one variant per locale per dynamic content item. Use the update action to modify existing variants."
58920 + },
58921 + {
58922 + "slug": "ZENDESK_CREATE_END_USER_IDENTITY",
58923 + "name": "Create End User Identity",
58924 + "description": "Add an identity (email or phone) to an end user's profile in Zendesk. Use when you need to link a new email address or phone number to an existing end user account."
58925 + },
58926 + {
58927 + "slug": "ZENDESK_CREATE_GROUP_MEMBERSHIPS",
58928 + "name": "Create Zendesk Group Membership",
58929 + "description": "Create a group membership in Zendesk, assigning an agent to a group. Use when you need to add an agent to a specific group for ticket routing, permissions, or team organization. The user_id and group_id are both required parameters. Note: The user must exist and have appropriate permissions to be assigned to groups. The group must also exist."
58930 + },
58931 + {
58932 + "slug": "ZENDESK_CREATE_IMPORTS_TICKETS_CREATE_MANY",
58933 + "name": "Bulk Import Tickets",
58934 + "description": "Bulk import tickets into Zendesk by posting up to 100 ticket objects at a time. Use when migrating tickets from another system or creating multiple tickets in a single API call. The operation returns a job_status payload; the initial status is typically 'queued' or 'completed' for small batches. This action is useful for data migration, test data setup, and bulk ticket creation workflows."
58935 + },
58936 + {
58937 + "slug": "ZENDESK_CREATE_MANY_DYNAMIC_CONTENT_ITEMS_VARIANTS",
58938 + "name": "Create Many Dynamic Content Variants",
58939 + "description": "Create many locale variants for an existing dynamic content item in Zendesk. Use when you need to add multiple language variants to a dynamic content item in a single operation. This action is efficient for bulk-adding translations to support multilingual content. This action is idempotent - running it multiple times with the same variants will create duplicate variants if they don't already exist. Consider listing existing variants first to avoid duplicates."
58940 + },
58941 + {
58942 + "slug": "ZENDESK_CREATE_MANY_TICKETS",
58943 + "name": "Create Many Zendesk Tickets",
58944 + "description": "Create many tickets in Zendesk in a single request. Accepts an array of up to 100 ticket objects. The operation is handled asynchronously — a background job is queued and you receive a job_status payload with an initial status of 'queued' or 'working'. Poll the job_status URL or use ZENDESK_GET_APPS_JOB_STATUS to check for completion and view per-ticket results. Use when creating multiple tickets at once or seeding test data. This action is irreversible — tickets created cannot be easily undone once the job completes. Ensure the tickets list is accurate before submitting."
58945 + },
58946 + {
58947 + "slug": "ZENDESK_CREATE_MANY_USERS",
58948 + "name": "Create Many Zendesk Users",
58949 + "description": "Create many users in Zendesk in a single request. Accepts up to 100 user objects. The operation is handled asynchronously — a background job is queued and you receive a job_status payload with an initial status of 'queued' or 'working'. Poll the job_status URL or use ZENDESK_GET_APPS_JOB_STATUS to check for completion and view per-user results. Use when onboarding multiple users at once or seeding test data. Note: This action is idempotent — re-running with the same external_ids may update existing users depending on Zendesk configuration."
58950 + },
58951 + {
58952 + "slug": "ZENDESK_CREATE_OBJECT_TRIGGER",
58953 + "name": "Create Object Trigger",
58954 + "description": "Create a new trigger for a custom object in Zendesk. Custom object triggers are business rules that automatically perform actions when certain conditions are met on custom object records. Use this action when you need to: - Send notifications when custom object records are created or updated - Automatically update fields on custom object records - Add or remove tags based on custom object conditions - Implement automated workflows for custom object data This action is idempotent - creating a trigger with the same name multiple times will result in duplicate triggers unless the name is changed."
58955 + },
58956 + {
58957 + "slug": "ZENDESK_CREATE_ORGANIZATION_FIELD",
58958 + "name": "Create Organization Field",
58959 + "description": "Create a custom organization field in Zendesk. Use when you need to add a new custom field type (such as text, dropdown, checkbox, date, etc.) to track additional organization attributes. The field key must be unique and can only contain letters, numbers, and underscores."
58960 + },
58961 + {
58962 + "slug": "ZENDESK_CREATE_ORGANIZATION_MEMBERSHIPS",
58963 + "name": "Create Organization Membership",
58964 + "description": "Create a new organization membership in Zendesk by assigning a user to an organization. Use when you need to associate a user with an organization so they can access organization-specific tickets and data. Returns a 422 error if the user is already assigned to the organization. This action is idempotent in that creating a duplicate membership will fail with a specific error, but the operation itself is not naturally idempotent."
58965 + },
58966 + {
58967 + "slug": "ZENDESK_CREATE_ORGANIZATION_MEMBERSHIPS_CREATE_MANY",
58968 + "name": "Create Many Organization Memberships",
58969 + "description": "Create multiple organization memberships in Zendesk by posting up to 100 membership objects at a time. Each membership links a user to an organization. Use when onboarding multiple users to organizations in bulk, such as during team migrations or organizational restructuring. The operation returns a job_status payload; the initial status is typically 'queued' for larger batches."
58970 + },
58971 + {
58972 + "slug": "ZENDESK_CREATE_ORGANIZATION_MERGE",
58973 + "name": "Merge Zendesk Organizations",
58974 + "description": "Merge two Zendesk organizations by combining all users, tickets, and data from the losing organization into the winning organization. This action is irreversible — once merged, the losing organization and all its data cannot be recovered. Use when you need to consolidate duplicate organizations or combine organization data into a single organization."
58975 + },
58976 + {
58977 + "slug": "ZENDESK_CREATE_ORGANIZATIONS_TAGS",
58978 + "name": "Set Organization Tags",
58979 + "description": "Set organization tags in Zendesk by making a POST request to replace the tags on an organization. Use when you need to categorize or label organizations with specific tags for filtering and organization purposes. This operation replaces all existing tags on the organization with the new set provided. Note: This action is not idempotent as it replaces existing tags rather than adding to them."
58980 + },
58981 + {
58982 + "slug": "ZENDESK_CREATE_ORGANIZATION_SUBSCRIPTION",
58983 + "name": "Create Organization Subscription",
58984 + "description": "Create an organization subscription in Zendesk. This subscribes a user to receive notifications and updates related to a specific organization. Use when you need to add a user to an organization's subscription list so they can access organization-related resources and receive notifications."
58985 + },
58986 + {
58987 + "slug": "ZENDESK_CREATE_OR_UPDATE_MANY_USERS",
58988 + "name": "Create Or Update Many Users",
58989 + "description": "Create or update multiple users in Zendesk in a single request. Use when you need to batch create or update up to 100 users at once. New users require a 'name' field; existing users are matched by 'id'. Returns a job_status with results for each operation. This action is idempotent — re-running with the same parameters will produce the same results."
58990 + },
58991 + {
58992 + "slug": "ZENDESK_CREATE_OR_UPDATE_ORGANIZATION",
58993 + "name": "Create Or Update Organization",
58994 + "description": "Create or update a Zendesk organization in a single operation. If an organization with the same external_id already exists, it is updated. Otherwise, a new organization is created. Use when you need to ensure an organization exists without checking for duplicates first. Note: For updates, you must specify the external_id to match the existing organization. Name is not available as a matching criteria."
58995 + },
58996 + {
58997 + "slug": "ZENDESK_CREATE_OR_UPDATE_USER",
58998 + "name": "Create or Update User",
58999 + "description": "Create or update a Zendesk user. If a user with the same email or external_id exists, it updates that user. Otherwise, it creates a new user. Use when you need to upsert user records - idempotent based on email or external_id matching. Returns 200 for existing users, 201 for newly created users."
59000 + },
59001 + {
59002 + "slug": "ZENDESK_CREATE_PUSH_NOTIFICATION_DEVICES_DESTROY_MANY",
59003 + "name": "Bulk Unregister Push Notification Devices",
59004 + "description": "Bulk unregister push notification devices in Zendesk. This action is irreversible — the devices will be permanently removed from receiving push notifications and cannot be recovered once removed. Use when cleaning up obsolete device tokens or removing test devices from receiving push notifications."
59005 + },
59006 + {
59007 + "slug": "ZENDESK_CREATE_RESOURCE_COLLECTIONS",
59008 + "name": "Create Resource Collection",
59009 + "description": "Create a resource collection in Zendesk. Use when you need to batch multiple operations on Zendesk resources (like tickets) into a single request. The API processes the collection as a background job and returns a job status object. Note: This action queues a background job. Poll the returned job_status.url to check when the collection has been processed."
59010 + },
59011 + {
59012 + "slug": "ZENDESK_CREATE_SIDE_CONVERSATION",
59013 + "name": "Create Side Conversation",
59014 + "description": "Create a private side conversation on a Zendesk ticket. Side conversations are agent-to-agent communications that don't notify the customer. Use this action when you need to discuss a ticket privately with another agent, escalate to a specialist, or coordinate on sensitive issues without customer visibility. Recipients can include Zendesk users (by ID or email), Slack channels, support groups, or Microsoft Teams channels."
59015 + },
59016 + {
59017 + "slug": "ZENDESK_CREATE_SUPPORT_ADDRESS",
59018 + "name": "Create Support Address",
59019 + "description": "Create a new support address (recipient address) in Zendesk. Use when you need to add a new email address for receiving support requests. The email address must follow Zendesk's format (`{local-part}@{accountname}.zendesk.com`) for internal addresses, or be an existing external email with forwarding properly configured. The created address will have verification statuses that indicate whether DNS records (CNAME, SPF) are properly configured. Note that you cannot change the email address of an existing support address after creation."
59020 + },
59021 + {
59022 + "slug": "ZENDESK_CREATE_SUSPENDED_TICKETS_EXPORT",
59023 + "name": "Export Suspended Tickets",
59024 + "description": "Export Suspended Tickets from Zendesk Support. Use when you need to export all suspended tickets for compliance review, audit purposes, or data analysis. This action enqueues a job that creates a CSV file; when complete, Zendesk emails the requester a link to download the CSV. Suspended tickets are sorted by update timestamp in ascending order. Rate limited to one request per minute. Note: This action is read-only and returns the export job status. The actual CSV will be sent via email when the job completes."
59025 + },
59026 + {
59027 + "slug": "ZENDESK_CREATE_TICKET_CONTENT_PIN",
59028 + "name": "Create Ticket Content Pin",
59029 + "description": "Create a ticket content pin in Zendesk. Content pins allow you to attach helpful resources like Help Center articles or external content directly to tickets for easy reference. Use this action when you need to: - Attach a Help Center article to a ticket for context - Pin an external knowledge base article to a ticket - Add relevant documentation or resources to a support ticket"
59030 + },
59031 + {
59032 + "slug": "ZENDESK_CREATE_TICKET_FIELD",
59033 + "name": "Create Ticket Field",
59034 + "description": "Create a custom ticket field in Zendesk with various field types. Use when you need to add a new custom field (such as text, dropdown, checkbox, date, numeric, regex-validated, or lookup) to capture additional information on tickets. The field title is required; description, required flag, and custom options are optional."
59035 + },
59036 + {
59037 + "slug": "ZENDESK_CREATE_TICKET_FIELD_OPTION",
59038 + "name": "Create Ticket Field Option",
59039 + "description": "Create or update an option for a dropdown or multiselect ticket field. Use when you need to add a new selectable option to a custom ticket field of type 'multiselect' or 'tagger'. If an option with the same value already exists, it will be updated with the provided name. This action is idempotent - running it multiple times with the same value will update the existing option rather than creating duplicates."
59040 + },
59041 + {
59042 + "slug": "ZENDESK_CREATE_TRIGGER",
59043 + "name": "Create Trigger",
59044 + "description": "Create a new trigger in Zendesk. Triggers are business rules that automatically perform actions on tickets when certain conditions are met. Unlike automations, triggers execute immediately when tickets are created or updated. Use this action when you need to: - Automatically change ticket status based on conditions - Assign tickets to agents or groups based on rules - Add tags to tickets matching certain criteria - Send notifications to agents, groups, or external systems - Update custom fields based on ticket properties Note: Triggers must have at least one condition in the 'all' array that references a time-based field (like created_at, updated_at) OR checks one of: status, type, group_id, assignee_id, requester_id, custom_status_id."
59045 + },
59046 + {
59047 + "slug": "ZENDESK_CREATE_TRIGGER_CATEGORIES_JOB",
59048 + "name": "Create Trigger Categories Batch Job",
59049 + "description": "Create a batch job for ticket trigger categories in Zendesk. Use this action when you need to perform batch operations on multiple trigger categories at once. The action 'patch' allows updating trigger categories in bulk. Returns job status and results that can be polled for completion. Endpoint: POST /api/v2/trigger_categories/jobs"
59050 + },
59051 + {
59052 + "slug": "ZENDESK_CREATE_TRIGGER_CATEGORY",
59053 + "name": "Create Zendesk Trigger Category",
59054 + "description": "Create a new trigger category in Zendesk. Trigger categories are used to organize and group triggers for better management. Use when setting up automated workflows or organizing business rules. This action creates a trigger category with the specified name and optional position. The name must be unique within the account."
59055 + },
59056 + {
59057 + "slug": "ZENDESK_CREATE_USER_FIELD_OPTION",
59058 + "name": "Create User Field Option",
59059 + "description": "Create or update an option for a dropdown or multiselect user field. Use when you need to add a new selectable option to a custom user field of type 'multiselect' or 'tagger'. If an option with the same value already exists, it will be updated with the provided name. This action is idempotent - running it multiple times with the same value will update the existing option rather than creating duplicates."
59060 + },
59061 + {
59062 + "slug": "ZENDESK_CREATE_USER_IDENTITY",
59063 + "name": "Create User Identity",
59064 + "description": "Tool to add an identity to a user's profile in Zendesk. An agent can add multiple identities to a user (e.g., multiple email addresses). Use this when a user needs to be contacted via a new channel or needs an additional identifier. Use when you need to add an additional identity (email, phone, social) to an existing Zendesk user."
59065 + },
59066 + {
59067 + "slug": "ZENDESK_CREATE_USER_PROFILES_EVENTS",
59068 + "name": "Create User Profile Event",
59069 + "description": "Store an event against a Sunshine user profile. Creates the profile if it doesn't exist. Use when tracking user activities such as purchases, sign-ups, or custom application events. The event is associated with the profile identified by the provided identifiers. This action is useful for building user activity timelines and triggering automations based on profile events."
59070 + },
59071 + {
59072 + "slug": "ZENDESK_CREATE_USERS_LOGOUT_MANY",
59073 + "name": "Logout Many Zendesk Users",
59074 + "description": "Log out multiple users in Zendesk by ending their active sessions. This action is irreversible — the affected users will be logged out and will need to re-authenticate. Use when you need to immediately terminate sessions for multiple users (e.g., after security incident, offboarding, or credential revocation). The operation accepts up to 100 user IDs at a time."
59075 + },
59076 + {
59077 + "slug": "ZENDESK_CREATE_USERS_ORGANIZATION_MEMBERSHIPS",
59078 + "name": "Create User Organization Membership",
59079 + "description": "Create a new organization membership for a specific user in Zendesk by assigning a user to an organization. Use when you need to associate an existing user with an organization so they can access organization-specific tickets and data. This action targets a specific user by their ID. This action is idempotent in that creating a duplicate membership will fail with a specific error, but the operation itself is not naturally idempotent."
59080 + },
59081 + {
59082 + "slug": "ZENDESK_CREATE_USERS_TAGS",
59083 + "name": "Create Users Tags",
59084 + "description": "Set tags on a Zendesk user via POST request to /api/v2/users/{user_id}/tags. Use when you need to add or update tags on a specific user. Note that this replaces all existing tags on the user with the provided set of tags. This action is idempotent."
59085 + },
59086 + {
59087 + "slug": "ZENDESK_CREATE_VIEW",
59088 + "name": "Create View",
59089 + "description": "Create a new view in Zendesk. Views are saved ticket filters that help agents organize and prioritize their work. They can filter tickets by conditions like status, priority, assignee, and more. Use this action when you need to: - Create a custom view for a specific team or workflow - Set up views for different ticket priorities or statuses - Create views with restricted access for specific groups - Configure views with specific columns, grouping, and sort order Note: At minimum, the 'all' conditions must include a condition checking 'status', 'type', 'group_id', 'assignee_id', or 'requester_id'."
59090 + },
59091 + {
59092 + "slug": "ZENDESK_CREATE_VIEWS_PREVIEW",
59093 + "name": "Preview View",
59094 + "description": "Preview a Zendesk view by constructing conditions and execution settings to see which tickets match. Use when you need to test or validate view conditions before saving, or to retrieve a live preview of tickets matching specific filter criteria without creating a permanent view. This action is useful for verifying view logic, testing conditions, and previewing results before committing to a saved view."
59095 + },
59096 + {
59097 + "slug": "ZENDESK_CREATE_VIEWS_PREVIEW_COUNT",
59098 + "name": "Preview View Ticket Count",
59099 + "description": "Preview ticket count for a view in Zendesk. Returns the number of tickets matching the specified conditions before saving the view. Use when you want to verify how many tickets will match a view's filter criteria before creating or updating a view. This action sends a POST request to /api/v2/views/preview/count with view conditions and returns the matching ticket count. Rate limited to 5 requests per minute, per view, per agent."
59100 + },
59101 + {
59102 + "slug": "ZENDESK_CREATE_ZENDESK_ATTACHMENTS",
59103 + "name": "Upload Zendesk Attachment",
59104 + "description": "Upload a file attachment to Zendesk. Returns an attachment object with an ID that can be used to attach the file to a ticket comment. Use when you need to add files (documents, images, logs, etc.) to Zendesk tickets. The upload token returned is valid for 60 minutes. After uploading, attach the file to a ticket by including the attachment token in your ticket comment."
59105 + },
59106 + {
59107 + "slug": "ZENDESK_CREATE_ZENDESK_CUSTOM_OBJECT",
59108 + "name": "Create Zendesk Custom Object",
59109 + "description": "Create a new custom object in Zendesk. Use when you need to define a new custom object type to store and manage custom data. The key is immutable once created, so choose carefully."
59110 + },
59111 + {
59112 + "slug": "ZENDESK_CREATE_ZENDESK_CUSTOM_OBJECT_FIELD",
59113 + "name": "Create Zendesk Custom Object Field",
59114 + "description": "Create a new field for a custom object in Zendesk. Use when you need to add a new attribute or data field to an existing custom object type. The key is immutable once created. This action is idempotent for the same key, but the key parameter must be unique per custom object."
59115 + },
59116 + {
59117 + "slug": "ZENDESK_CREATE_ZENDESK_GROUP",
59118 + "name": "Create Zendesk Group",
59119 + "description": "Create a new group in Zendesk. The group name must be unique within the account. Use when organizing agents into teams for ticket assignment and routing. Returns the full group object including the assigned ID — persist it for subsequent operations."
59120 + },
59121 + {
59122 + "slug": "ZENDESK_CREATE_ZENDESK_IMPORT_TICKET",
59123 + "name": "Import Zendesk Ticket",
59124 + "description": "Import a ticket into Zendesk with historical timestamps. This action creates tickets with past `created_at`, `updated_at`, or `solved_at` values, useful for migrating historical data. For real-time ticket creation, use ZENDESK_CREATE_ZENDESK_TICKET. Tickets created with 'closed' status and archive_immediately=true bypass normal lifecycle and go directly to archive."
59125 },
59126 {
59127 "slug": "ZENDESK_CREATE_ZENDESK_ORGANIZATION",
59128 "name": "Create Zendesk Organization",
58513 - "description": "Create an organization in Zendesk. Both `name` and `external_id` must be unique across the account; verify no duplicates exist before calling. Returns `data.id` — persist it for subsequent update or delete operations."
59129 + "description": "Create a new organization in Zendesk. After creation, the organization ID is auto-assigned and returned. Verify the exact ID before performing downstream operations that target this organization. Multiple organizations may share similar names — always confirm the correct organization by ID. This action is irreversible — the organization cannot be recovered once deleted. Use this action when you need to register a new company, customer, or group as a Zendesk organization so you can assign users, tickets, or other resources to it."
59130 + },
59131 + {
59132 + "slug": "ZENDESK_CREATE_ZENDESK_REQUEST",
59133 + "name": "Create Zendesk Request",
59134 + "description": "Create a new request in Zendesk. Use when an end user needs to submit a support request through the API. The request will be created with the provided subject, description, priority, and other optional fields. Returns the created request with its ID and URL."
59135 + },
59136 + {
59137 + "slug": "ZENDESK_CREATE_ZENDESK_TARGET",
59138 + "name": "Create Zendesk Target",
59139 + "description": "Create a target in Zendesk for triggering outbound integrations. Use when you need to set up a notification channel or integration with external services like Campfire, email, URL webhooks, or other supported targets. Targets can be used with triggers and automation rules. Note: URL targets are being discontinued October 28, 2024 in favor of webhooks. Email targets remain unaffected."
59140 },
59141 {
59142 "slug": "ZENDESK_CREATE_ZENDESK_TICKET",
59143 "name": "Create Zendesk Ticket",
59144 "description": "Create a ticket in Zendesk with full support for all ticket fields. Returns `ticket_id` and `ticket_url`; use ZENDESK_GET_ZENDESK_TICKET_BY_ID for the full ticket object."
59145 },
59146 + {
59147 + "slug": "ZENDESK_CREATE_ZENDESK_TICKET_OR_VOICEMAIL_TICKET",
59148 + "name": "Create Ticket or Voicemail Ticket",
59149 + "description": "Create a ticket in Zendesk via the voice/channel API endpoint. Use this action when you need to create tickets from phone calls, voicemails, or other voice channel interactions. Returns `ticket_id` and `ticket_url` for the created ticket. This endpoint is specifically for Zendesk Talk/voice channel ticket creation."
59150 + },
59151 {
59152 "slug": "ZENDESK_CREATE_ZENDESK_USER",
59153 "name": "Create Zendesk User",
59154 "description": "Tool to create a new user in Zendesk. Search for existing users first to avoid duplicate accounts with the same email. Use when you need to onboard a user with specific details."
59155 },
59156 + {
59157 + "slug": "ZENDESK_CREATE_ZENDESK_USER_FIELD",
59158 + "name": "Create Zendesk User Field",
59159 + "description": "Create a custom user field in Zendesk. Use when you need to define a new custom field to capture additional user data. Supports text, checkbox, dropdown, multiselect, date, integer, decimal, regexp validation, and lookup types. Only administrators can create user fields."
59160 + },
59161 + {
59162 + "slug": "ZENDESK_DELETE_ACCESS_RULE",
59163 + "name": "Delete Access Rule",
59164 + "description": "Delete an access rule for a custom object in Zendesk. This action is irreversible — the access rule cannot be recovered once deleted. Use when you need to remove access control rules for custom objects."
59165 + },
59166 + {
59167 + "slug": "ZENDESK_DELETE_AUTOMATION",
59168 + "name": "Delete Zendesk Automation",
59169 + "description": "Permanently deletes an automation in Zendesk. This action is irreversible — the automation will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete automations or removing test data. **Note**: You might be restricted from deleting automations that are active or referenced by other rules."
59170 + },
59171 + {
59172 + "slug": "ZENDESK_DELETE_BUSINESS_HOURS_SCHEDULE",
59173 + "name": "Delete Zendesk Business Hours Schedule",
59174 + "description": "Permanently deletes a business hours schedule in Zendesk. Use when you need to remove obsolete schedules or clean up test data. This action is irreversible — the schedule cannot be recovered once removed. Admin permissions are required. **Note**: Schedules that are currently in use by active SLA policies or other configurations may not be deletable."
59175 + },
59176 + {
59177 + "slug": "ZENDESK_DELETE_CUSTOM_OBJECT_RECORD_ATTACHMENT",
59178 + "name": "Delete Custom Object Record Attachment",
59179 + "description": "Permanently deletes an attachment from a custom object record in Zendesk. Use this action when you need to remove a specific file attachment from a custom object record. This action is irreversible — the attachment will be permanently deleted and cannot be recovered once removed. **Note**: Only attachments that are not required and not the primary attachment can be deleted."
59180 + },
59181 + {
59182 + "slug": "ZENDESK_DELETE_CUSTOM_OBJECT_RECORD_BY_EXTERNAL_ID_OR_NAME",
59183 + "name": "Delete Custom Object Record",
59184 + "description": "Permanently deletes a custom object record in Zendesk by its external ID or name. Use this action when you need to remove a specific record from a custom object. This action is irreversible — the record cannot be recovered once deleted. Requires admin permissions. **Note**: Either external_id or name must be provided to identify the record to delete."
59185 + },
59186 + {
59187 + "slug": "ZENDESK_DELETE_DELETED_TICKET",
59188 + "name": "Delete Deleted Ticket Permanently",
59189 + "description": "Permanently deletes a soft-deleted ticket from Zendesk. This action is irreversible - once a ticket is permanently deleted, it cannot be recovered. Use this action to remove tickets that were previously soft-deleted using the delete_ticket action. Use this action when you need to permanently remove a ticket that has already been deleted and is no longer accessible through normal operations."
59190 + },
59191 + {
59192 + "slug": "ZENDESK_DELETE_DELETION_SCHEDULE",
59193 + "name": "Delete Zendesk Deletion Schedule",
59194 + "description": "Permanently deletes a deletion schedule in Zendesk. This action is irreversible — the deletion schedule will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete deletion schedules or removing test data."
59195 + },
59196 + {
59197 + "slug": "ZENDESK_DELETE_GROUP_MEMBERSHIP",
59198 + "name": "Delete Zendesk Group Membership",
59199 + "description": "Permanently deletes a group membership in Zendesk, immediately removing a user from a group. This action is irreversible — the group membership cannot be recovered once deleted. Use when cleaning up obsolete group memberships or removing users from groups. **Note**: Deleting a group membership does not delete the user or the group itself, only the association between them."
59200 + },
59201 + {
59202 + "slug": "ZENDESK_DELETE_GROUP_MEMBERSHIPS_DESTROY_MANY",
59203 + "name": "Bulk Delete Zendesk Group Memberships",
59204 + "description": "Bulk delete group memberships in Zendesk. Immediately removes users from groups. This action is irreversible — the memberships will be permanently deleted and cannot be recovered once removed. Use when cleaning up test data or removing obsolete group memberships in one call. Returns a job_status payload; deletions complete asynchronously."
59205 + },
59206 + {
59207 + "slug": "ZENDESK_DELETE_MACRO",
59208 + "name": "Delete Zendesk Macro",
59209 + "description": "Permanently deletes a macro in Zendesk. This action is irreversible — the macro will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete macros or removing test data. **Note**: You might be restricted from deleting macros that are active or referenced by other rules."
59210 + },
59211 + {
59212 + "slug": "ZENDESK_DELETE_MACROS_DESTROY_MANY",
59213 + "name": "Bulk Delete Zendesk Macros",
59214 + "description": "Bulk delete macros in Zendesk. This action is irreversible — the macros will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete macros or removing test data."
59215 + },
59216 + {
59217 + "slug": "ZENDESK_DELETE_MANY_AUTOMATIONS",
59218 + "name": "Bulk Delete Zendesk Automations",
59219 + "description": "Bulk delete automations in Zendesk. This action is irreversible — the automations will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete automations or removing test data."
59220 + },
59221 + {
59222 + "slug": "ZENDESK_DELETE_MANY_OBJECT_TRIGGERS",
59223 + "name": "Bulk Delete Zendesk Custom Object Triggers",
59224 + "description": "Bulk delete triggers for a Zendesk custom object. This action is irreversible — the triggers will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete triggers or removing test data for a specific custom object. Returns a success indicator upon completion. Requires the custom object key and a comma-separated list of trigger IDs to identify which triggers to delete."
59225 + },
59226 + {
59227 + "slug": "ZENDESK_DELETE_MANY_ORGANIZATION_MEMBERSHIPS",
59228 + "name": "Bulk Delete Zendesk Organization Memberships",
59229 + "description": "Bulk delete organization memberships in Zendesk. This action is irreversible — the memberships will be permanently removed and cannot be recovered once deleted. Use when cleaning up obsolete organization memberships or removing users from organizations. Returns a job_status payload (initial status typically 'queued'); deletions complete asynchronously and may require follow-up polling to confirm completion."
59230 + },
59231 + {
59232 + "slug": "ZENDESK_DELETE_MANY_VIEWS",
59233 + "name": "Bulk Delete Zendesk Views",
59234 + "description": "Bulk delete views in Zendesk. This action is irreversible — the views will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete views or removing test data. Returns 204 No Content on success."
59235 + },
59236 + {
59237 + "slug": "ZENDESK_DELETE_ORGANIZATION_FIELD",
59238 + "name": "Delete Zendesk Organization Field",
59239 + "description": "Permanently deletes an organization field in Zendesk. Use this action when you need to remove a custom organization field from the system. This action is irreversible — the organization field will be permanently deleted and cannot be recovered once removed. Any data stored in this field across all organizations will be lost. **Note**: Ensure no organizations are using this field before deletion, as the deletion cannot be undone."
59240 + },
59241 + {
59242 + "slug": "ZENDESK_DELETE_ORGANIZATION_MEMBERSHIP",
59243 + "name": "Delete Organization Membership",
59244 + "description": "Permanently removes a user from an organization in Zendesk by deleting the organization membership. This action is irreversible — the membership cannot be recovered once deleted. Use this action when you need to remove a user's association with an organization. This operation requires admin permissions."
59245 + },
59246 + {
59247 + "slug": "ZENDESK_DELETE_ORGANIZATIONS_TAGS",
59248 + "name": "Delete Organization Tags",
59249 + "description": "Remove all tags from a Zendesk organization. Use when you need to clear organization tags as part of cleanup or reorganization tasks. This action is irreversible — the tags will be permanently removed from the organization and cannot be recovered once deleted."
59250 + },
59251 + {
59252 + "slug": "ZENDESK_DELETE_ORGANIZATION_SUBSCRIPTION",
59253 + "name": "Delete Zendesk Organization Subscription",
59254 + "description": "Permanently deletes an organization subscription in Zendesk. This action is irreversible — the subscription cannot be recovered once removed. Use when you need to remove an organization subscription."
59255 + },
59256 + {
59257 + "slug": "ZENDESK_DELETE_RESOURCE_COLLECTIONS",
59258 + "name": "Delete Resource Collection",
59259 + "description": "Delete a resource collection in Zendesk. Use when you need to remove a resource collection that is no longer needed. This action returns a job status that can be polled to track the deletion progress. This operation is irreversible; confirm the correct resource_collection_id before executing."
59260 + },
59261 + {
59262 + "slug": "ZENDESK_DELETE_SUSPENDED_TICKETS_DESTROY_MANY",
59263 + "name": "Bulk Delete Zendesk Suspended Tickets",
59264 + "description": "Permanently deletes multiple suspended tickets in Zendesk. This action is irreversible — the suspended tickets will be permanently deleted and cannot be recovered once removed. Use when cleaning up spam or irrelevant suspended tickets. Accepts up to 100 ticket IDs per request."
59265 + },
59266 + {
59267 + "slug": "ZENDESK_DELETE_TARGET",
59268 + "name": "Delete Zendesk Target",
59269 + "description": "Permanently deletes a target in Zendesk. This action is irreversible — the target will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete targets or removing test data. **Note**: Deleting a target that is actively used by triggers or other automation rules may cause those rules to fail."
59270 + },
59271 + {
59272 + "slug": "ZENDESK_DELETE_TICKET_FIELD",
59273 + "name": "Delete Zendesk Ticket Field",
59274 + "description": "Permanently deletes a ticket field in Zendesk. Use this action when you need to remove a custom ticket field that is no longer needed. This action is irreversible — the ticket field and all associated data will be permanently deleted and cannot be recovered once removed. Requires admin permissions. **Note**: System ticket fields cannot be deleted. Only custom ticket fields can be removed."
59275 + },
59276 + {
59277 + "slug": "ZENDESK_DELETE_TICKET_FIELD_OPTION",
59278 + "name": "Delete Ticket Field Option",
59279 + "description": "Permanently deletes an option from a ticket field in Zendesk. Use this action when you need to remove a specific selectable option from a dropdown or multiselect ticket field. This action is irreversible — the ticket field option will be permanently deleted and cannot be recovered once removed. **Note**: Only custom options can be deleted. System-defined options cannot be removed."
59280 + },
59281 + {
59282 + "slug": "ZENDESK_DELETE_TICKETS_TAGS",
59283 + "name": "Delete Ticket Tags",
59284 + "description": "Remove tags from a Zendesk ticket. This action is irreversible; once tags are removed, they cannot be recovered without re-adding them. Use when you need to clean up ticket tags, remove outdated labels, or clear all tags from a ticket."
59285 + },
59286 + {
59287 + "slug": "ZENDESK_DELETE_TRIGGER",
59288 + "name": "Delete Zendesk Trigger",
59289 + "description": "Permanently deletes a trigger in Zendesk. This action is irreversible — the trigger will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete triggers or removing test data. **Note**: You might be restricted from deleting triggers that are active or referenced by other rules."
59290 + },
59291 + {
59292 + "slug": "ZENDESK_DELETE_TRIGGER_CATEGORY",
59293 + "name": "Delete Zendesk Trigger Category",
59294 + "description": "Permanently deletes a trigger category in Zendesk. This action is irreversible — the trigger category will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete trigger categories or removing test data. **Note**: You might be restricted from deleting trigger categories that are in use by active triggers."
59295 + },
59296 + {
59297 + "slug": "ZENDESK_DELETE_USER_FIELD",
59298 + "name": "Delete Zendesk User Field",
59299 + "description": "Permanently deletes a user field in Zendesk, removing it from all user profiles. This action is irreversible — the field and all its associated data will be permanently lost. Use when cleaning up deprecated custom fields or removing test fields."
59300 + },
59301 + {
59302 + "slug": "ZENDESK_DELETE_USER_FIELD_OPTION",
59303 + "name": "Delete User Field Option",
59304 + "description": "Permanently deletes an option from a user field in Zendesk. Use this action when you need to remove a specific selectable option from a dropdown or multiselect user field. This action is irreversible — the user field option will be permanently deleted and cannot be recovered once removed."
59305 + },
59306 + {
59307 + "slug": "ZENDESK_DELETE_USER_PERMANENTLY",
59308 + "name": "Permanently Delete User",
59309 + "description": "Permanently deletes a soft-deleted user from Zendesk. This action is irreversible - once a user is permanently deleted, it cannot be recovered. Use this action to remove users that were previously soft-deleted using the delete_user action. Use this action when you need to permanently remove a user that has already been deleted and is no longer accessible through normal operations. This action requires appropriate admin permissions."
59310 + },
59311 + {
59312 + "slug": "ZENDESK_DELETE_USER_PROFILE",
59313 + "name": "Delete Zendesk User Profile",
59314 + "description": "Permanently deletes a user profile in Zendesk by its profile ID. This action is irreversible — the profile and all associated data will be permanently lost. Use when cleaning up duplicate profiles, test profiles, or removing profiles that are no longer needed. Requires agent-level access with appropriate role permissions."
59315 + },
59316 + {
59317 + "slug": "ZENDESK_DELETE_USERS_DESTROY_MANY",
59318 + "name": "Bulk Delete Zendesk Users",
59319 + "description": "Bulk delete users from Zendesk by their IDs or external IDs. This action is irreversible — once deleted, users cannot be recovered. Use when cleaning up test data, removing obsolete accounts, or consolidating user records in bulk. The operation returns a job_status payload (initial status typically 'queued'); deletions complete asynchronously and may require follow-up polling via the job_status URL to confirm completion."
59320 + },
59321 + {
59322 + "slug": "ZENDESK_DELETE_USER_SESSION",
59323 + "name": "Delete Zendesk User Session",
59324 + "description": "Delete a specific user session in Zendesk. Use this action when you need to invalidate and remove a specific user session. This action is irreversible — the session cannot be recovered once deleted. Use when you need to forcibly log out a user or remove a specific session from their account for security or administrative purposes."
59325 + },
59326 + {
59327 + "slug": "ZENDESK_DELETE_USERS_GROUP_MEMBERSHIPS",
59328 + "name": "Delete Zendesk User's Group Membership",
59329 + "description": "Permanently deletes a user's group membership in Zendesk, immediately removing a user from a group. This action is irreversible — the group membership cannot be recovered once deleted. Use when cleaning up obsolete group memberships, removing users from groups, or revoking group access. **Note**: Deleting a group membership does not delete the user or the group itself, only the association between them. The user will no longer have access to tickets routed to that group."
59330 + },
59331 + {
59332 + "slug": "ZENDESK_DELETE_USERS_IDENTITY",
59333 + "name": "Delete User Identity",
59334 + "description": "Deletes an identity for a given user in Zendesk. Use when you need to remove a specific identity (e.g., email, phone, social login) from a user's account. This action is irreversible — once the identity is deleted, it cannot be recovered. Ensure you have the correct user_id and user_identity_id before executing."
59335 + },
59336 + {
59337 + "slug": "ZENDESK_DELETE_USERS_ME_LOGOUT",
59338 + "name": "Delete Authenticated Session",
59339 + "description": "Delete the current authenticated session in Zendesk. This action invalidates the current API session, requiring re-authentication for future API calls. Use when you need to explicitly log out the current user session or terminate an active authenticated connection. This action is irreversible — the session cannot be recovered once deleted. Note: This action targets the authenticated user's own session only and cannot terminate other user sessions."
59340 + },
59341 + {
59342 + "slug": "ZENDESK_DELETE_USERS_ORGANIZATION_MEMBERSHIPS",
59343 + "name": "Delete User's Organization Membership",
59344 + "description": "Permanently removes a user from an organization in Zendesk by deleting the organization membership for a specific user. This action is irreversible — the membership cannot be recovered once deleted. Use this action when you need to remove a user's association with an organization for a specific user. This operation requires admin permissions."
59345 + },
59346 + {
59347 + "slug": "ZENDESK_DELETE_USERS_SESSIONS",
59348 + "name": "Delete All User Sessions",
59349 + "description": "Bulk delete all sessions for a specific user in Zendesk. This action invalidates all active sessions for the specified user, forcing them to re-authenticate on their next API call or login. Use when you need to forcibly log out a user by revoking all their active sessions, such as during security incidents or account deactivation. This action is irreversible — all sessions for the user will be immediately invalidated and cannot be recovered."
59350 + },
59351 + {
59352 + "slug": "ZENDESK_DELETE_USERS_TAGS",
59353 + "name": "Delete User Tags",
59354 + "description": "Remove tags from a Zendesk user. Use when you need to clean up user tags, remove outdated labels, or clear all tags from a user account. This action is irreversible — once tags are removed, they cannot be recovered without re-adding them."
59355 + },
59356 + {
59357 + "slug": "ZENDESK_DELETE_VIEW",
59358 + "name": "Delete Zendesk View",
59359 + "description": "Delete a single view in Zendesk. This action is irreversible — the view will be permanently deleted and cannot be recovered once removed. Use when you need to remove a specific obsolete view or test view. Returns 204 No Content on success."
59360 + },
59361 + {
59362 + "slug": "ZENDESK_DELETE_ZENDESK_APP_INSTALLATION",
59363 + "name": "Delete Zendesk App Installation",
59364 + "description": "Permanently removes an installed app from Zendesk. Use when you need to uninstall an app from your Zendesk instance. This action is irreversible — the app installation cannot be recovered once removed. Admin permissions are required."
59365 + },
59366 + {
59367 + "slug": "ZENDESK_DELETE_ZENDESK_BOOKMARK",
59368 + "name": "Delete Zendesk Bookmark",
59369 + "description": "Permanently deletes a bookmark in Zendesk. Use when you need to remove a user bookmark. This action is irreversible — the bookmark cannot be recovered once deleted."
59370 + },
59371 + {
59372 + "slug": "ZENDESK_DELETE_ZENDESK_CUSTOM_OBJECT",
59373 + "name": "Delete Zendesk Custom Object",
59374 + "description": "Permanently deletes a custom object definition in Zendesk. Use this action when you need to remove a custom object type and all its associated records. This action is irreversible — the custom object and all its data will be permanently deleted and cannot be recovered once removed. Requires admin permissions. **Note**: Deleting a custom object will also delete all records associated with it."
59375 + },
59376 + {
59377 + "slug": "ZENDESK_DELETE_ZENDESK_CUSTOM_OBJECT_FIELD",
59378 + "name": "Delete Zendesk Custom Object Field",
59379 + "description": "Permanently deletes a custom object field in Zendesk. Use this action when you need to remove a specific field from a custom object definition. This action is irreversible — the field and all its data will be permanently deleted and cannot be recovered once removed. Requires admin permissions."
59380 + },
59381 + {
59382 + "slug": "ZENDESK_DELETE_ZENDESK_CUSTOM_OBJECT_RECORD",
59383 + "name": "Delete Zendesk Custom Object Record",
59384 + "description": "Permanently deletes a custom object record in Zendesk. Use this action when you need to remove a specific record from a custom object type. This action is irreversible — the record and its data will be permanently deleted and cannot be recovered once removed. Requires the custom object key and the record ID to identify which specific record to delete."
59385 + },
59386 + {
59387 + "slug": "ZENDESK_DELETE_ZENDESK_CUSTOM_STATUS",
59388 + "name": "Delete Zendesk Custom Status",
59389 + "description": "Permanently deletes a custom ticket status in Zendesk. Use this action when you need to remove a custom ticket status from the system. This action is irreversible — the custom status will be permanently deleted and cannot be recovered once removed. **Note**: Ensure no tickets are using this custom status before deletion."
59390 + },
59391 + {
59392 + "slug": "ZENDESK_DELETE_ZENDESK_DYNAMIC_CONTENT_ITEM",
59393 + "name": "Delete Zendesk Dynamic Content Item",
59394 + "description": "Permanently deletes a dynamic content item in Zendesk. This action is irreversible — the dynamic content item cannot be recovered once deleted. Always confirm the correct dynamic_content_item_id before executing."
59395 + },
59396 + {
59397 + "slug": "ZENDESK_DELETE_ZENDESK_DYNAMIC_CONTENT_ITEM_VARIANT",
59398 + "name": "Delete Zendesk Dynamic Content Item Variant",
59399 + "description": "Permanently deletes a dynamic content item variant in Zendesk. This action is irreversible — the variant cannot be recovered once deleted. Always confirm the correct dynamic_content_item_id and dynamic_content_variant_id before executing."
59400 + },
59401 + {
59402 + "slug": "ZENDESK_DELETE_ZENDESK_OBJECT_TRIGGER",
59403 + "name": "Delete Zendesk Custom Object Trigger",
59404 + "description": "Permanently deletes a custom object trigger in Zendesk. Use this action when you need to remove a specific trigger from a custom object definition. This action is irreversible — the trigger and all its data will be permanently deleted and cannot be recovered once removed. Requires admin permissions."
59405 + },
59406 {
59407 "slug": "ZENDESK_DELETE_ZENDESK_ORGANIZATION",
59408 "name": "Delete Zendesk Organization",
59409 "description": "Delete an organization in Zendesk. This operation is irreversible; confirm organization_id and get explicit user confirmation before calling."
59410 },
59411 + {
59412 + "slug": "ZENDESK_DELETE_ZENDESK_SUPPORT_ADDRESS",
59413 + "name": "Delete Zendesk Support Address",
59414 + "description": "Permanently deletes a support address from Zendesk. This action is irreversible — the support address cannot be recovered once deleted. Use this action when you need to remove a deprecated or unwanted support email address from your Zendesk account. This operation requires admin permissions and the support address must not be set as the default address. Deleting an address that is actively used may impact email routing."
59415 + },
59416 {
59417 "slug": "ZENDESK_DELETE_ZENDESK_TICKET",
59418 "name": "Delete Zendesk Ticket",
@@ -58537,36 +59423,1196 @@
59423 "name": "Delete Zendesk User",
59424 "description": "Tool to permanently delete a user from Zendesk. Use when you need to remove a user account. This action cannot be undone and requires appropriate admin permissions."
59425 },
59426 + {
59427 + "slug": "ZENDESK_DESTROY_MANY_DELETED_TICKETS",
59428 + "name": "Bulk Delete Soft-Deleted Zendesk Tickets",
59429 + "description": "Permanently deletes multiple soft-deleted tickets in Zendesk. This action is irreversible — the tickets will be permanently removed and cannot be recovered once executed. Use when cleaning up test tickets or removing obsolete soft-deleted tickets in bulk. The operation returns a job_status payload (initial status typically 'queued'); deletions complete asynchronously and may require follow-up polling to confirm completion. Maximum 100 tickets per request."
59430 + },
59431 {
59432 "slug": "ZENDESK_DESTROY_MANY_ORGANIZATIONS",
59433 "name": "Bulk Delete Zendesk Organizations",
58543 - "description": "Tool to bulk delete Zendesk organizations. Irreversible — confirm ids/external_ids before calling. Use when cleaning up test data or removing obsolete organizations in one call. Returns a job_status payload (initial status typically 'queued'); deletions complete asynchronously and may require follow-up polling to confirm completion."
59434 + "description": "Bulk delete Zendesk organizations. This action is irreversible - once organizations are deleted, they cannot be recovered. Use when you need to remove multiple organizations in a single operation. Returns a job_status payload (initial status typically 'queued'); deletions complete asynchronously and may require follow-up polling to confirm completion. Maximum 100 organizations per request. Use this action when you need to clean up test data, remove obsolete organizations, or perform bulk organization deletions. You must provide either 'ids' (comma-separated list of Zendesk organization IDs) or 'external_ids' (comma-separated list of external IDs)."
59435 + },
59436 + {
59437 + "slug": "ZENDESK_DETECT_BEST_LOCALE",
59438 + "name": "Detect Best Locale",
59439 + "description": "Detect the best language/locale for the current user based on their browser settings and account preferences. Use when you need to determine the optimal language to display content in for a user, such as when localizing ticket comments, article content, or Help Center pages. This action reads the user's preferred languages from the Accept-Language header and matches them against supported locales in your Zendesk account. The detected locale is returned with full locale details including ID, name, and API URL."
59440 + },
59441 + {
59442 + "slug": "ZENDESK_DOWNLOAD_CUSTOM_OBJECT_RECORD_ATTACHMENT",
59443 + "name": "Download Custom Object Record Attachment",
59444 + "description": "Download attachment file from a Zendesk custom object record. Use when you need to retrieve the actual file content of an attachment associated with a custom object record, such as documents, images, or other files. This action returns the raw file content and can display it inline or trigger a file download depending on the inline parameter. Note: The custom object must have attachments enabled for this action to work."
59445 },
59446 {
59447 "slug": "ZENDESK_GET_ABOUT_ME",
59448 "name": "Get Zendesk About Me",
59449 "description": "Get information about the currently authenticated user in Zendesk. Returns only the caller's own account; to look up other users, use ZENDESK_SEARCH_ZENDESK_USERS. Response nests the user object under data.owner_info.user. Useful for verifying the acting user's identity and permissions before performing bulk operations."
59450 },
59451 + {
59452 + "slug": "ZENDESK_GET_ACCOUNT_SETTINGS",
59453 + "name": "Get Account Settings",
59454 + "description": "Retrieve Zendesk account settings. Use this action when you need to view the configuration and feature flags for a Zendesk account, including API settings, branding, ticket preferences, chat configuration, voice settings, and more."
59455 + },
59456 + {
59457 + "slug": "ZENDESK_GET_ACTIVE_TRIGGERS",
59458 + "name": "List Active Triggers",
59459 + "description": "List all active ticket triggers in Zendesk. Use when you need to retrieve the currently active trigger rules that automatically perform actions on tickets when certain conditions are met. This action returns all triggers marked as active, including their conditions, actions, and metadata. Active triggers are business rules that define what happens when ticket conditions are satisfied. This is useful for auditing active automation rules, understanding automated workflows, or finding specific trigger configurations."
59460 + },
59461 + {
59462 + "slug": "ZENDESK_GET_ACTIVITIES_COUNT",
59463 + "name": "Count Activities",
59464 + "description": "Count ticket activities in Zendesk. Returns an approximate count of ticket activities. Use when you need to know how many activities exist in the activity stream for reporting or operational purposes."
59465 + },
59466 {
59467 "slug": "ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS",
59468 "name": "Get Zendesk Organizations",
59469 "description": "Get all organizations in Zendesk. Returns results nested under an 'organizations' array; an empty list is valid. Accepts no server-side filters — all filtering by name, domain_names (an array field), or organization_fields must be done client-side. Large accounts require pagination; missing pages will undercount results. Multiple organizations may share similar names or domains — always disambiguate using external_id or domain_names and confirm organization_id before acting. Avoid repeated full-list fetches on large accounts; cache or batch client-side instead."
59470 },
59471 + {
59472 + "slug": "ZENDESK_GET_APP",
59473 + "name": "Get App",
59474 + "description": "Get a single Zendesk app by its numeric ID. Use when you have an app ID and need to retrieve the app's details including name, author information, version, installation count, categories, and description."
59475 + },
59476 + {
59477 + "slug": "ZENDESK_GET_APPS_INSTALLATIONS_REQUIREMENTS",
59478 + "name": "Get App Installation Requirements",
59479 + "description": "List all requirements for a Zendesk app installation. Use when you need to check what configuration or parameters are required for a specific installed app to function properly. Requirements may include OAuth settings, parameter configurations, or other setup steps needed by the app. This action is read-only and idempotent."
59480 + },
59481 + {
59482 + "slug": "ZENDESK_GET_APPS_LOCATION",
59483 + "name": "Get App Location",
59484 + "description": "Get details for a specific Zendesk app location by its numeric ID. Returns location properties including visibility settings, orderability, and associated product codes. Use when you have an app_location_id from listing locations or creating apps and need to retrieve detailed location information. Only accessible to admin users."
59485 + },
59486 + {
59487 + "slug": "ZENDESK_GET_APPS_LOCATION_INSTALLATIONS",
59488 + "name": "List Apps Location Installations",
59489 + "description": "List all apps location installations from Zendesk. Returns an array of app installation IDs organized by location name. Use when you need to retrieve information about apps installed in specific locations within Zendesk, such as nav_bar or other supported locations. This action is read-only and idempotent. Allowed for: Admins only."
59490 + },
59491 + {
59492 + "slug": "ZENDESK_GET_APPS_PUBLIC_KEY",
59493 + "name": "Get App Public Key",
59494 + "description": "Retrieves the public key for a specific Zendesk app. The response is in JSON Web Key (JWK) format containing RSA key components (modulus n, exponent e). Use this action when you need to verify JWTs issued by a Zendesk app or establish trust for app-based authentication. This is a read-only operation."
59495 + },
59496 + {
59497 + "slug": "ZENDESK_GET_APPS_PUBLIC_KEY_PEM",
59498 + "name": "Get App Public Key PEM",
59499 + "description": "Retrieves the public key for a specific Zendesk app in PEM format. The PEM format is a standard base64-encoded certificate format that can be used to verify that requests from the app are legitimate. Use this action when you need to verify JWTs issued by a Zendesk app or establish trust for app-based authentication. This is a read-only operation. Note: This endpoint does not require authentication and can be accessed anonymously."
59500 + },
59501 + {
59502 + "slug": "ZENDESK_GET_ATTACHMENT",
59503 + "name": "Get Attachment",
59504 + "description": "Retrieve details of a single Zendesk attachment by its ID. Use when you have an attachment_id from ticket comments or an attachments list and need to fetch full attachment metadata including file name, size, content type, URLs, and thumbnails. The action returns the attachment object with all available properties."
59505 + },
59506 + {
59507 + "slug": "ZENDESK_GET_AUTOCOMPLETE_TAGS",
59508 + "name": "Get Autocomplete Tags",
59509 + "description": "Search for Zendesk tags using autocomplete. Use when you need to find tag suggestions based on a partial tag name for tagging tickets or organizing content."
59510 + },
59511 + {
59512 + "slug": "ZENDESK_GET_AUTOMATION",
59513 + "name": "Show Automation",
59514 + "description": "Show a specific automation by its ID. Use when you need to retrieve details of a single automation rule in your Zendesk account, such as for auditing, modifying, or understanding what actions and conditions are configured for a particular automation. This action is read-only and idempotent."
59515 + },
59516 + {
59517 + "slug": "ZENDESK_GET_AUTOMATIONS",
59518 + "name": "List Automations",
59519 + "description": "List all automations for the current Zendesk account. Use when you need to retrieve, audit, or review the automation rules configured in your Zendesk account. Automations are business rules that automatically perform actions based on trigger conditions. Supports both traditional offset pagination and cursor-based pagination. Filter by active status to show only enabled or disabled automations."
59520 + },
59521 + {
59522 + "slug": "ZENDESK_GET_AUTOMATIONS_SEARCH",
59523 + "name": "Search Automations",
59524 + "description": "Search for Zendesk automations by their title. Use when you need to find automations in your Zendesk account by searching for keywords in their titles. Automations are business rules that automatically perform actions when certain conditions are met. This action supports filtering by active status and sorting results."
59525 + },
59526 + {
59527 + "slug": "ZENDESK_GET_BRANDS",
59528 + "name": "List Brands",
59529 + "description": "List all brands configured in your Zendesk account. Use when you need to enumerate available brands, check which brand is set as default, or retrieve brand metadata like subdomain and host mappings. This is a read-only, idempotent operation that supports both cursor and offset pagination."
59530 + },
59531 + {
59532 + "slug": "ZENDESK_GET_BRANDS2",
59533 + "name": "Get Zendesk Brand",
59534 + "description": "Show a Brand. Use when you have a brand ID and need to retrieve detailed information about a specific Zendesk brand, including its name, subdomain, active status, Help Center configuration, logo, and associated ticket forms."
59535 + },
59536 + {
59537 + "slug": "ZENDESK_GET_BRANDS_AGENTS",
59538 + "name": "List Agents by Brand",
59539 + "description": "List agents assigned to a specific brand in Zendesk. Use when you need to enumerate which agents have access to a specific brand, such as auditing brand access permissions or determining which agents can access a brand's help center. This is a read-only, idempotent operation."
59540 + },
59541 + {
59542 + "slug": "ZENDESK_GET_CUSTOM_OBJECT_FIELDS_LIMIT",
59543 + "name": "Get Custom Object Fields Limit",
59544 + "description": "Get the current count and maximum limit for custom object fields in Zendesk. Returns the number of fields currently defined for a specific custom object and the maximum allowed limit. Use when you need to check how many fields have been created for a custom object and how much capacity remains before hitting the limit. This is a read-only operation that does not modify any data."
59545 + },
59546 + {
59547 + "slug": "ZENDESK_GET_CUSTOM_OBJECT_RECORDS_LIMIT",
59548 + "name": "Get Custom Object Records Limit",
59549 + "description": "Get the current record limit and usage count for custom objects in Zendesk. Returns the current number of custom object records and the maximum allowed limit. Use when you need to check how many custom object records have been created and how much capacity remains. This is a read-only operation that does not modify any data."
59550 + },
59551 + {
59552 + "slug": "ZENDESK_GET_CUSTOM_OBJECTS_LIMIT",
59553 + "name": "Get Custom Objects Limit",
59554 + "description": "Get the current count and maximum limit for custom objects in Zendesk. Use when you need to check how many custom objects exist in your Zendesk account and what the allowed limit is, to avoid exceeding capacity or to plan for scaling."
59555 + },
59556 + {
59557 + "slug": "ZENDESK_GET_CUSTOM_STATUS",
59558 + "name": "Get Custom Status",
59559 + "description": "Get a specific custom ticket status from Zendesk by its ID. Use when you have a custom status ID from ticket payloads or from listing custom statuses and need to retrieve the full status details including agent/end-user labels, descriptions, and status category. This is a read-only, idempotent operation that retrieves the current state of a custom ticket status."
59560 + },
59561 + {
59562 + "slug": "ZENDESK_GET_CUSTOM_STATUSES",
59563 + "name": "List Custom Ticket Statuses",
59564 + "description": "List custom ticket statuses available in a Zendesk account. Use when you need to retrieve all undeleted custom ticket statuses, optionally filtered by status category, active state, or default status. This action is useful for understanding available custom statuses for ticket workflows, automation rules, or displaying status options to users."
59565 + },
59566 + {
59567 + "slug": "ZENDESK_GET_DELETED_TICKETS",
59568 + "name": "List Deleted Tickets",
59569 + "description": "Lists tickets that have been deleted from Zendesk, showing up to 100 deleted tickets per page with pagination. Use when you need to retrieve information about previously deleted tickets or audit ticket deletions. This action is read-only and idempotent."
59570 + },
59571 + {
59572 + "slug": "ZENDESK_GET_DELETED_USER",
59573 + "name": "Get Deleted User",
59574 + "description": "Retrieves a single deleted Zendesk user by their ID. Use when you have a specific deleted user ID and need to fetch details about that deleted user, such as for auditing purposes, account recovery, or compliance records. Deleted users retain their associated tickets and historical data."
59575 + },
59576 + {
59577 + "slug": "ZENDESK_GET_DELETION_SCHEDULE",
59578 + "name": "Get Deletion Schedule",
59579 + "description": "Retrieve a specific deletion schedule from Zendesk by its ID. Use this action when you need to get the details of a particular deletion schedule, including its title, description, active status, object type, conditions, and creation/update timestamps. This action is read-only and idempotent."
59580 + },
59581 + {
59582 + "slug": "ZENDESK_GET_DELETION_SCHEDULES",
59583 + "name": "List Deletion Schedules",
59584 + "description": "List all deletion schedules for the current Zendesk account. Use when you need to retrieve, audit, or review the deletion schedule rules configured in your Zendesk account. Deletion schedules define automated data retention policies that periodically remove specified entity types based on configured conditions. Only Zendesk admins can access this endpoint."
59585 + },
59586 + {
59587 + "slug": "ZENDESK_GET_DYNAMIC_CONTENT_ITEMS",
59588 + "name": "List Dynamic Content Items",
59589 + "description": "List all dynamic content items configured in your Zendesk account. Use when you need to enumerate available dynamic content items, check variants for localization, or retrieve metadata about placeholder values for dynamic content. This is a read-only, idempotent operation that supports both cursor and offset pagination."
59590 + },
59591 + {
59592 + "slug": "ZENDESK_GET_DYNAMIC_CONTENT_ITEM_SHOW",
59593 + "name": "Show Dynamic Content Item",
59594 + "description": "Show a specific dynamic content item by its ID. Use when you have a dynamic content item ID and need to retrieve its details, including name, default locale, placeholder value, variants, and creation/update timestamps. This is a read-only, idempotent operation that returns a single dynamic content item."
59595 + },
59596 + {
59597 + "slug": "ZENDESK_GET_DYNAMIC_CONTENT_ITEMS_SHOW_MANY",
59598 + "name": "Show Many Dynamic Content Items",
59599 + "description": "Retrieve multiple dynamic content items by their identifiers. Use when you have specific dynamic content item IDs or names and need to fetch their metadata including placeholder, default locale, variants, and outdated status. This is a read-only, idempotent operation. The 'identifiers' parameter accepts comma-separated values; omit it to retrieve all items (use with caution on accounts with many items)."
59600 + },
59601 + {
59602 + "slug": "ZENDESK_GET_DYNAMIC_CONTENT_ITEMS_VARIANTS",
59603 + "name": "List Dynamic Content Variants",
59604 + "description": "List all variants of a specific Zendesk dynamic content item. Use when you need to retrieve all locale variants for a dynamic content item to view, manage, or update the localized content. Variants represent the same content in different locales/languages. Supports pagination and sorting parameters. This action is read-only and idempotent — calling it multiple times with the same parameters will return the same results without side effects."
59605 + },
59606 + {
59607 + "slug": "ZENDESK_GET_DYNAMIC_CONTENT_ITEM_VARIANT",
59608 + "name": "Show Dynamic Content Item Variant",
59609 + "description": "Show a specific variant of a dynamic content item in Zendesk. Use when you have a dynamic_content_item_id and dynamic_content_variant_id and need to retrieve the variant's details including its content, locale, active status, and timestamps. This is a read-only operation. Dynamic content items allow you to create reusable content that can be localized into multiple variants for different languages or contexts."
59610 + },
59611 + {
59612 + "slug": "ZENDESK_GET_EMAIL_NOTIFICATION",
59613 + "name": "Get Email Notification",
59614 + "description": "Retrieve details of a single email notification in Zendesk by its notification ID. Use when you have a notification_id from ticket audit logs or email notifications list and need to fetch full notification details including recipients, delivery status, and associated ticket/comment information. This action is useful for tracking email delivery status and troubleshooting email notification issues."
59615 + },
59616 + {
59617 + "slug": "ZENDESK_GET_EMAIL_NOTIFICATIONS",
59618 + "name": "Get Email Notifications",
59619 + "description": "List email notifications from Zendesk. Use this action when you need to retrieve email notification records filtered by ticket, comment, or notification ID. The filter parameter is required to specify which type of ID to filter by. Returns delivery status information for each recipient including any delivery failures."
59620 + },
59621 + {
59622 + "slug": "ZENDESK_GET_EMAIL_NOTIFICATIONS_SHOW_MANY",
59623 + "name": "Show Many Email Notifications",
59624 + "description": "Show details of many email notifications in Zendesk. Use when you need to retrieve multiple email notifications at once by their IDs, associated comment IDs, or associated ticket IDs. At least one of the filter parameters (ids, comment_ids, or ticket_ids) is required."
59625 + },
59626 + {
59627 + "slug": "ZENDESK_GET_END_USER_IDENTITIES",
59628 + "name": "List End User Identities",
59629 + "description": "Tool to list all identities associated with a specific end user. Use when you need to retrieve the email addresses and/or phone numbers linked to an end user account. Supports optional filtering by identity type (email, phone_number)."
59630 + },
59631 + {
59632 + "slug": "ZENDESK_GET_END_USER_IDENTITY",
59633 + "name": "Get End User Identity",
59634 + "description": "Tool to fetch a specific end user identity by user ID and identity ID. Use when you need to retrieve detailed information about a particular user identity in Zendesk."
59635 + },
59636 + {
59637 + "slug": "ZENDESK_GET_GROUP_MEMBERSHIP",
59638 + "name": "Get Group Membership",
59639 + "description": "Get a group membership by its unique ID. Use when you have a group membership ID and need to retrieve details including the associated group, user, and timestamps. Note: The group_membership_id parameter is the membership ID, not a group ID."
59640 + },
59641 + {
59642 + "slug": "ZENDESK_GET_GROUP_MEMBERSHIPS",
59643 + "name": "List Group Memberships",
59644 + "description": "List all group memberships in your Zendesk account. Group memberships link users to groups, determining which agents belong to which support groups. Use when you need to audit group assignments, manage team memberships, or enumerate the relationship between users and groups. This action supports both offset pagination (page, per_page) and cursor pagination (page_size, page_after, page_before). It also supports sideloading related users and groups via the include parameter. This action is read-only and idempotent."
59645 + },
59646 + {
59647 + "slug": "ZENDESK_GET_GROUP_MEMBERSHIPS_BY_GROUP",
59648 + "name": "List Memberships By Group",
59649 + "description": "List group memberships for a specific Zendesk group. Use when you need to retrieve all members assigned to a particular group, audit group membership, or understand which users belong to a specific support group. This action is read-only and idempotent. Supports both offset pagination (page, per_page) and cursor pagination (page_size, page_after, page_before). Also supports sideloading users and groups via the include parameter."
59650 + },
59651 + {
59652 + "slug": "ZENDESK_GET_GROUPS_ASSIGNABLE",
59653 + "name": "List Assignable Groups",
59654 + "description": "List all groups that can be assigned to tickets or users in your Zendesk account. Use when you need to enumerate available groups for assignment operations, check group availability, or retrieve group metadata. This is a read-only, idempotent operation."
59655 + },
59656 + {
59657 + "slug": "ZENDESK_GET_GROUPS_COUNT",
59658 + "name": "Count Groups",
59659 + "description": "Count groups in Zendesk. Returns an approximate count of groups in the system. Use when you need to know how many groups exist for reporting, organizational management, or operational purposes. This action is read-only and idempotent."
59660 + },
59661 + {
59662 + "slug": "ZENDESK_GET_GROUPS_USERS_COUNT",
59663 + "name": "Count Users by Group",
59664 + "description": "Count users in a specific Zendesk group. Returns an approximate count of users belonging to the specified group, with optional filtering by role or permission set. Use when you need to know how many users are in a particular group for reporting, resource planning, or administrative purposes. This action is read-only and idempotent."
59665 + },
59666 + {
59667 + "slug": "ZENDESK_GET_GROUP_USERS",
59668 + "name": "List Group Users",
59669 + "description": "List all users belonging to a specific Zendesk group. Use when you need to retrieve all members of a particular group, with optional filtering by user role, permission set, or external ID. This action is read-only and idempotent."
59670 + },
59671 + {
59672 + "slug": "ZENDESK_GET_GUIDE_SURVEY_RESPONSES",
59673 + "name": "List Guide Survey Responses",
59674 + "description": "List survey responses from Zendesk Guide. Use when you need to retrieve CSAT survey responses, analyze customer satisfaction scores, or monitor survey completion rates. Survey responses are available on Support Professional plan and above, and Zendesk Suite Growth plan and above. This action is read-only and idempotent."
59675 + },
59676 + {
59677 + "slug": "ZENDESK_GET_GUIDE_SURVEYS",
59678 + "name": "List Guide Surveys",
59679 + "description": "List available CSAT (Customer Satisfaction) surveys in Zendesk Guide. Use when you need to retrieve survey definitions, check which surveys are enabled/disabled, or get survey questions and versions. The response includes survey IDs, states, creation timestamps, and question arrays. This is a read-only, idempotent operation."
59680 + },
59681 + {
59682 + "slug": "ZENDESK_GET_INCREMENTAL_ORGANIZATIONS",
59683 + "name": "Get Incremental Organizations",
59684 + "description": "Retrieve organizations that have been modified since a specified start time using the Incremental Organization Export API. Use when you need to sync or track changes to Zendesk organizations over time. Provide a start_time (Unix timestamp) from a previous response's end_time to paginate through changes incrementally. This action is read-only and idempotent. Organizations may be created, updated, or appear as deleted; interpret based on your use case. Rate limiting may apply for large accounts."
59685 + },
59686 + {
59687 + "slug": "ZENDESK_GET_INCREMENTAL_ROUTING_ATTRIBUTES",
59688 + "name": "Incremental Routing Attributes Export",
59689 + "description": "Export routing attributes incrementally with optional start_time filtering and cursor-based pagination. Use when you need to retrieve all skill-based routing attributes (attributes, attribute values, and instance values) that have changed in your Zendesk account. This is a read-only operation that returns a stream of changes; it does not include data from the most recent minute. For large datasets, use cursor-based pagination with the after_cursor value from responses. This action is read-only and idempotent — calling it multiple times with the same start_time returns the same results."
59690 + },
59691 + {
59692 + "slug": "ZENDESK_GET_INCREMENTAL_ROUTING_ATTRIBUTE_VALUES",
59693 + "name": "Get Incremental Routing Attribute Values",
59694 + "description": "Retrieve routing attribute values that have been modified since a specified start time using the Incremental Skill-Based Routing API. Use when you need to sync or track changes to routing attributes, values, and their associations over time. Provide a start_time (Unix timestamp) and the API returns all attribute values modified since that time. Call repeatedly with the end_time from each response to paginate through all changes. This action is read-only and idempotent. Note: Data isn't available for the most recent minute due to eventual consistency. Attribute values may appear as modified; interpret based on your use case."
59695 + },
59696 + {
59697 + "slug": "ZENDESK_GET_INCREMENTAL_ROUTING_INSTANCE_VALUES",
59698 + "name": "Export Incremental Routing Instance Values",
59699 + "description": "Export incremental routing instance values from Zendesk skill-based routing. Returns a stream of changes that occurred on routing attributes, attribute values, and instance values. Use this action when you need to synchronize routing configuration data or monitor changes to skill-based routing assignments. This action is read-only and supports cursor-based pagination with a maximum of 3000 records per page. Stop paging when the count is 0. Note: The cursor parameter is read-only and should only be obtained from API responses, not manually constructed."
59700 + },
59701 + {
59702 + "slug": "ZENDESK_GET_INCREMENTAL_SAMPLE",
59703 + "name": "Get Incremental Sample Export",
59704 + "description": "Test the incremental export by retrieving a sample of records that have changed since a specified start time. Use this action to verify your incremental export setup before running full exports. Use when you need to test the incremental export functionality for a specific resource type (e.g., tickets, users, organizations). The sample export returns a limited set of records that can help you validate data retrieval before implementing full sync operations. Note that data isn't provided for the most recent minute, and the start_time must be at least one minute in the past."
59705 + },
59706 + {
59707 + "slug": "ZENDESK_GET_INCREMENTAL_TICKET_EVENTS",
59708 + "name": "Get Incremental Ticket Events",
59709 + "description": "Export incremental ticket events from Zendesk. Use when you need to track changes to tickets over time, monitor agent performance metrics, or sync ticket event data with an external system. This action returns a stream of ticket metric events (like agent work time, reply times) that occurred after the specified start_time. Call repeatedly with the end_time from each response to continue exporting events. Data isn't available for the most recent minute due to eventual consistency. Note: This is a read-only, idempotent operation. The start_time must be at least one minute in the past."
59710 + },
59711 + {
59712 + "slug": "ZENDESK_GET_INCREMENTAL_TICKET_METRIC_EVENTS",
59713 + "name": "List Ticket Metric Events",
59714 + "description": "List ticket metric events in Zendesk that occurred on or after a specified time. This action supports incremental data export — use the end_time from one response as the start_time for the next request to retrieve subsequent events. This action is read-only and idempotent — use it to monitor ticket metrics, track SLA compliance, or build analytics dashboards. Note: deleted tickets can create orphan metric events; use exclude_deleted=true to filter these out."
59715 + },
59716 + {
59717 + "slug": "ZENDESK_GET_INCREMENTAL_TICKETS",
59718 + "name": "Get Incremental Tickets",
59719 + "description": "Retrieve tickets that have been modified since a specified start time using the Incremental Ticket Export API. Use when you need to sync or track changes to Zendesk tickets over time, build audit trails, or implement incremental backups. Provide a start_time (Unix timestamp) from a previous response's end_time to paginate through changes incrementally. This action is read-only and idempotent. Tickets may be created, updated, or appear as changed; interpret based on your use case. Rate limiting may apply for large accounts. Note: Data isn't provided for the most recent minute."
59720 + },
59721 + {
59722 + "slug": "ZENDESK_GET_INCREMENTAL_TICKETS_CURSOR",
59723 + "name": "Get Incremental Tickets (Cursor)",
59724 + "description": "Export tickets incrementally using cursor-based pagination. Use this action when you need to retrieve all changes to tickets since a specific time, with support for large result sets through cursor-based pagination. The start_time parameter is required for the initial request; subsequent pages use the cursor returned in previous responses. Use when you need to sync ticket data from Zendesk, maintaining a real-time or near-real-time copy of ticket information. This is ideal for data synchronization, backup systems, or analytics pipelines that need to process all ticket changes over time. The action automatically handles pagination by providing cursor tokens in the response."
59725 + },
59726 + {
59727 + "slug": "ZENDESK_GET_INCREMENTAL_USERS",
59728 + "name": "Get Incremental Users",
59729 + "description": "Retrieve users that have been modified since a specified start time using the Incremental User Export API. Use when you need to sync or track changes to Zendesk users over time, such as for data warehousing, backup, or external system synchronization. Provide a start_time (Unix timestamp) and the API returns users that have been created, updated, or deleted since that time. Call repeatedly with the end_time from each response to paginate through all changes. This action is read-only and idempotent. Note: Data isn't available for the most recent minute due to eventual consistency. Users may appear as modified or deleted; interpret based on your use case."
59730 + },
59731 + {
59732 + "slug": "ZENDESK_GET_INCREMENTAL_USERS_CURSOR",
59733 + "name": "Incremental User Export (Cursor)",
59734 + "description": "Export users incrementally using cursor-based pagination. Use when you need to export all users from Zendesk in a reliable, paginated manner. The start_time parameter is required for the initial request to define the time range. Subsequent requests use the cursor returned in previous responses to fetch the next batch of records. This action is ideal for: - Full user data synchronization to external systems - Regular incremental backups of user data - Building user directories with pagination support Note: Data from the most recent minute is not included to ensure consistency."
59735 + },
59736 + {
59737 + "slug": "ZENDESK_GET_JOB_STATUSES",
59738 + "name": "List Job Statuses",
59739 + "description": "List job statuses from Zendesk. Shows the status of all background jobs that have been initiated, including those created by bulk operations like bulk updates, imports, or exports. Each job status includes progress information, completion status, and any results from individual tasks. Use this action to track the progress of long-running operations or check if background tasks completed successfully. Use this action when you need to check the status of background jobs, monitor bulk operation progress, or verify that asynchronous tasks have finished processing."
59740 + },
59741 + {
59742 + "slug": "ZENDESK_GET_JOB_STATUSES2",
59743 + "name": "Get Job Status",
59744 + "description": "Get a single job status by ID from Zendesk. Shows the status of a background job initiated by bulk operations (like bulk updates, imports, or exports). The response includes progress information, completion status, and any results from individual tasks. Use this action when you have a job_status_id from a previously queued bulk operation and need to check if it completed successfully, failed, or is still processing. Check the 'status' field for the current state ('queued', 'working', 'completed', 'failed') and the 'results' array for individual task outcomes."
59745 + },
59746 + {
59747 + "slug": "ZENDESK_GET_LOCALE",
59748 + "name": "Get Locale",
59749 + "description": "Get a locale by its ID or BCP-47 code. Use when you need to retrieve details about a specific locale including the locale identifier, language name, and timestamps."
59750 + },
59751 + {
59752 + "slug": "ZENDESK_GET_LOCALES",
59753 + "name": "List Locales",
59754 + "description": "List all translation locales available for your Zendesk account. Use when you need to retrieve the available locales for translation purposes, check which languages are enabled, or get locale metadata including the locale code, display name, and creation timestamps. This is a read-only, idempotent operation that supports pagination."
59755 + },
59756 + {
59757 + "slug": "ZENDESK_GET_LOCALES_AGENT",
59758 + "name": "List Agent Locales",
59759 + "description": "List the translation locales that have been localized for agent use. Use when you need to discover which locales are available for agents to work with in multilingual support scenarios. This is a read-only, idempotent operation that requires no parameters."
59760 + },
59761 + {
59762 + "slug": "ZENDESK_GET_LOCALES_CURRENT",
59763 + "name": "Get Current Locale",
59764 + "description": "Show the current locale for a Zendesk account. Use when you need to determine what language/locale is currently active for the account, which affects how content is displayed to end users and which translations are available."
59765 + },
59766 + {
59767 + "slug": "ZENDESK_GET_MACRO2",
59768 + "name": "Show Macro",
59769 + "description": "Show a specific macro by its ID. Use when you need to retrieve details of a single macro in your Zendesk account, such as for auditing, modifying, or understanding what actions and conditions are configured for a particular macro. Macros are saved response templates that agents can apply to tickets. Supports optional sideloads for usage statistics and additional metadata via the `include` parameter."
59770 + },
59771 + {
59772 + "slug": "ZENDESK_GET_MACRO_ATTACHMENTS",
59773 + "name": "List Macro Attachments",
59774 + "description": "List all attachments associated with a specific Zendesk macro. Use when you need to retrieve the files attached to a macro, such as images used in macro content or documents included in automated responses. This is a read-only operation that returns the attachment metadata including filename, content type, size, and download URL."
59775 + },
59776 + {
59777 + "slug": "ZENDESK_GET_MACRO_CATEGORIES",
59778 + "name": "List Macro Categories",
59779 + "description": "List all macro categories available to the current Zendesk account. Use when you need to retrieve or browse available macro categories for organizing and applying macros to tickets. This action is read-only and idempotent."
59780 + },
59781 + {
59782 + "slug": "ZENDESK_GET_MACRO_DEFINITIONS",
59783 + "name": "List Macro Action Definitions",
59784 + "description": "Retrieve the definitions of all actions that a macro can perform in Zendesk. Use this action when you need to discover what actions are available for macro creation, understand the available values for each action type, or build a macro configuration interface. The response includes action fields, their display titles, types, and available value options. Common macro actions include: setting ticket status, priority, or type; assigning agents or groups; adding/removing tags; setting custom fields; and adding comments."
59785 + },
59786 + {
59787 + "slug": "ZENDESK_GET_MACRO_REPLICA",
59788 + "name": "Show Macro Replica",
59789 + "description": "Show a macro replica (unpersisted macro representation) based on a macro ID and ticket ID. Use when you need to preview how a macro will look when applied to a specific ticket, allowing you to see the actions and values that will be applied without actually applying the macro. This is useful for testing macro configurations or displaying macro previews in your interface. This action is read-only and idempotent."
59790 + },
59791 + {
59792 + "slug": "ZENDESK_GET_MACROS",
59793 + "name": "List Macros",
59794 + "description": "List all shared and personal macros available in your Zendesk account. Use when you need to retrieve, audit, or review the macros configured for automating ticket responses and actions. Macros are saved response templates that agents can apply to tickets. Supports filtering by access level, active status, category, and group. Results can be sorted by name, creation date, update date, or usage statistics."
59795 + },
59796 + {
59797 + "slug": "ZENDESK_GET_MACROS_ACTIONS",
59798 + "name": "List Macro Actions",
59799 + "description": "List supported actions for macros in Zendesk. Use when you need to discover what field modifications are available when creating or editing macros. This endpoint returns the available action fields that can be set in a macro (e.g., status, priority, assignee, etc.) along with their possible values. This is useful for validating macro configurations or building macro management interfaces. This action is read-only and idempotent."
59800 + },
59801 + {
59802 + "slug": "ZENDESK_GET_MACROS_ACTIVE",
59803 + "name": "List Active Macros",
59804 + "description": "List all active shared and personal macros in Zendesk. Use when you need to retrieve, audit, or review the macros configured in your Zendesk account. Macros are saved responses that agents can apply to tickets. This action supports filtering by access level, category, group, and sorting options. Note: This action only returns active macros. The sort_by parameter supports sorting by usage metrics (usage_1h, usage_24h, usage_7d, usage_30d) to identify the most frequently used macros."
59805 + },
59806 + {
59807 + "slug": "ZENDESK_GET_MACROS_APPLY",
59808 + "name": "Show Changes to Ticket",
59809 + "description": "Show changes to a ticket that would result from applying a macro. Use when you need to preview what changes a macro would make to a ticket before actually applying it. This allows you to review the changes that would be applied, such as assignee changes, group reassignments, comments, or custom field updates. This action is read-only and idempotent — it does not actually modify the ticket."
59810 + },
59811 + {
59812 + "slug": "ZENDESK_GET_MACROS_SEARCH",
59813 + "name": "Search Macros",
59814 + "description": "Search for Zendesk macros by their title. Use when you need to find macros in your Zendesk account by searching for keywords in their titles. Macros are pre-defined responses or actions that can be applied to tickets to automate repetitive tasks. This action supports filtering by access, active status, category, and group, as well as sorting results."
59815 + },
59816 + {
59817 + "slug": "ZENDESK_GET_OBJECT_TRIGGER",
59818 + "name": "Show Object Trigger",
59819 + "description": "Show a specific trigger for a custom object in Zendesk. Use when you need to retrieve details of a single trigger, such as for auditing, understanding its conditions and actions, or preparing modifications. This action is read-only and idempotent."
59820 + },
59821 + {
59822 + "slug": "ZENDESK_GET_OPEN_REQUESTS",
59823 + "name": "List Open Requests",
59824 + "description": "List open requests from Zendesk. Use this action when you need to retrieve all requests with \"open\" status for the authenticated user. Supports sorting by creation date or last update time. This action is read-only and idempotent."
59825 + },
59826 + {
59827 + "slug": "ZENDESK_GET_ORGANIZATION_FIELD2",
59828 + "name": "Get Organization Field",
59829 + "description": "Get details for a specific organization field in Zendesk by its ID or key. Use this action when you need to retrieve detailed information about a single custom organization field, including its type, options, validation rules, and display settings. This is useful for understanding field configuration or before updating/deleting a field. Returns the complete organization field definition with all metadata."
59830 + },
59831 + {
59832 + "slug": "ZENDESK_GET_ORGANIZATION_FIELDS",
59833 + "name": "List Organization Fields",
59834 + "description": "List all custom organization fields for the Zendesk account. Use this action when you need to retrieve or audit the custom organization field definitions configured in your Zendesk instance. Organization fields are used to store additional metadata about organizations beyond the standard attributes. Supports cursor-based pagination for retrieving large numbers of fields. Use resolve_dc=true to get resolved dynamic content placeholders instead of raw template strings."
59835 + },
59836 + {
59837 + "slug": "ZENDESK_GET_ORGANIZATION_MEMBERSHIP2",
59838 + "name": "Get Organization Membership",
59839 + "description": "Get details for a specific organization membership by its ID. Use when you have an organization membership ID and need to retrieve the associated user, organization, and membership metadata. This action is read-only and idempotent - calling it multiple times with the same membership ID will return the same result."
59840 + },
59841 + {
59842 + "slug": "ZENDESK_GET_ORGANIZATION_RELATED",
59843 + "name": "Get Organization Related Info",
59844 + "description": "Get related counts and information for a specific Zendesk organization by ID. Returns metadata about tickets, users, groups, activities, and other related resources associated with the organization. Use when you need to understand the scale and composition of an organization's resources in Zendesk. This is a read-only, idempotent operation."
59845 + },
59846 + {
59847 + "slug": "ZENDESK_GET_ORGANIZATION_REQUESTS",
59848 + "name": "List Organization Requests",
59849 + "description": "List requests for a specific Zendesk organization. Use when you need to retrieve all requests associated with a particular organization. This action returns request details including subject, status, priority, requester, and timestamps. Pagination is available for large result sets."
59850 + },
59851 + {
59852 + "slug": "ZENDESK_GET_ORGANIZATIONS_AUTOCOMPLETE",
59853 + "name": "Autocomplete Organizations",
59854 + "description": "Search for Zendesk organizations using autocomplete. Use when you need to find organization suggestions based on a partial organization name for ticket creation, user assignment, or organization lookup. The `name` parameter is required - provide at least a few characters for meaningful autocomplete results. Returns organizations sorted by relevance."
59855 + },
59856 + {
59857 + "slug": "ZENDESK_GET_ORGANIZATIONS_MERGES",
59858 + "name": "List Organization Merges",
59859 + "description": "List all organization merge operations for a specific organization in Zendesk. This action retrieves the merge history showing which organizations were merged into or out of the specified organization. Use this action when you need to audit organization merge history or track the consolidation of organizations. Supports pagination to handle large result sets efficiently. This is a read-only, idempotent operation."
59860 + },
59861 + {
59862 + "slug": "ZENDESK_GET_ORGANIZATIONS_SHOW_MANY",
59863 + "name": "Show Many Organizations",
59864 + "description": "Show many Zendesk organizations by their IDs or external IDs. Use when you need to retrieve multiple organizations in a single API call. Accepts up to 100 organization IDs or external IDs as comma-separated lists. Only one of ids or external_ids should be provided. Returns organization objects with all standard fields including name, domain_names, tags, and organization_fields."
59865 + },
59866 + {
59867 + "slug": "ZENDESK_GET_ORGANIZATIONS_TICKETS_COUNT",
59868 + "name": "Count Organization Tickets",
59869 + "description": "Count organization tickets in Zendesk. Returns an approximate count of tickets for a specific organization. Use when you need to know how many tickets are associated with an organization for reporting or operational purposes."
59870 + },
59871 + {
59872 + "slug": "ZENDESK_GET_ORGANIZATION_SUBSCRIPTION",
59873 + "name": "Get Organization Subscription",
59874 + "description": "Show Organization Subscription - retrieves details of a specific organization subscription by its ID. Use when you need to get information about an organization subscription, including the associated user and organization IDs, and the creation timestamp. This is a read-only operation that does not modify any data."
59875 + },
59876 + {
59877 + "slug": "ZENDESK_GET_ORGANIZATION_SUBSCRIPTIONS",
59878 + "name": "List Organization Subscriptions",
59879 + "description": "List Organization Subscriptions in Zendesk. Returns organization subscriptions with pagination support (cursor and offset). Use when you need to retrieve all organization subscriptions or need to paginate through results. End users only see their own subscriptions."
59880 + },
59881 + {
59882 + "slug": "ZENDESK_GET_ORGANIZATION_TAGS",
59883 + "name": "Get Organization Tags",
59884 + "description": "List all tags associated with a specific Zendesk organization. Use when you need to retrieve the tags assigned to a particular organization for ticket categorization, filtering, or reporting purposes."
59885 + },
59886 + {
59887 + "slug": "ZENDESK_GET_ORGANIZATION_TICKETS",
59888 + "name": "Get Organization Tickets",
59889 + "description": "Get tickets for a specific organization in Zendesk. Returns tickets where organization_id matches the specified organization. Use when you need to retrieve all tickets associated with a particular organization, such as for reporting or review purposes. Pagination is available for large result sets; follow next_page links until null to retrieve all tickets. Note: This endpoint returns organization tickets that may include tickets from multiple requesters within the organization."
59890 + },
59891 + {
59892 + "slug": "ZENDESK_GET_ORGANIZATION_USERS",
59893 + "name": "List Organization Users",
59894 + "description": "List all users associated with a specific Zendesk organization. Returns a paginated list of users who are members of the organization. Use when you need to see all users belonging to a particular organization, retrieve organization membership information, or audit organization access. Supports filtering by role, permission sets, and external IDs. Supports pagination via page number or cursor-based pagination."
59895 + },
59896 + {
59897 + "slug": "ZENDESK_GET_ORGANIZATION_USERS_COUNT",
59898 + "name": "Count Organization Users",
59899 + "description": "Count users in a specific Zendesk organization by ID. Returns an approximate count of users. Use when you need to know how many users belong to a particular organization for reporting or operational purposes."
59900 + },
59901 + {
59902 + "slug": "ZENDESK_GET_OWNED_APPS",
59903 + "name": "Get Owned Apps",
59904 + "description": "List apps owned by the current Zendesk account. Use when you need to retrieve information about apps installed in your Zendesk instance, such as checking installed apps, reviewing app details (version, status, author), or auditing your app inventory. This endpoint requires admin authentication."
59905 + },
59906 + {
59907 + "slug": "ZENDESK_GET_PROBLEMS",
59908 + "name": "List Ticket Problems",
59909 + "description": "List Zendesk ticket problems. Use when you need to retrieve all tickets of type 'problem' in your Zendesk account. The response is always ordered by updated_at by default; use sort_by and sort_order parameters to customize. Supports both offset and cursor-based pagination. Note: Problems are tickets with type='problem'. This endpoint specifically returns problem-type tickets which are linked to other incidents that share the same root cause."
59910 + },
59911 + {
59912 + "slug": "ZENDESK_GET_PUBLIC_LOCALES",
59913 + "name": "List Public Locales",
59914 + "description": "List all available public locales that can be used for translations in Zendesk. Use when you need to enumerate supported languages/locales for your Zendesk account, display language options to users, or determine which locales are available for ticket or article translations. This is a read-only, idempotent operation that returns the complete list of public locales with no pagination parameters."
59915 + },
59916 + {
59917 + "slug": "ZENDESK_GET_RECENT_TICKETS",
59918 + "name": "Get Recent Tickets",
59919 + "description": "List recently viewed tickets in Zendesk. Returns tickets sorted by the time they were last viewed, most recent first. Useful for agents to quickly access tickets they've been working on. The endpoint returns tickets visible to the agent based on their permission restrictions. Pagination is limited to 10,000 records (100 pages * 100 per page). Use this action to retrieve the tickets an agent has recently accessed in the Zendesk interface."
59920 + },
59921 + {
59922 + "slug": "ZENDESK_GET_REMOTE_AUTHENTICATIONS",
59923 + "name": "List Remote Authentications",
59924 + "description": "List all remote authentication configurations in your Zendesk account. Use this action when you need to enumerate SSO configurations, check which authentication methods are enabled, or retrieve metadata about remote authentication settings for agents and end users. This is a read-only, idempotent operation that returns all configured remote authentication providers including SAML, LDAP, JWT, and OAuth configurations."
59925 + },
59926 + {
59927 + "slug": "ZENDESK_GET_REQUEST_COMMENTS",
59928 + "name": "List Request Comments",
59929 + "description": "List comments on a Zendesk request. Use when you need to retrieve all comments from a specific ticket request to understand the conversation history or gather context for responding. The comments are returned in chronological order. Each comment includes author information, content (both plain text and HTML formats), attachments, and metadata about how and when it was created."
59930 + },
59931 + {
59932 + "slug": "ZENDESK_GET_REQUESTS_CCDB",
59933 + "name": "List CCD Requests",
59934 + "description": "List CCD Requests. Use when you need to retrieve requests where the authenticated end user is listed as a CC (carbon copy) recipient. These are requests the user is watching but did not create. Supports sorting by creation or update timestamps."
59935 + },
59936 + {
59937 + "slug": "ZENDESK_GET_REQUESTS_COMMENT",
59938 + "name": "Get Request Comment",
59939 + "description": "Get a specific comment from a Zendesk request. Use when you need to retrieve a single comment by its ID for a given request, such as displaying a specific comment detail or checking comment metadata. This action is read-only and idempotent."
59940 + },
59941 + {
59942 + "slug": "ZENDESK_GET_REQUESTS_SEARCH",
59943 + "name": "Search Requests",
59944 + "description": "Search for requests in Zendesk using query syntax. Use when you need to find customer requests across Zendesk using flexible search criteria such as status, priority, subject, or requester information. Returns paginated results with request details. This action is read-only and idempotent - searching for requests does not modify any data."
59945 + },
59946 + {
59947 + "slug": "ZENDESK_GET_REQUESTS_SOLVED",
59948 + "name": "List Solved Requests",
59949 + "description": "List Zendesk requests with the 'solved' status. Useful for reviewing completed customer requests, generating reports on resolution times, or tracking customer satisfaction. Use this action when you need to retrieve requests that have been marked as solved."
59950 + },
59951 + {
59952 + "slug": "ZENDESK_GET_ROUTING_AGENTS_INSTANCE_VALUES",
59953 + "name": "Get Agent Attribute Values",
59954 + "description": "Retrieve attribute values for multiple agents/users using the Skill-Based Routing API. Use when you need to get the routing attribute values (such as skills, languages, or other qualifications) assigned to specific agents. This action is read-only and idempotent. Note: This action returns only the attribute values directly assigned to the agents. It does not include inherited or group-based attributes."
59955 + },
59956 + {
59957 + "slug": "ZENDESK_GET_SATISFACTION_RATINGS",
59958 + "name": "List Satisfaction Ratings",
59959 + "description": "List satisfaction ratings for tickets in Zendesk. Use when you need to retrieve customer satisfaction feedback, analyze CSAT scores, or review ratings with their associated tickets and assignees. Supports both offset and cursor pagination for large datasets."
59960 + },
59961 + {
59962 + "slug": "ZENDESK_GET_SATISFACTION_RATINGS_COUNT",
59963 + "name": "Count Satisfaction Ratings",
59964 + "description": "Count satisfaction ratings in Zendesk. Returns an approximate count of satisfaction ratings. Use when you need to know how many satisfaction ratings exist for reporting or operational purposes."
59965 + },
59966 + {
59967 + "slug": "ZENDESK_GET_SEARCH_COUNT",
59968 + "name": "Get Search Results Count",
59969 + "description": "Count the number of items matching a search query in Zendesk. Use when you need to know how many results a search would return without fetching all the actual results. This is useful for displaying result counts before executing a full search."
59970 + },
59971 + {
59972 + "slug": "ZENDESK_GET_SEARCH_EXPORT",
59973 + "name": "Export Search Results",
59974 + "description": "Export search results from Zendesk using cursor-based pagination. Use when you need to export large sets of search results (tickets, users, organizations, groups) and process them in batches using cursor pagination. This action differs from the regular search endpoint by supporting cursor-based pagination instead of offset pagination, making it more efficient for large datasets. The 'page_after' parameter in responses contains the cursor token for fetching subsequent pages."
59975 + },
59976 + {
59977 + "slug": "ZENDESK_GET_SECURITY_SETTINGS",
59978 + "name": "Get Security Settings",
59979 + "description": "Show Security Settings for a Zendesk account. Use when you need to retrieve the security configuration of a Zendesk account, including session timeouts, password policies, two-factor authentication settings, IP restrictions, and account assumption options. This is a read-only, idempotent operation that does not modify any data. This action is useful for auditing security settings, verifying compliance requirements, or understanding the security posture of a Zendesk account."
59980 + },
59981 + {
59982 + "slug": "ZENDESK_GET_SIDE_CONVERSATIONS_EVENTS",
59983 + "name": "List Side Conversation Events",
59984 + "description": "Retrieve side conversation events for incremental export. Returns events created since the specified start_time in chronological order. Use when you need to export or sync side conversation events for backup, analytics, or integration purposes. This action supports pagination via the next_page URL which contains a next_start_time parameter — pass that timestamp as start_time for subsequent requests. Only available to Admins. Note: This is a read-only, idempotent action suitable for building event pipelines or audit trails."
59985 + },
59986 + {
59987 + "slug": "ZENDESK_GET_SUPPORT_ADDRESS",
59988 + "name": "Get Support Address",
59989 + "description": "Get a support address by its unique ID. Use when you have a support_address_id and need to retrieve details including the email address, brand association, and DNS verification statuses. This is a read-only operation."
59990 + },
59991 + {
59992 + "slug": "ZENDESK_GET_TAGS",
59993 + "name": "List Tags",
59994 + "description": "List Zendesk tags in order of popularity. Use when you need to view all available tags in your Zendesk account, or when you need to find tags that are most frequently used across tickets."
59995 + },
59996 + {
59997 + "slug": "ZENDESK_GET_TAGS_COUNT",
59998 + "name": "Count Tags",
59999 + "description": "Count Tags in Zendesk. Returns an approximate count of tags. Use when you need to know how many tags exist in your Zendesk account for reporting or operational purposes."
60000 + },
60001 + {
60002 + "slug": "ZENDESK_GET_TARGET",
60003 + "name": "Show Target",
60004 + "description": "Show a specific target by its ID. Use when you have a target ID and need to retrieve its details including title, type, active status, and creation timestamp. This is a read-only, idempotent operation that returns a single target object. This action is irreversible for data retrieval - it only reads target information, no destructive changes occur."
60005 + },
60006 + {
60007 + "slug": "ZENDESK_GET_TARGET_FAILURE",
60008 + "name": "Show Target Failure",
60009 + "description": "Show a target failure in Zendesk. Use when you have a target_failure_id and need to retrieve details about a failed target execution, including the HTTP status code, raw request/response data, and consecutive failure count. This is a read-only operation."
60010 + },
60011 + {
60012 + "slug": "ZENDESK_GET_TARGET_FAILURES",
60013 + "name": "List Target Failures",
60014 + "description": "List the 25 most recent target failures in Zendesk. Target failures occur when a target (webhook, callback, or external integration) fails to execute properly. Each failure record includes the request sent, response received, and status code. Use this action to monitor and troubleshoot failing integrations."
60015 + },
60016 + {
60017 + "slug": "ZENDESK_GET_TARGETS",
60018 + "name": "List Targets",
60019 + "description": "List all targets for the current Zendesk account. Use when you need to retrieve, audit, or review the targets configured in your Zendesk account. Targets are endpoints that receive data when triggers or automations fire. This is a read-only, idempotent action with no required parameters."
60020 + },
60021 + {
60022 + "slug": "ZENDESK_GET_TICKET_AUDIT_BY_ID",
60023 + "name": "Get Ticket Audit",
60024 + "description": "Show a specific audit for a ticket from Zendesk. Returns a single audit record containing events that describe changes made to the ticket. Each audit captures a specific action such as comments, status changes, assignments, or field updates. Use this action when you have a specific audit ID and want to retrieve detailed information about that audit event. Use this action when you need to retrieve detailed information about a specific audit record for a ticket, including all events and metadata associated with that audit."
60025 + },
60026 + {
60027 + "slug": "ZENDESK_GET_TICKET_COLLABORATORS",
60028 + "name": "List Ticket Collaborators",
60029 + "description": "List all collaborators (CC'd users) on a Zendesk ticket. Use when you need to see who is currently CC'd on a ticket, such as when coordinating with multiple stakeholders or before adding/removing collaborators. Each collaborator is a user object with basic profile information. Paginate through results using page and per_page parameters."
60030 + },
60031 + {
60032 + "slug": "ZENDESK_GET_TICKET_COMMENTS",
60033 + "name": "Get Ticket Comments",
60034 + "description": "List comments on a Zendesk ticket. Returns the comments added to the ticket in chronological order (oldest first by default). Each comment has both `html_body` and `plain_body` fields — use `plain_body` for clean text without HTML. Public comments are visible to end users while internal comments are only visible to agents. Use the `include_inline_images` parameter to include inline images as attachments. For bulk operations, honor `Retry-After` headers on HTTP 429 rate limit responses."
60035 + },
60036 + {
60037 + "slug": "ZENDESK_GET_TICKET_EMAIL_C_CS",
60038 + "name": "List Ticket Email CCs",
60039 + "description": "List Email CCs for a Ticket. Use when you need to retrieve a list of users who are CC'd on a specific Zendesk ticket. This endpoint returns all email CC records associated with the ticket, including user details and timestamps."
60040 + },
60041 + {
60042 + "slug": "ZENDESK_GET_TICKET_FIELD2",
60043 + "name": "Show Ticket Field",
60044 + "description": "Show a specific ticket field by its ID. Use when you need to retrieve details of a single ticket field in your Zendesk account, such as for auditing, understanding field configuration, or validating field properties. This action is read-only and idempotent."
60045 + },
60046 + {
60047 + "slug": "ZENDESK_GET_TICKET_FIELDS",
60048 + "name": "List Ticket Fields",
60049 + "description": "List all system and custom ticket fields in Zendesk. Use when you need to retrieve field definitions for building forms, validating field values, or understanding available ticket field structure. Supports cursor-based pagination for large datasets. When creator=true is specified, includes creator_user_id and creator_app_name for each field. Locale parameter affects dynamic content variants for title_in_portal."
60050 + },
60051 + {
60052 + "slug": "ZENDESK_GET_TICKET_FIELDS_COUNT",
60053 + "name": "Count Ticket Fields",
60054 + "description": "Count ticket fields in Zendesk. Returns an approximate count of system and custom ticket fields. Use when you need to know how many ticket fields exist for reporting or operational purposes."
60055 + },
60056 + {
60057 + "slug": "ZENDESK_GET_TICKET_FIELDS_SHOW_MANY",
60058 + "name": "Show Many Ticket Fields",
60059 + "description": "Retrieve multiple ticket fields by their IDs or keys in a single request. Use when you have specific ticket field identifiers (numeric IDs like '123' or keys like 'priority', 'status', 'subject') and need to fetch their complete metadata including type, title, required status, custom options, and portal visibility settings. This is a read-only, idempotent operation. Up to 100 fields can be retrieved per request. Either `ids` or `keys` parameter can be used, but not both simultaneously."
60060 + },
60061 + {
60062 + "slug": "ZENDESK_GET_TICKET_FOLLOWERS",
60063 + "name": "List Ticket Followers",
60064 + "description": "List all followers on a Zendesk ticket. Use when you need to see who is following a ticket, such as when coordinating with stakeholders or managing ticket notifications. Followers receive notifications about the ticket. Each follower is a user object with basic profile information. Paginate through results using page and per_page parameters."
60065 + },
60066 + {
60067 + "slug": "ZENDESK_GET_TICKET_FORMS",
60068 + "name": "List Ticket Forms",
60069 + "description": "List all ticket forms configured in your Zendesk account. Use when you need to enumerate available ticket forms, retrieve form metadata like display names and visibility settings, or audit which ticket forms are active and visible to end users or agents. Supports filtering by active status, end-user visibility, form type (standard or service catalog), and brand association. Also supports both traditional offset pagination and cursor-based pagination."
60070 + },
60071 + {
60072 + "slug": "ZENDESK_GET_TICKET_FORMS_SHOW_MANY",
60073 + "name": "Show Many Ticket Forms",
60074 + "description": "Show multiple ticket forms by their IDs. Use when you need to retrieve specific ticket forms by their IDs to display form details, validate form availability, or bulk fetch form configurations. The `ids` parameter accepts a comma-separated list of ticket form IDs (e.g., '1,2,3'). Returns an empty ticket_forms array for non-existent IDs without error. Supports optional filtering by active status, end-user visibility, brand association, and default form fallback behavior."
60075 + },
60076 + {
60077 + "slug": "ZENDESK_GET_TICKET_INCIDENTS",
60078 + "name": "List Ticket Incidents",
60079 + "description": "List incidents linked to a problem ticket in Zendesk. Use when you need to retrieve all incident tickets that share the same root cause as a problem ticket. Incidents are tickets of type 'incident' that are related to a problem ticket via the problem_id field. Supports both offset and cursor-based pagination."
60080 + },
60081 + {
60082 + "slug": "ZENDESK_GET_TICKET_METRIC",
60083 + "name": "Get Ticket Metric",
60084 + "description": "Retrieve a specific ticket metric from Zendesk by its ID. Use this action when you have a ticket_metric_id and need to fetch the detailed metrics for that ticket, including resolution times, wait times, reply times, and SLA breaches. This action is read-only and idempotent — fetching the same metric multiple times has no side effects."
60085 + },
60086 + {
60087 + "slug": "ZENDESK_GET_TICKET_METRICS",
60088 + "name": "Get Ticket Metrics",
60089 + "description": "List Ticket Metrics from Zendesk. Returns a list of tickets with their associated metrics including response times, resolution times, and assignment statistics. Use when analyzing ticket performance, agent productivity, or customer satisfaction metrics. This action supports cursor-based pagination via page_size, page_after, and page_before parameters for efficient traversal of large datasets."
60090 + },
60091 + {
60092 + "slug": "ZENDESK_GET_TICKETS_AUDITS",
60093 + "name": "List Ticket Audits",
60094 + "description": "List all audits (change history) for a specific Zendesk ticket. Use when you need to track all changes made to a ticket including comments, status changes, assignments, and other modifications. Each audit contains one or more events representing individual changes. This action is read-only and supports both traditional offset pagination and cursor-based pagination for large datasets. Audits are returned in chronological order by default. Note: This action retrieves the complete audit trail which is useful for compliance, troubleshooting, and understanding ticket evolution."
60095 + },
60096 + {
60097 + "slug": "ZENDESK_GET_TICKETS_AUDITS_COUNT",
60098 + "name": "Count Ticket Audits",
60099 + "description": "Count audits for a specific ticket in Zendesk. Returns an approximate count of audits associated with the specified ticket. Use when you need to know how many audit records exist for a ticket for reporting, analytics, or operational purposes."
60100 + },
60101 + {
60102 + "slug": "ZENDESK_GET_TICKETS_COMMENTS_COUNT",
60103 + "name": "Count Ticket Comments",
60104 + "description": "Count comments on a Zendesk ticket. Returns an approximate count of comments added to the specified ticket. Use when you need to know how many comments exist on a ticket without fetching the full comment list, such as for reporting or determining if pagination is needed."
60105 + },
60106 + {
60107 + "slug": "ZENDESK_GET_TICKETS_CONVERSATION_LOG",
60108 + "name": "Get Ticket Conversation Log",
60109 + "description": "List conversation log events for a specific Zendesk ticket. Use this action when you need to retrieve the chronological history of interactions, comments, and activities on a ticket. The conversation log provides a comprehensive view of all events including comments, status changes, and other ticket activities. Supports cursor-based pagination for accessing large datasets."
60110 + },
60111 + {
60112 + "slug": "ZENDESK_GET_TICKETS_COUNT",
60113 + "name": "Count Zendesk Tickets",
60114 + "description": "Count the number of tickets in Zendesk. Returns an approximate count of tickets with the timestamp of when the count was last calculated. This is a read-only, idempotent operation. Use when you need to know the total number of tickets for reporting, capacity planning, or operational purposes. Note that the count is approximate and may not reflect real-time changes. For detailed per-ticket information, use ZENDESK_LIST_ZENDESK_TICKETS instead."
60115 + },
60116 + {
60117 + "slug": "ZENDESK_GET_TICKET_SKIPS",
60118 + "name": "List Ticket Skips",
60119 + "description": "List ticket skips for a specific ticket from Zendesk. Use when you need to retrieve all skip records associated with a particular ticket, such as when reviewing which agents skipped working on a ticket or analyzing skip patterns. This action is read-only and idempotent. It returns a list of skip records that include the reason for skipping, who skipped it, and when."
60120 + },
60121 + {
60122 + "slug": "ZENDESK_GET_TICKETS_METRICS",
60123 + "name": "Get Ticket Metrics",
60124 + "description": "Get ticket metrics from Zendesk for a specific ticket. Returns performance metrics including resolution times, agent and requester wait times, reply counts, station changes, and timestamps for key events. Use when you need to analyze ticket performance, SLA compliance, or agent productivity metrics."
60125 + },
60126 + {
60127 + "slug": "ZENDESK_GET_TICKETS_SIDE_CONVERSATIONS_EVENTS",
60128 + "name": "List Side Conversation Events",
60129 + "description": "List all events for a specific side conversation on a Zendesk ticket. Returns events in chronological order including creation, replies, and state updates. Use this action when you need to view the complete history of a side conversation including all messages and state changes. Side conversations are private agent-to-agent communications that don't appear in the main ticket thread."
60130 + },
60131 + {
60132 + "slug": "ZENDESK_GET_TRIGGER",
60133 + "name": "Show Trigger",
60134 + "description": "Show a specific trigger by its ID. Use when you need to retrieve details of a single trigger in your Zendesk account, such as for auditing, modifying, or understanding what actions and conditions are configured for a particular trigger. This is useful for reviewing business rules before making changes or understanding automation behavior. This action is read-only and idempotent."
60135 + },
60136 + {
60137 + "slug": "ZENDESK_GET_TRIGGER_CATEGORIES",
60138 + "name": "List Trigger Categories",
60139 + "description": "List all ticket trigger categories in your Zendesk account. Use when you need to retrieve, audit, or review the trigger category organization for your business rules and automations. Supports filtering with sort options (position, name, created_at, updated_at) and can include rule counts via the `include` parameter to show how many triggers are in each category."
60140 + },
60141 + {
60142 + "slug": "ZENDESK_GET_TRIGGER_CATEGORIES2",
60143 + "name": "Show Trigger Category",
60144 + "description": "Show a specific ticket trigger category by its ID. Use when you need to retrieve details of a single trigger category, such as for auditing or understanding the organization of your ticket triggers. This action is read-only and idempotent."
60145 + },
60146 + {
60147 + "slug": "ZENDESK_GET_TRIGGERS",
60148 + "name": "List Ticket Triggers",
60149 + "description": "List all ticket triggers for the current Zendesk account. Use when you need to retrieve, audit, or review the trigger rules configured in your Zendesk account. Triggers are business rules that automatically perform actions based on conditions when tickets are created or updated. Supports filtering by active status and category. Also supports both traditional offset pagination and cursor-based pagination for sorting."
60150 + },
60151 + {
60152 + "slug": "ZENDESK_GET_TRIGGERS_DEFINITIONS",
60153 + "name": "Get Ticket Trigger Definitions",
60154 + "description": "Get Ticket Trigger Action and Condition Definitions. Use when you need to discover the available actions and conditions that can be used to create or configure ticket triggers. This returns metadata about what types of automations are possible - the action definitions show what a trigger can do (e.g., set status to 'solved'), while the condition definitions show what conditions can trigger it (e.g., when status is 'open'). This is a read-only, idempotent operation that returns the available trigger definitions metadata."
60155 + },
60156 + {
60157 + "slug": "ZENDESK_GET_TRIGGERS_SEARCH",
60158 + "name": "Search Ticket Triggers",
60159 + "description": "Search for Zendesk ticket triggers by their title. Use when you need to find triggers in your Zendesk account by searching for keywords in their titles. Triggers are business rules that automatically perform actions when certain conditions are met on tickets. This action supports filtering by active status, sorting, and sideloading usage statistics. This is a read-only and idempotent action that queries existing triggers without making any changes."
60160 + },
60161 {
60162 "slug": "ZENDESK_GET_USER",
60163 "name": "Get User",
60164 "description": "Tool to fetch a single Zendesk user by numeric user_id. Use when you have a user ID from ticket payloads (requester_id, submitter_id, assignee_id, author_id) and need to enrich with full user details (name, email, role, organization_id, etc.)."
60165 },
60166 + {
60167 + "slug": "ZENDESK_GET_USER_ENTITLEMENTS_FULL",
60168 + "name": "Get Full User Entitlements",
60169 + "description": "Tool to retrieve full entitlements for a Zendesk user across all products (Chat, Explore, Talk, Guide). Use when you need to check which Zendesk products a user has access to and their activation status. Returns detailed entitlement information including whether each product is active and its display name."
60170 + },
60171 + {
60172 + "slug": "ZENDESK_GET_USER_EVENTS",
60173 + "name": "Get User Events",
60174 + "description": "Retrieve event history for a specific Zendesk user. Use when you need to track user activity such as login history, profile changes, or other interactions with the Zendesk system. Supports filtering by event source, type, and time range. This action is read-only and idempotent. Note: The 'zendesk' source value is protected; attempts to use it when creating events result in an error."
60175 + },
60176 + {
60177 + "slug": "ZENDESK_GET_USER_FIELD_BY_ID",
60178 + "name": "Get User Field By ID",
60179 + "description": "Retrieve a single Zendesk user field by its numeric ID. Use when you have a user field ID and need to fetch its full definition including title, type, description, custom options, validation patterns, and other settings. This is a read-only, idempotent operation."
60180 + },
60181 + {
60182 + "slug": "ZENDESK_GET_USER_FIELD_OPTIONS",
60183 + "name": "List User Field Options",
60184 + "description": "List custom user field options for a given user field. Use when you need to retrieve the dropdown or tag options available for a custom user field in Zendesk. This action fetches the configurable options that can be selected for custom user fields of type dropdown, tagger, or similar multi-option field types."
60185 + },
60186 + {
60187 + "slug": "ZENDESK_GET_USER_FIELDS",
60188 + "name": "List User Fields",
60189 + "description": "List all custom user fields configured in your Zendesk account. Use when you need to retrieve the schema of user-defined fields (like dropdown options, validation patterns, or field types) to build dynamic forms or validate field values."
60190 + },
60191 + {
60192 + "slug": "ZENDESK_GET_USER_FIELDS_SHOW_MANY",
60193 + "name": "Get User Fields Show Many",
60194 + "description": "Retrieve multiple Zendesk user fields by their keys. Use when you have specific user field keys and need to fetch their definitions (title, type, description, options, etc.) in a single request instead of making individual calls. This is a read-only, idempotent operation."
60195 + },
60196 + {
60197 + "slug": "ZENDESK_GET_USER_PROFILES2",
60198 + "name": "Get User Profile by Profile ID",
60199 + "description": "Retrieve a single Zendesk user profile by its Sunshine profile ID. Use this action when you have a specific profile_id (obtained from profile listings or search results) and need to fetch the full profile details including attributes, identifiers, and linked user information. Note that this uses the Sunshine Profiles API with string profile IDs, not numeric user IDs from the Users API."
60200 + },
60201 + {
60202 + "slug": "ZENDESK_GET_USER_PROFILES_EVENTS2",
60203 + "name": "Get User Profile Events by ID",
60204 + "description": "Get events for a Sunshine profile by its profile ID. Use when you have a specific Sunshine profile ID (obtained from profile lookup or creation) and need to retrieve all events associated with that profile. This action is read-only and idempotent — use it to track profile activity, audit event history, or monitor user interactions for a specific profile. Note: The profile must exist or the request returns 404 Not Found. Use this action after creating or looking up a Sunshine profile to retrieve its event history."
60205 + },
60206 + {
60207 + "slug": "ZENDESK_GET_USERS_ASSIGNED_TICKETS",
60208 + "name": "Get User's Assigned Tickets",
60209 + "description": "List tickets assigned to a specific Zendesk user. Returns all tickets where the specified user is the assignee. Use when you need to retrieve all tickets currently assigned to a particular agent or user, such as for workload analysis, ticket reassignment, or performance reporting. Pagination is available for large result sets; follow next_page links until null to retrieve all assigned tickets. Note: This endpoint only returns tickets assigned to the user, not tickets requested by or submitted by the user."
60210 + },
60211 + {
60212 + "slug": "ZENDESK_GET_USERS_AUTOCOMPLETE",
60213 + "name": "Autocomplete Users",
60214 + "description": "Autocomplete users by name or phone number. Use when you need to find users based on a partial name or phone number for ticket creation or user lookup scenarios. At least one of 'name' or 'phone' must be provided."
60215 + },
60216 + {
60217 + "slug": "ZENDESK_GET_USERS_BRAND_AGENTS",
60218 + "name": "List Brand Agent Memberships By User",
60219 + "description": "List brand agent memberships for a specific user in Zendesk. Use when you have a user ID and need to find all brands that the user is an agent for, such as auditing which brands a specific agent can access. This is a read-only, idempotent operation."
60220 + },
60221 + {
60222 + "slug": "ZENDESK_GET_USERS_CCD_TICKETS",
60223 + "name": "Get User's CC'd Tickets",
60224 + "description": "List tickets where a specific Zendesk user is CC'd (carbon copied). Use when you need to retrieve all tickets where a particular user has been added as a CC recipient, such as for tracking user notifications, compliance monitoring, or ticket visibility analysis. Pagination is available for large result sets; follow next_page links until null to retrieve all CC'd tickets. Note: This endpoint only returns tickets where the user is a CC, not tickets requested by or assigned to the user."
60225 + },
60226 + {
60227 + "slug": "ZENDESK_GET_USERS_COMPLIANCE_DELETION_STATUSES",
60228 + "name": "Get User Compliance Deletion Statuses",
60229 + "description": "Tool to fetch GDPR compliance deletion statuses for a specific Zendesk user. Use when you need to check the deletion status for each compliance area (e.g., chat, talk) associated with a user account. Returns status records showing deletion requests and their current state. Use when auditing user data deletion requests, verifying GDPR compliance status, or tracking the progress of data removal across different Zendesk products."
60230 + },
60231 + {
60232 + "slug": "ZENDESK_GET_USERS_COUNT",
60233 + "name": "Count Users",
60234 + "description": "Count users in Zendesk. Returns an approximate count of users. If the count is more than 1000, the value is an estimate and the response is refreshed every 24 hours. Use when you need to know how many users exist in the system for reporting or administrative purposes."
60235 + },
60236 + {
60237 + "slug": "ZENDESK_GET_USER_SESSIONS",
60238 + "name": "List User Sessions",
60239 + "description": "List all sessions for a specific Zendesk user. Returns details about each active session including authentication time and last seen time. Use this action to monitor session activity for a specific user, investigate security events, or audit login history for account troubleshooting. Use when you need to see all active sessions for a particular user, track their login activity, or investigate potential unauthorized access."
60240 + },
60241 + {
60242 + "slug": "ZENDESK_GET_USERS_FOLLOWED_TICKETS",
60243 + "name": "Get User's Followed Tickets",
60244 + "description": "List tickets the specified Zendesk user is following. Returns all tickets where the specified user is a follower. Use when you need to retrieve all tickets a particular user is watching or tracking, such as for notification purposes, audit trails, or understanding which tickets a user has interest in. Pagination is available for large result sets; follow next_page links until null to retrieve all followed tickets."
60245 + },
60246 + {
60247 + "slug": "ZENDESK_GET_USERS_GROUP_MEMBERSHIPS",
60248 + "name": "List Memberships By User",
60249 + "description": "List group memberships for a specific Zendesk user. Use when you need to retrieve all groups a user belongs to, audit user group assignments, or understand which support groups a specific user is a member of. This action is read-only and idempotent. Supports both offset pagination (page, per_page) and cursor pagination (page_size, page_after, page_before). Also supports sideloading users and groups via the include parameter."
60250 + },
60251 + {
60252 + "slug": "ZENDESK_GET_USERS_GROUP_MEMBERSHIPS_BY_ID",
60253 + "name": "Get User's Group Membership",
60254 + "description": "Get a specific group membership for a user by their IDs. Use when you have both a user ID and a group membership ID and need to retrieve details including the associated group, user, and timestamps. This action retrieves a single group membership record scoped to a specific user, unlike GetGroupMembership which retrieves by membership ID alone, and unlike ListUsersGroupMemberships which lists all memberships for a user."
60255 + },
60256 + {
60257 + "slug": "ZENDESK_GET_USERS_GROUPS",
60258 + "name": "List User Groups",
60259 + "description": "List all groups that a specific Zendesk user belongs to. Use when you need to find which support groups a user is a member of, audit team memberships, or retrieve group membership information for a particular user. This action supports both offset pagination (page as integer, per_page) and cursor pagination (page as object with size/after/before). It also supports excluding deleted groups and sorting results. This action is read-only and idempotent."
60260 + },
60261 + {
60262 + "slug": "ZENDESK_GET_USERS_GROUPS_COUNT",
60263 + "name": "Count User Groups",
60264 + "description": "Count user groups in Zendesk. Returns an approximate count of groups that a specific user belongs to. Use when you need to know how many groups a user is assigned to for reporting, organizational management, or operational purposes. This action is read-only and idempotent."
60265 + },
60266 + {
60267 + "slug": "ZENDESK_GET_USERS_IDENTITIES2",
60268 + "name": "Show User Identity",
60269 + "description": "Tool to show a specific user identity by user ID and identity ID. Use when you need to retrieve detailed information about a particular identity associated with a Zendesk user. This action is read-only and idempotent - it only retrieves data without modifying anything."
60270 + },
60271 + {
60272 + "slug": "ZENDESK_GET_USERS_ME_SESSION",
60273 + "name": "Get Current Session",
60274 + "description": "Show the currently authenticated session in Zendesk. Returns details about the active session including authentication time, last seen time, and user ID. Use when you need to verify the current session status or retrieve session metadata for the authenticated user."
60275 + },
60276 + {
60277 + "slug": "ZENDESK_GET_USERS_ME_SETTINGS",
60278 + "name": "Get Current User Settings",
60279 + "description": "Get the settings for the currently authenticated user in Zendesk. Returns user preferences including Admin Center UI settings, Lotus UI settings (onboarding, tooltips, keyboard shortcuts), and shared views order. Use this action to retrieve the current user's personal settings and preferences."
60280 + },
60281 + {
60282 + "slug": "ZENDESK_GET_USERS_ORGANIZATION_MEMBERSHIPS",
60283 + "name": "List User Organization Memberships",
60284 + "description": "List organization memberships for a specific Zendesk user. Use when you have a user_id and need to retrieve all organizations that user belongs to. Returns membership details including default status, view_tickets permission, and organization info. This action is read-only and idempotent - calling it multiple times with the same user_id will return the same result."
60285 + },
60286 + {
60287 + "slug": "ZENDESK_GET_USERS_ORGANIZATION_MEMBERSHIPS2",
60288 + "name": "Get User's Organization Membership",
60289 + "description": "Get details for a specific organization membership by user ID and membership ID. Use when you have both a user ID and an organization membership ID and need to retrieve the associated membership metadata including organization details, default status, and ticket viewing permissions. This action is read-only and idempotent - calling it multiple times with the same parameters will return the same result."
60290 + },
60291 + {
60292 + "slug": "ZENDESK_GET_USERS_ORGANIZATIONS",
60293 + "name": "List User Organizations",
60294 + "description": "List organizations associated with a specific Zendesk user. Use when you have a user_id and need to retrieve all organizations that user belongs to. Returns organization details including name, domain names, tags, and custom fields. This action is read-only and idempotent - calling it multiple times with the same user_id will return the same result."
60295 + },
60296 + {
60297 + "slug": "ZENDESK_GET_USERS_ORGANIZATIONS_COUNT",
60298 + "name": "Get User's Organizations Count",
60299 + "description": "Returns an approximate count of organizations that a user belongs to. Use when you need to know how many organizations a specific user is associated with in Zendesk."
60300 + },
60301 + {
60302 + "slug": "ZENDESK_GET_USERS_ORGANIZATION_SUBSCRIPTIONS",
60303 + "name": "List User's Organization Subscriptions",
60304 + "description": "List User's Organization Subscriptions - retrieves organization subscriptions for a specific user. Use when you need to get all organization subscriptions associated with a particular user, including the organization IDs and creation timestamps. Supports both cursor and offset pagination. End users only see their own subscriptions. This is a read-only operation that does not modify any data."
60305 + },
60306 + {
60307 + "slug": "ZENDESK_GET_USERS_PASSWORD_REQUIREMENTS",
60308 + "name": "Get User Password Requirements",
60309 + "description": "Get password requirements for a specific Zendesk user. Use when you need to retrieve the password policy rules that apply to a user's password, such as minimum length, complexity requirements, or expiration policies. This action is read-only and idempotent."
60310 + },
60311 + {
60312 + "slug": "ZENDESK_GET_USERS_PROFILES",
60313 + "name": "Get Users Profiles",
60314 + "description": "Retrieve profiles associated with a specific Zendesk user by user ID. Use when you need to look up user profile information using the Zendesk user ID. This action returns all profiles linked to the specified user account. This action is read-only and idempotent. Note: Access requires agent permissions in Zendesk (Support > People > Roles > People)."
60315 + },
60316 + {
60317 + "slug": "ZENDESK_GET_USERS_RELATED",
60318 + "name": "Get User Related Info",
60319 + "description": "Get related counts and information for a specific Zendesk user by ID. Returns metadata about assigned tickets, CC'd tickets, organization subscriptions, and requested tickets associated with the user. Use when you need to understand the scale and composition of a user's ticket activity and subscriptions in Zendesk. This is a read-only, idempotent operation."
60320 + },
60321 + {
60322 + "slug": "ZENDESK_GET_USERS_REQUESTED_TICKETS",
60323 + "name": "Get User's Requested Tickets",
60324 + "description": "List tickets requested by a specific Zendesk user. Use when you need to retrieve all tickets where a particular user is the original requester, such as for tracking user's support history, compliance monitoring, or ticket ownership analysis. Pagination is available for large result sets; follow next_page links until null to retrieve all requested tickets. Note: This endpoint only returns tickets where the user is the requester, not tickets where they are CC'd or assigned."
60325 + },
60326 + {
60327 + "slug": "ZENDESK_GET_USERS_REQUESTS",
60328 + "name": "List User Requests",
60329 + "description": "List ticket requests for a specific Zendesk user. Use when you need to retrieve all requests associated with a particular user ID. This is useful for viewing a user's request history or monitoring their open tickets. This action is read-only and idempotent."
60330 + },
60331 + {
60332 + "slug": "ZENDESK_GET_USERS_SKIPS",
60333 + "name": "List User Skips",
60334 + "description": "List ticket skips for a specific user from Zendesk. Use when you need to retrieve all skip records associated with a particular user, such as when analyzing which tickets a user has skipped or reviewing their skip history. This action is read-only and idempotent. Note that archived tickets are not included in the results."
60335 + },
60336 + {
60337 + "slug": "ZENDESK_GET_USERS_TAGS",
60338 + "name": "Get User Tags",
60339 + "description": "List all tags assigned to a specific Zendesk user. Use when you need to see what tags are associated with a particular user for organizing, filtering, or categorizing user data. This action is read-only and idempotent."
60340 + },
60341 + {
60342 + "slug": "ZENDESK_GET_USER_TICKETS_ASSIGNED_COUNT",
60343 + "name": "Count User Assigned Tickets",
60344 + "description": "Count tickets assigned to a specific user in Zendesk. Returns an approximate count of tickets where the user is the assignee. Use when you need to know how many tickets are currently assigned to a particular user for workload analysis, reporting, or capacity planning. Note: The count is approximate and may not reflect real-time changes. The count is refreshed periodically rather than being calculated on every request."
60345 + },
60346 + {
60347 + "slug": "ZENDESK_GET_VIEW_DEFINITIONS",
60348 + "name": "List View Filter Definitions",
60349 + "description": "List the definitions of the conditions and actions available for constructing views in Zendesk. Use this action when you need to discover what filter fields, operators, grouping options, and sorting options are available for building or modifying views. This is a read-only action that returns the schema/structure for view definitions."
60350 + },
60351 + {
60352 + "slug": "ZENDESK_GET_VIEWS",
60353 + "name": "List Views",
60354 + "description": "List shared and personal views available to the current user in Zendesk. Use when you need to retrieve, audit, or review the views configured in your Zendesk account. Views are saved ticket filters that help organize and prioritize support work. Supports filtering by access level (personal/shared/account), active status, and group. Supports both traditional offset pagination and cursor-based pagination."
60355 + },
60356 + {
60357 + "slug": "ZENDESK_GET_VIEWS_ACTIVE",
60358 + "name": "List Active Views",
60359 + "description": "List all active shared and personal views available in Zendesk. Use when you need to retrieve, audit, or present the view configuration in your Zendesk account. Views define how tickets are filtered, grouped, and displayed to agents. Supports filtering by access type (personal, shared, account), group membership, and sorting preferences."
60360 + },
60361 + {
60362 + "slug": "ZENDESK_GET_VIEWS_COMPACT",
60363 + "name": "List Views - Compact",
60364 + "description": "Retrieves a compacted list of shared and personal views available to the current user in Zendesk. Use when you need to quickly fetch a lightweight list of views without full details. This endpoint returns essential view information suitable for dropdown menus or quick selection lists. Unlike the standard /views endpoint, this compact version provides a streamlined response with the most commonly needed fields."
60365 + },
60366 + {
60367 + "slug": "ZENDESK_GET_VIEWS_COUNT",
60368 + "name": "Count Views",
60369 + "description": "Count shared and personal views in Zendesk. Returns an approximate count of all views (both shared and personal) available in the account. Use when you need to know the total number of views configured for reporting or operational purposes."
60370 + },
60371 + {
60372 + "slug": "ZENDESK_GET_VIEWS_COUNT_MANY",
60373 + "name": "Count Tickets in Views",
60374 + "description": "Count tickets in multiple Zendesk views. Returns the ticket count for each view ID provided in a single API call. Use when you need to quickly get counts for multiple views at once for reporting or dashboard purposes. Note: This is a read-only, idempotent operation. Counts may be cached on the server side."
60375 + },
60376 + {
60377 + "slug": "ZENDESK_GET_VIEWS_EXECUTE",
60378 + "name": "Execute View",
60379 + "description": "Execute a Zendesk view to retrieve its column titles and matching ticket rows. Use when you need to run a saved view and get its results - useful for checking which tickets match a view's conditions without manually applying filters. Supports pagination, custom sorting, and optional grouping of results. Returns the view's execution metadata alongside the matching rows."
60380 + },
60381 + {
60382 + "slug": "ZENDESK_GET_VIEWS_EXPORT",
60383 + "name": "Export View",
60384 + "description": "Export a Zendesk view as a CSV file. Use when you need to download view data for offline analysis, reporting, or data migration purposes. The export contains all tickets matching the view's filter criteria and columns. Note that if the export is not immediately available, Zendesk may return a status indicating the job is queued - retry after a short delay in such cases. Note: This action downloads file content and may take longer for views with large datasets."
60385 + },
60386 + {
60387 + "slug": "ZENDESK_GET_VIEWS_SEARCH",
60388 + "name": "Search Views",
60389 + "description": "Search for Zendesk views by their title. Use when you need to find views in your Zendesk account by searching for keywords in their titles. Views are saved searches that display tickets matching specific conditions. This action supports filtering by access level, active status, group, and sorting results."
60390 + },
60391 + {
60392 + "slug": "ZENDESK_GET_VIEWS_SHOW_MANY",
60393 + "name": "List Views By IDs",
60394 + "description": "Get multiple Zendesk views by their IDs. Use when you need to retrieve specific views by their IDs in a single request rather than fetching them one by one. The IDs should be provided as a comma-separated string. This action is read-only and idempotent. Returns only views that exist and for which the user has permission."
60395 + },
60396 + {
60397 + "slug": "ZENDESK_GET_VIEWS_TICKETS",
60398 + "name": "List Tickets From View",
60399 + "description": "List tickets from a specific Zendesk view. Use this action when you need to retrieve all tickets that match a view's conditions, such as for reporting, bulk operations, or analyzing tickets filtered by specific criteria. This action is read-only and idempotent."
60400 + },
60401 + {
60402 + "slug": "ZENDESK_GET_VIEW_TICKET_COUNT",
60403 + "name": "Count Tickets in View",
60404 + "description": "Count tickets in a specific view in Zendesk. Returns the number of tickets matching the view's conditions. Use when you need to know how many tickets are in a particular view for reporting, routing decisions, or workload assessment. The count may be null if the system is still loading and caching new data. This action is read-only and idempotent."
60405 + },
60406 + {
60407 + "slug": "ZENDESK_GET_ZENDESK_ACTIVITIES",
60408 + "name": "List Activities",
60409 + "description": "List ticket activities in the last 30 days affecting your Zendesk. Activities include actions like ticket assignments, status changes, comments, and more. This action is read-only and idempotent — use it to monitor ticket activity or build activity feeds."
60410 + },
60411 + {
60412 + "slug": "ZENDESK_GET_ZENDESK_CUSTOM_ROLES",
60413 + "name": "List Custom Roles",
60414 + "description": "List all custom roles configured in your Zendesk account. Use when you need to discover available roles, review role configurations, or understand permission structures for your agents. Returns metadata including role names, descriptions, role types, and permission configurations. This is a read-only, idempotent operation with no required parameters."
60415 + },
60416 {
60417 "slug": "ZENDESK_GET_ZENDESK_ORGANIZATION",
60418 "name": "Get Zendesk Organization",
60419 "description": "Get metadata for a specific Zendesk organization by ID. Response fields are available under data.organization_info. Does not return member/user lists."
60420 },
60421 + {
60422 + "slug": "ZENDESK_GET_ZENDESK_ORGANIZATION_MERGE",
60423 + "name": "Get Zendesk Organization Merge",
60424 + "description": "Retrieve the details of a specific organization merge operation in Zendesk. This action shows the merge status and the organizations involved. Use when you need to check the status of an organization merge or view details of a past merge operation. This is a read-only, idempotent operation."
60425 + },
60426 + {
60427 + "slug": "ZENDESK_GET_ZENDESK_ORGANIZATIONS_SUBSCRIPTIONS",
60428 + "name": "List Organization Subscriptions",
60429 + "description": "List all organization subscriptions for a specific Zendesk organization. Returns subscriptions that link users to organizations. Use when you need to see which users are subscribed to a particular organization or audit organization membership. This action is read-only and idempotent. Paginate by following next_page until null to avoid missing subscriptions."
60430 + },
60431 + {
60432 + "slug": "ZENDESK_GET_ZENDESK_REQUESTS",
60433 + "name": "List Requests",
60434 + "description": "List ticket requests in Zendesk. This action retrieves a paginated list of requests, supporting sorting by creation or update time. Use when you need to fetch all or filtered ticket requests from your Zendesk account. This action is read-only and idempotent."
60435 + },
60436 + {
60437 + "slug": "ZENDESK_GET_ZENDESK_SESSIONS",
60438 + "name": "List Sessions",
60439 + "description": "List all active sessions in your Zendesk account. If authenticated as an admin, returns all the active sessions for all users. Otherwise, returns only the sessions for the authenticated user. Use this action to monitor active user sessions, track login activity, or manage session security. Use when you need to audit active user sessions, investigate security events, or retrieve session information for user activity monitoring."
60440 + },
60441 + {
60442 + "slug": "ZENDESK_GET_ZENDESK_SHARING_AGREEMENTS",
60443 + "name": "List Sharing Agreements",
60444 + "description": "List all sharing agreements for your Zendesk account. Sharing agreements define connections between Zendesk accounts for sharing tickets. This action is read-only and idempotent — use it to view current sharing relationships or check agreement status."
60445 + },
60446 + {
60447 + "slug": "ZENDESK_GET_ZENDESK_SUSPENDED_TICKETS",
60448 + "name": "List Suspended Tickets",
60449 + "description": "List suspended tickets in Zendesk. Suspended tickets are tickets that were automatically held for review due to spam detection, banned content, or other filtering rules. This action is read-only and idempotent — use it to review suspended tickets and determine if they should be recovered or deleted."
60450 + },
60451 {
60452 "slug": "ZENDESK_GET_ZENDESK_TICKET_BY_ID",
60453 "name": "Get Zendesk Ticket",
60454 "description": "Get ticket details from Zendesk. Response wraps all data under a top-level `data` key; access `data['comments']` for comments and `data['comments'][i]['attachments']` for attachments (attachments unavailable from list endpoints). Each comment has both `html_body` and plain `body` fields — choose appropriately. Fields like `subject`, `organization_id`, `author_id`, and `body` may be null; handle defensively. First comment in `data.comments` is not necessarily from the requester — compare `author_id` against ticket `requester_id` to identify requester messages. For bulk calls, honor `Retry-After` headers on HTTP 429."
60455 },
60456 + {
60457 + "slug": "ZENDESK_GET_ZENDESK_TICKET_FIELDS_OPTIONS",
60458 + "name": "List Ticket Field Options",
60459 + "description": "List Ticket Field Options - Returns a list of custom ticket field options for dropdown and multi-select ticket fields. Use this action to retrieve the available choices users can select when filling out a custom ticket field. This action is read-only and idempotent. Note: Only works with dropdown, tagger, and multi-select custom ticket fields; standard fields like text or date do not have options."
60460 + },
60461 + {
60462 + "slug": "ZENDESK_GET_ZENDESK_TICKET_FIELDS_OPTIONS2",
60463 + "name": "Show Ticket Field Option",
60464 + "description": "Show Ticket Field Option - Retrieves a specific custom ticket field option for dropdown and multi-select ticket fields. Use this action when you have a ticket_field_id and a ticket_field_option_id and need to retrieve the details of that individual option. This action is read-only and idempotent. Note: Only works with dropdown, tagger, and multi-select custom ticket fields; standard fields like text or date do not have options."
60465 + },
60466 + {
60467 + "slug": "ZENDESK_GET_ZENDESK_TICKET_FORM",
60468 + "name": "Get Zendesk Ticket Form",
60469 + "description": "Get details for a specific ticket form in Zendesk by its ID. Returns the complete ticket form object including its name, display settings, visibility conditions, associated ticket fields, and brand restrictions. Use when you need to retrieve detailed information about a particular ticket form configuration. This is a read-only, idempotent operation that does not modify any data."
60470 + },
60471 + {
60472 + "slug": "ZENDESK_GET_ZENDESK_TICKET_RELATED",
60473 + "name": "Get Zendesk Ticket Related",
60474 + "description": "Get related information for a specific Zendesk ticket. This endpoint returns data about tickets that are related to the specified ticket, including follow-up sources, associated Jira issues, and incident counts. Use this action when you need to understand the relationships and connections between tickets in Zendesk."
60475 + },
60476 + {
60477 + "slug": "ZENDESK_GET_ZENDESK_TICKETS_SIDE_CONVERSATION_ID",
60478 + "name": "Get Side Conversation",
60479 + "description": "Get a specific side conversation by its ID for a Zendesk ticket. Side conversations are private agent-to-agent communications that don't notify the customer. Use this action when you need to retrieve details about a specific side conversation on a ticket, such as its current state, participants, or message history. If the side conversation is a child ticket, the external_ids object's targetTicketId property contains the child ticket's ID."
60480 + },
60481 + {
60482 + "slug": "ZENDESK_GET_ZENDESK_TICKETS_TAGS",
60483 + "name": "Get Ticket Tags",
60484 + "description": "List all tags associated with a specific Zendesk ticket. Use when you need to retrieve the tags assigned to a particular ticket for categorization, filtering, or reporting purposes."
60485 + },
60486 + {
60487 + "slug": "ZENDESK_LIST_ACTIVE_AUTOMATIONS",
60488 + "name": "List Active Automations",
60489 + "description": "List all active automations in Zendesk. Use when you need to retrieve the currently active automation rules that automatically perform actions based on ticket conditions. This action returns all automations marked as active, including their conditions and actions. Note: This only returns active automations; to see all automations including inactive ones, you would need a different action."
60490 + },
60491 + {
60492 + "slug": "ZENDESK_LIST_APP_INSTALLATIONS",
60493 + "name": "List App Installations",
60494 + "description": "List all app installations in the Zendesk account. The 'enabled' property indicates whether each installed app is active in the product. Use the 'include' parameter to sideload app object details for each installation."
60495 + },
60496 + {
60497 + "slug": "ZENDESK_LIST_APP_LOCATIONS",
60498 + "name": "List App Locations",
60499 + "description": "List all available locations where Zendesk apps can be installed. Use when you need to discover valid placement options for installing or configuring Zendesk apps. This endpoint requires admin authentication. All returned locations are read-only."
60500 + },
60501 + {
60502 + "slug": "ZENDESK_LIST_ASSIGNABLE_GROUP_MEMBERSHIPS",
60503 + "name": "List Assignable Group Memberships",
60504 + "description": "List assignable group memberships in Zendesk. Use when you need to retrieve the group memberships that agents can be assigned to, typically for understanding agent-group assignments or building assignment interfaces. This action is read-only and idempotent. Returns a maximum of 100 group memberships per page."
60505 + },
60506 + {
60507 + "slug": "ZENDESK_LIST_ASSIGNABLE_GROUP_MEMBERSHIPS_BY_GROUP",
60508 + "name": "List Assignable Memberships By Group",
60509 + "description": "List assignable group memberships for a specific group in Zendesk. Use when you need to retrieve which agents can be assigned to a particular group, typically for building assignment interfaces or auditing group membership capabilities. This action is read-only and idempotent. Returns a maximum of 100 group memberships per page. Note: This action differs from ListAssignableGroupMemberships by filtering to a specific group rather than returning all assignable memberships."
60510 + },
60511 + {
60512 + "slug": "ZENDESK_LIST_BOOKMARKS",
60513 + "name": "List Bookmarks",
60514 + "description": "List Bookmarks returns all bookmarks created by the user. Use when you need to retrieve all bookmarks to find saved tickets or manage bookmarked items. Archived tickets are not included in the response. _tags = [\"readOnlyHint\", \"idempotentHint\"]"
60515 + },
60516 + {
60517 + "slug": "ZENDESK_LIST_BRAND_AGENTS",
60518 + "name": "List Brand Agent Memberships",
60519 + "description": "List brand agent memberships to retrieve which agents are associated with which brands in Zendesk. Use this action when you need to enumerate the brand-agent relationships in a Zendesk account, such as determining which agents can access specific brands or auditing brand access permissions. This is a read-only, idempotent operation."
60520 + },
60521 + {
60522 + "slug": "ZENDESK_LIST_CUSTOM_OBJECT_RECORD_ATTACHMENTS",
60523 + "name": "List Custom Object Record Attachments",
60524 + "description": "List all file attachments for a specific custom object record in Zendesk. Use this action when you need to retrieve the attachments associated with a particular custom object record, for example to display files, verify uploads, or manage attachments for a record. This is a read-only operation that retrieves attachment metadata without downloading file content."
60525 + },
60526 + {
60527 + "slug": "ZENDESK_LIST_CUSTOM_OBJECT_RECORDS",
60528 + "name": "List Custom Object Records",
60529 + "description": "List all records for a specific custom object type in Zendesk. Use this action when you need to retrieve all instances of a custom object (e.g., all car records, all product records) with optional filtering by ID, external ID, sorting, and pagination support. This is a read-only, idempotent operation that returns records with their custom field values. Note: When using pagination (page[size], page[after], page[before]), you cannot mix page[before] and page[after] in the same request."
60530 + },
60531 + {
60532 + "slug": "ZENDESK_LIST_DELETED_USERS",
60533 + "name": "List Deleted Users",
60534 + "description": "Tool to list deleted users in Zendesk via the Users API. Use when you need to retrieve information about users that have been deleted from the system. This is a read-only operation."
60535 + },
60536 + {
60537 + "slug": "ZENDESK_LIST_INCREMENTAL_CUSTOM_OBJECT_RECORDS",
60538 + "name": "List Incremental Custom Object Records",
60539 + "description": "Export custom object records incrementally using cursor-based pagination. Use this action when you need to retrieve all changes to custom object records since a specific time, with support for large result sets through cursor-based pagination. The start_time parameter is required for the initial request; subsequent pages use the cursor returned in previous responses. This is a read-only, idempotent operation that returns records with their custom field values and change timestamps. The action supports filtering to exclude deleted records and configurable page sizes. Rate limited to 10 requests per minute."
60540 + },
60541 + {
60542 + "slug": "ZENDESK_LIST_MONITORED_TWITTER_HANDLES",
60543 + "name": "List Monitored X Handles",
60544 + "description": "List all monitored X (Twitter) handles configured in your Zendesk account. Use when you need to retrieve all Twitter handles that are being monitored for the X channel integration. This is a read-only, idempotent operation."
60545 + },
60546 + {
60547 + "slug": "ZENDESK_LIST_OBJECT_TRIGGERS",
60548 + "name": "List Object Triggers",
60549 + "description": "List all triggers for a specific custom object in Zendesk. Use when you need to discover, audit, or review the triggers configured for a custom object type. Triggers are business rules that automatically perform actions based on conditions. This action retrieves triggers associated with a custom object defined in your Zendesk instance. Each trigger defines conditions and corresponding actions that run when records meet those conditions."
60550 + },
60551 + {
60552 + "slug": "ZENDESK_LIST_OBJECT_TRIGGERS_DEFINITIONS",
60553 + "name": "List Object Trigger Definitions",
60554 + "description": "List Object Trigger Action and Condition Definitions for a custom object in Zendesk. Use when you need to discover the available trigger actions and conditions that can be used to create or configure triggers on a custom object. This returns metadata about what types of automations are possible for the specified custom object. This is a read-only, idempotent operation that returns the available trigger definitions."
60555 + },
60556 + {
60557 + "slug": "ZENDESK_LIST_ORGANIZATION_MEMBERSHIPS",
60558 + "name": "List Organization Memberships",
60559 + "description": "List organization memberships in Zendesk. Use when you need to retrieve all organization memberships, which link users to organizations. Supports pagination and sorting options to navigate large result sets efficiently."
60560 + },
60561 + {
60562 + "slug": "ZENDESK_LIST_ORGANIZATION_MEMBERSHIPS_BY_ORGANIZATION",
60563 + "name": "List Organization Memberships by Organization",
60564 + "description": "List organization memberships for a specific organization in Zendesk. Use when you need to retrieve all users who are members of a particular organization, including their membership metadata like default status and ticket viewing permissions. Supports pagination and sorting options to navigate large result sets efficiently. This action is read-only and idempotent - calling it multiple times with the same organization ID will return the same result."
60565 + },
60566 + {
60567 + "slug": "ZENDESK_LIST_RESOURCE_COLLECTIONS",
60568 + "name": "List Resource Collections",
60569 + "description": "List Resource Collections for the Zendesk account. Use when you need to retrieve, audit, or review the resource collections configured in your Zendesk account. Resource collections are groups of related resources that can be managed together. This is a read-only action that returns paginated results. Use per_page to control page size."
60570 + },
60571 + {
60572 + "slug": "ZENDESK_LIST_SKIPS",
60573 + "name": "List All Skips",
60574 + "description": "Lists all ticket skips in Zendesk. A skip is a ticket that was skipped during routing or assignment. Use this action to retrieve information about all tickets that have been skipped. This action is read-only and idempotent. Note that archived tickets are not included in the results."
60575 + },
60576 + {
60577 + "slug": "ZENDESK_LIST_SUPPORT_ADDRESSES",
60578 + "name": "List Support Addresses",
60579 + "description": "List all support addresses (recipient addresses) configured in your Zendesk account. Use when you need to enumerate available support email addresses, check which address is set as default, or retrieve address metadata like verification status and brand associations. This is a read-only, idempotent operation that supports both cursor and offset pagination."
60580 + },
60581 + {
60582 + "slug": "ZENDESK_LIST_TICKET_AUDITS",
60583 + "name": "List Ticket Audits",
60584 + "description": "List all ticket audits from Zendesk. Returns a paginated list of audit records, each containing events that describe changes made to tickets. Audits capture all changes including comments, status changes, assignments, and field updates. Archived tickets are not included in the results. Use cursor pagination (page_after, page_before, page_size) to navigate through results efficiently."
60585 + },
60586 + {
60587 + "slug": "ZENDESK_LIST_TICKET_CONTENT_PINS",
60588 + "name": "List Ticket Content Pins",
60589 + "description": "List Ticket Content Pins returns all content pins for a specified ticket. Use when you need to retrieve all pinned content items on a ticket. If ticket_id is not provided, returns all content pins for the account. _tags = [\"readOnlyHint\", \"idempotentHint\"]"
60590 + },
60591 + {
60592 + "slug": "ZENDESK_LIST_USER_IDENTITIES",
60593 + "name": "List User Identities",
60594 + "description": "Tool to list all identities for a specific Zendesk user. Use when you need to retrieve all email addresses, phone numbers, or other contact methods associated with a user. Supports filtering by identity type and cursor-based pagination."
60595 + },
60596 + {
60597 + "slug": "ZENDESK_LIST_ZENDESK_ACCESS_RULES",
60598 + "name": "List Access Rules",
60599 + "description": "List all access rules for a Zendesk custom object. Access rules control which users and roles can perform specific operations on custom object records. Use this action when you need to audit existing permissions or understand what access controls are in place for a custom object type. This is a read-only operation."
60600 + },
60601 + {
60602 + "slug": "ZENDESK_LIST_ZENDESK_CUSTOM_OBJECT_FIELDS",
60603 + "name": "List Custom Object Fields",
60604 + "description": "List all fields for a custom object in Zendesk. Use this action when you need to discover the structure of a custom object, understand what fields are available, or retrieve metadata about custom object fields for further operations like creating or updating records."
60605 + },
60606 + {
60607 + "slug": "ZENDESK_LIST_ZENDESK_CUSTOM_OBJECTS",
60608 + "name": "List Custom Objects",
60609 + "description": "List all custom object definitions in Zendesk. Use this action when you need to discover available custom object types, understand their structure, or retrieve metadata about custom objects for further operations. Returns metadata including keys, titles, and configuration options for each custom object."
60610 + },
60611 + {
60612 + "slug": "ZENDESK_LIST_ZENDESK_PERMISSION_POLICIES",
60613 + "name": "List Permission Policies",
60614 + "description": "List all permission policies for a custom object in Zendesk. Use this action when you need to discover the access control configuration for a custom object, understand what roles have permissions, or retrieve permission metadata for access control management. This is a read-only, idempotent operation. This action is useful for reviewing permission policies applied to custom objects in Zendesk."
60615 + },
60616 {
60617 "slug": "ZENDESK_LIST_ZENDESK_TICKETS",
60618 "name": "List Tickets",
@@ -58577,30 +60623,450 @@
60623 "name": "List Users",
60624 "description": "Tool to list/enumerate Zendesk users via the Users API. Use when you need to export or iterate through the user directory without a specific name/email filter. Supports both cursor and offset pagination."
60625 },
60626 + {
60627 + "slug": "ZENDESK_MAKE_COMMENT_PRIVATE",
60628 + "name": "Make Zendesk Ticket Comment Private",
60629 + "description": "Make a public ticket comment private in Zendesk. This action changes the visibility of a comment from public to internal-only, so only agents can view it. Use this action when you need to convert a customer-facing comment to an internal note after the fact. Note: Only agents can make comments private; end users cannot use this endpoint."
60630 + },
60631 + {
60632 + "slug": "ZENDESK_MAKE_DEFAULT_ORGANIZATION_MEMBERSHIP",
60633 + "name": "Make Organization Membership Default",
60634 + "description": "Set a specific organization membership as the default for a user in Zendesk. Use when you need to change which organization is the primary/default for a user. Only one organization can be the default at a time. This action is idempotent - setting the same membership as default multiple times will succeed without side effects."
60635 + },
60636 + {
60637 + "slug": "ZENDESK_MAKE_END_USER_IDENTITY_PRIMARY",
60638 + "name": "Make End User Identity Primary",
60639 + "description": "Set a specified identity as the primary identity for an end user in Zendesk. This is a collection-level operation - after making an identity primary, you should reload the entire identities collection to get the updated state. An end user can only make an email identity primary if the email is verified. Use when a user wants to change their primary email or phone number for notifications."
60640 + },
60641 + {
60642 + "slug": "ZENDESK_MAKE_TICKET_COMMENT_PRIVATE",
60643 + "name": "Make Ticket Comment Private",
60644 + "description": "Change a public comment to private on a Zendesk ticket audit. Use when you need to convert a previously public-facing comment to an internal note that is not visible to the end user. This action makes the comment private by updating the ticket audit. This is useful when information was shared publicly by mistake and needs to be restricted to agents only. Note: This action only works on existing audits and cannot be undone once the comment is made private."
60645 + },
60646 + {
60647 + "slug": "ZENDESK_MAKE_USER_IDENTITY_PRIMARY",
60648 + "name": "Make User Identity Primary",
60649 + "description": "Tool to set a user identity as the primary identity for a Zendesk user. Use when you need to change which email address or identifier is the primary contact method for a user. This action may affect which email notifications the user receives."
60650 + },
60651 + {
60652 + "slug": "ZENDESK_MARK_MANY_TICKETS_AS_SPAM",
60653 + "name": "Mark Multiple Tickets as Spam",
60654 + "description": "Marks multiple tickets as spam in Zendesk. This action is irreversible — the tickets will be marked as spam and moved to the suspended tickets queue. The submitter will also be marked as spam and blocked from submitting further tickets. Use when cleaning up spam or unwanted tickets to protect your support queue. Returns a job_status payload for tracking the bulk operation. Note: Tickets marked as spam are moved to the suspended tickets queue and cannot be recovered through normal means."
60655 + },
60656 + {
60657 + "slug": "ZENDESK_MERGE_USERS",
60658 + "name": "Merge Users",
60659 + "description": "Merges two Zendesk end users together. The user specified in the path parameter (user_id) is the primary user (target) that will be kept. The user specified in the request body (id) is the source user that will be deleted and its data transferred to the primary user. Use when you need to consolidate duplicate end-user accounts in Zendesk. This action is irreversible — the source user and all their associated data (tickets, comments, etc.) will be merged into the primary user and the source user cannot be recovered."
60660 + },
60661 + {
60662 + "slug": "ZENDESK_MERGE_ZENDESK_TICKETS",
60663 + "name": "Merge Zendesk Tickets",
60664 + "description": "Merges multiple tickets into a target ticket in Zendesk. The source tickets are merged into the target ticket and then deleted. This is an asynchronous operation that returns a job status. Use when you need to consolidate duplicate or related tickets into a single ticket. **Important**: This action is irreversible - source tickets are permanently merged and deleted once the operation completes. Always verify the target_ticket_id and source_ticket_ids before executing."
60665 + },
60666 + {
60667 + "slug": "ZENDESK_OPEN_USERS_PROFILE_IN_AGENT_BROWSER",
60668 + "name": "Open User's Profile in Agent Browser",
60669 + "description": "Open a Zendesk user's profile in a specified agent's browser. Use when an agent needs to view a specific user's profile during an active call or session. This action triggers the Zendesk Talk dashboard to display the user's information in the agent's interface."
60670 + },
60671 + {
60672 + "slug": "ZENDESK_RECOVER_MANY_SUSPENDED_TICKETS",
60673 + "name": "Recover Multiple Suspended Tickets",
60674 + "description": "Recover multiple suspended tickets in Zendesk. Use when you need to restore tickets that have been suspended (e.g., auto-replied emails, bounced messages). Takes up to 100 ticket IDs as input and restores them to normal ticket status. This action is irreversible — recovered tickets return to normal processing."
60675 + },
60676 + {
60677 + "slug": "ZENDESK_RENEW_SESSION",
60678 + "name": "Renew Session",
60679 + "description": "Renew the current Zendesk session and obtain a new authenticity token. Use when the current session token is expiring or needs to be refreshed to maintain an active authenticated connection. This action extends the session lifetime without requiring full re-authentication."
60680 + },
60681 + {
60682 + "slug": "ZENDESK_REORDER_CUSTOM_OBJECT_FIELDS",
60683 + "name": "Reorder Custom Object Fields",
60684 + "description": "Reorder Custom Fields of an Object. Updates the display order of custom object fields based on the provided field IDs. Use when you need to change the order of fields displayed in a custom object's record layout. This action is idempotent — re-running with the same field IDs in the same order will produce the same result."
60685 + },
60686 + {
60687 + "slug": "ZENDESK_REORDER_LOCATION_INSTALLATIONS",
60688 + "name": "Reorder App Location Installations",
60689 + "description": "Reorder App Installations For Location. Creates or updates the relevant location installation with a specified installation order. This action requires admin-level access. Use when you need to change the display order of apps in a specific Zendesk location (e.g., nav bar, ticket sidebar)."
60690 + },
60691 + {
60692 + "slug": "ZENDESK_REORDER_ORGANIZATION_FIELDS",
60693 + "name": "Reorder Organization Fields",
60694 + "description": "Reorder Organization Fields. Updates the display order of organization fields based on the provided field IDs. Use when you need to change the order of organization fields displayed in Zendesk. This action is idempotent — re-running with the same field IDs in the same order will produce the same result."
60695 + },
60696 + {
60697 + "slug": "ZENDESK_REORDER_TICKET_FIELDS",
60698 + "name": "Reorder Ticket Fields",
60699 + "description": "Reorder Ticket Fields. Updates the display order of ticket fields based on the provided field IDs. Use when you need to change the order of standard ticket fields displayed in the ticket form. This action is idempotent — re-running with the same field IDs in the same order will produce the same result. This action requires admin permissions."
60700 + },
60701 + {
60702 + "slug": "ZENDESK_REORDER_TRIGGERS",
60703 + "name": "Reorder Ticket Triggers",
60704 + "description": "Reorder Ticket Triggers. Updates the firing order of ticket triggers based on the provided trigger IDs. Use when you need to change the priority or execution order of ticket triggers in your Zendesk account. Important constraints: You must include EVERY ticket trigger ID in your account. Omitting any trigger ID returns 404 Forbidden. Additionally, reordering is not permitted if you have more than one ticket trigger category (returns LimitOneCategory error). This action is idempotent - re-running with the same trigger IDs in the same order will produce the same result."
60705 + },
60706 + {
60707 + "slug": "ZENDESK_REORDER_USER_FIELDS",
60708 + "name": "Reorder User Fields",
60709 + "description": "Reorder User Fields. Updates the display order of custom user fields based on the provided field IDs. Use when you need to change the order of user fields displayed in user profiles or forms. This action requires admin-level access. This action is idempotent — re-running with the same field IDs in the same order will produce the same result."
60710 + },
60711 {
60712 "slug": "ZENDESK_REPLY_ZENDESK_TICKET",
60713 "name": "Reply to Zendesk Ticket",
60714 "description": "Action to reply to a Zendesk ticket by adding a comment."
60715 },
60716 + {
60717 + "slug": "ZENDESK_REQUEST_END_USER_VERIFICATION",
60718 + "name": "Request End User Verification",
60719 + "description": "Send a verification email to an end user to verify ownership of their email address identity. The end user receives an email with a link to confirm their identity. Use when you need to verify an end user's email address identity in Zendesk, such as when creating new end users or resolving identity verification issues. Note: This action can only be performed by verified end users."
60720 + },
60721 + {
60722 + "slug": "ZENDESK_REQUEST_USER_CREATE",
60723 + "name": "Request User Create",
60724 + "description": "Send a request to create a user in Zendesk. This sends the owner a reminder email to update their user profile information. Use when you want to prompt a user to complete their profile through the request flow rather than creating directly. This action is useful for onboarding flows where you want to collect user information through an email-based request rather than creating the user directly."
60725 + },
60726 + {
60727 + "slug": "ZENDESK_REQUEST_USER_VERIFICATION",
60728 + "name": "Request User Verification",
60729 + "description": "Send a verification email to a user to verify ownership of their email address identity. The user receives an email with a link to confirm their identity. Use when you need to verify a user's email address identity in Zendesk, such as when creating new users or resolving identity verification issues. Note: This action sends a verification email to the user's identity address."
60730 + },
60731 + {
60732 + "slug": "ZENDESK_RESTORE_MANY_TICKETS",
60733 + "name": "Restore Multiple Deleted Tickets",
60734 + "description": "Restores multiple previously deleted tickets in Zendesk. Use when you need to recover tickets that were deleted and need to be restored in bulk. This action is reversible - tickets can be deleted again after restoration. Note: Only tickets in 'deleted' status can be restored."
60735 + },
60736 + {
60737 + "slug": "ZENDESK_RESTORE_ZENDESK_TICKET",
60738 + "name": "Restore Zendesk Ticket",
60739 + "description": "Restores a previously deleted ticket in Zendesk. Use when a ticket was accidentally deleted and needs to be recovered. The restored ticket will return to its previous state with all associated data intact. This action is reversible — tickets can be deleted again after restoration if needed."
60740 + },
60741 + {
60742 + "slug": "ZENDESK_SEARCH_CUSTOM_OBJECT_RECORDS",
60743 + "name": "Search Custom Object Records",
60744 + "description": "Search and filter custom object records in Zendesk using text queries and field filters. Returns paginated results with cursor-based navigation. Use when you need to find specific records within a custom object type, apply text searches or structured filters, and navigate through large result sets. This is a read-only operation. This action is useful for discovering records, running filtered queries on custom objects, and implementing paginated browsing through custom object data."
60745 + },
60746 + {
60747 + "slug": "ZENDESK_SEARCH_OBJECT_TRIGGERS",
60748 + "name": "Search Object Triggers",
60749 + "description": "Search for triggers associated with a custom object in Zendesk. Use when you need to find triggers based on their title, description, or active status within a specific custom object. This is useful for auditing, managing, or reviewing automation rules for custom objects. Supports both cursor-based pagination (using 'sort' parameter) and offset pagination (using 'sort_by' parameter). Filter by 'active' to show only enabled or disabled triggers."
60750 + },
60751 {
60752 "slug": "ZENDESK_SEARCH_ZENDESK",
60753 "name": "Search Zendesk",
60754 "description": "Tool to search for tickets, users, organizations, and groups in Zendesk using query syntax. Use when you need to find resources across Zendesk using flexible search criteria."
60755 },
60756 + {
60757 + "slug": "ZENDESK_SEARCH_ZENDESK_ORGANIZATIONS",
60758 + "name": "Search Organizations",
60759 + "description": "Search organizations in Zendesk by external ID or name. Returns an array of organizations matching the provided criteria. Use when you need to find specific organizations by their identifier or name. An empty organizations array with count=0 means no matches found. Multiple organizations may share similar names — verify the correct organization via external_id or domain_names before proceeding with operations."
60760 + },
60761 {
60762 "slug": "ZENDESK_SEARCH_ZENDESK_USERS",
58592 - "name": "Search Users",
58593 - "description": "Tool to search Zendesk users by email or name. At least one of 'email' or 'name' must be provided; pagination-only calls fail. Results span all roles (end-users, agents, admins); filter by 'role' client-side if needed. No org-scoped filtering — filter by 'organization_id' client-side. A response with count=0 and empty users array means no match, not an error. Use before ticket creation to confirm user identity."
60763 + "name": "Search Zendesk Users",
60764 + "description": "Search for Zendesk users by query or external ID. Use when you need to find users using flexible search criteria with Zendesk search syntax (e.g., partial name matches, email patterns, notes, phone numbers). For exact email lookups, consider using the 'Search Zendesk Users' action instead."
60765 + },
60766 + {
60767 + "slug": "ZENDESK_SET_DEFAULT_CUSTOM_STATUS",
60768 + "name": "Set Default Custom Ticket Status",
60769 + "description": "Sets one or more custom ticket statuses as the default for their respective categories. Use this action when you need to specify which custom status should be the default (fallback) status for a given category (open, pending, solved, etc.). This operation is idempotent — running it multiple times with the same IDs will produce the same result. **Allowed for**: Admins only. **Note**: The IDs should be valid custom ticket status IDs that exist in your Zendesk account."
60770 + },
60771 + {
60772 + "slug": "ZENDESK_SET_GROUP_MEMBERSHIP_AS_DEFAULT",
60773 + "name": "Set Group Membership as Default",
60774 + "description": "Set a group membership as the default for a specific user in Zendesk. Use when you need to mark a user's group membership as the default, meaning tickets assigned directly to the agent will assume this membership's group. Requires both the user ID and the group membership ID. This action is useful for managing default routing preferences for agents in your Zendesk instance. Note that only one group membership can be the default at a time - setting a new default will automatically unset the previous default."
60775 + },
60776 + {
60777 + "slug": "ZENDESK_SET_USERS_ORGANIZATION_AS_DEFAULT",
60778 + "name": "Set Organization as Default for User",
60779 + "description": "Set an organization as the default for a user in Zendesk. Use when you need to change which organization is the primary/default for a user by specifying the organization ID directly. Only one organization can be the default at a time. This action is idempotent - setting the same organization as default multiple times will succeed without side effects."
60780 + },
60781 + {
60782 + "slug": "ZENDESK_SHOW_ACCESS_RULE",
60783 + "name": "Show Access Rule",
60784 + "description": "Show a custom object access rule by its ID. Use when you have a custom_object_key and access_rule_id and need to retrieve the access rule's details including its conditions, title, description, and timestamps. This is a read-only operation that does not modify any data. This action is useful for reviewing access control rules applied to custom objects in Zendesk."
60785 + },
60786 + {
60787 + "slug": "ZENDESK_SHOW_CUSTOM_OBJECT",
60788 + "name": "Show Custom Object",
60789 + "description": "Get details of a specific Zendesk custom object by its key. Use when you have a custom object key and need to retrieve its metadata including name, description, attachment settings, visibility settings, and creation/update timestamps. This is a read-only, idempotent operation that returns the full custom object definition."
60790 + },
60791 + {
60792 + "slug": "ZENDESK_SHOW_CUSTOM_OBJECT_RECORD",
60793 + "name": "Show Custom Object Record",
60794 + "description": "Get details of a specific Zendesk custom object record by its key and record ID. Use when you have a custom object key and record ID and need to retrieve the record's metadata including name, custom fields, timestamps, and photo. This is a read-only, idempotent operation that returns the full custom object record definition. Photo is only available if `allows_photos` is enabled on the custom object."
60795 + },
60796 + {
60797 + "slug": "ZENDESK_SHOW_MANY_JOB_STATUSES",
60798 + "name": "Show Many Job Statuses",
60799 + "description": "Show many job statuses by their IDs in Zendesk. Use this action when you have multiple job status IDs from bulk operations (like ticket updates, user merges, or ticket merges) and need to check their status in a single request. Each ID in the comma-separated list will return its corresponding job status object if found. Endpoint: GET /api/v2/job_statuses/show_many"
60800 + },
60801 + {
60802 + "slug": "ZENDESK_SHOW_MANY_TICKETS",
60803 + "name": "Show Many Tickets",
60804 + "description": "Show multiple tickets by their IDs. Use when you need to retrieve specific tickets by their IDs to display ticket details, compare tickets, or bulk fetch ticket information. The `ids` parameter accepts a comma-separated list of ticket IDs (e.g., '35436,35437'). Returns tickets for valid IDs only; non-existent IDs result in an empty tickets array without error."
60805 + },
60806 + {
60807 + "slug": "ZENDESK_SHOW_MANY_USERS",
60808 + "name": "Show Many Users",
60809 + "description": "Retrieve multiple Zendesk users by their numeric IDs or external IDs. Use when you have a list of user IDs (from ticket payloads, search results, etc.) and need to fetch full user details for multiple users at once. Accepts up to 100 IDs per request. Provide either `ids` or `external_ids`, not both."
60810 + },
60811 + {
60812 + "slug": "ZENDESK_SHOW_PERMISSION_POLICY",
60813 + "name": "Show Permission Policy",
60814 + "description": "Get details of a specific permission policy for a Zendesk custom object by its ID. Use when you have a custom_object_key and permission policy ID and need to retrieve the policy's details including the role name and record operation permissions (create, read, update, delete). This is a read-only, idempotent operation that does not modify any data. This action is useful for reviewing permission policies that control access to custom object records in Zendesk."
60815 + },
60816 + {
60817 + "slug": "ZENDESK_SHOW_REQUEST",
60818 + "name": "Show Request",
60819 + "description": "Show a single request in Zendesk. Use when you need to retrieve details of a specific request by its ID, including subject, description, status, priority, requester information, and other metadata. This action is read-only and idempotent."
60820 + },
60821 + {
60822 + "slug": "ZENDESK_UNASSIGN_USER_ORGANIZATION",
60823 + "name": "Unassign User from Organization",
60824 + "description": "Immediately removes a user from an organization in Zendesk. Use when you need to unassign a user from an organization membership. This action is irreversible - the user will no longer be associated with the organization."
60825 + },
60826 + {
60827 + "slug": "ZENDESK_UPDATE_ACCESS_RULE",
60828 + "name": "Update Access Rule",
60829 + "description": "Update an existing access rule for a custom object in Zendesk. Access rules control which records of a custom object users can access based on conditions. Use this action when you need to: - Change an access rule's title or description - Modify the conditions that determine when the rule applies - Update access permissions for custom object records This action is idempotent — re-running with the same parameters will produce the same result."
60830 + },
60831 + {
60832 + "slug": "ZENDESK_UPDATE_APPS_INSTALLATION",
60833 + "name": "Update Zendesk App Installation",
60834 + "description": "Update an app installation in Zendesk. Use when you need to modify app installation settings such as enabling/disabling the app, restricting access by groups or roles, or updating app-specific settings."
60835 + },
60836 + {
60837 + "slug": "ZENDESK_UPDATE_AUTOMATION",
60838 + "name": "Update Automation",
60839 + "description": "Update an existing automation in Zendesk. Automations are business rules that automatically perform actions on tickets when certain conditions are met. Use this action when you need to: - Change an automation's title, active status, or position - Modify the conditions that trigger the automation - Update the actions the automation performs - Deactivate an automation without deleting it This action is idempotent — re-running with the same parameters will produce the same result."
60840 + },
60841 + {
60842 + "slug": "ZENDESK_UPDATE_CUSTOM_OBJECT",
60843 + "name": "Update Custom Object",
60844 + "description": "Update an existing custom object in Zendesk. Custom objects are user-defined data structures that allow you to store and manage custom data types. Use this action when you need to: - Change a custom object's title, description, or pluralized title - Update visibility settings (include_in_list_view) - Enable or disable attachments and photos for the custom object This action is idempotent — re-running with the same parameters will produce the same result."
60845 + },
60846 + {
60847 + "slug": "ZENDESK_UPDATE_CUSTOM_OBJECT_RECORD",
60848 + "name": "Update Custom Object Record",
60849 + "description": "Update an existing record for a custom object in Zendesk. Use when you need to modify an existing custom object record. This action updates fields on a custom object record. You can update the name, external_id, and custom_object_fields as needed."
60850 + },
60851 + {
60852 + "slug": "ZENDESK_UPDATE_CUSTOM_STATUS",
60853 + "name": "Update Custom Ticket Status",
60854 + "description": "Update an existing custom ticket status in Zendesk. Custom ticket statuses allow you to define additional statuses beyond the standard statuses (new, open, pending, solved, closed) for your ticket workflow. Use this action when you need to: - Change the labels shown to agents or end users for a custom status - Update the descriptions explaining when to use the status - Activate or deactivate a custom status - Modify how a custom status appears in the ticket interface This action is idempotent — re-running with the same parameters will produce the same result. Requires admin permissions in Zendesk."
60855 + },
60856 + {
60857 + "slug": "ZENDESK_UPDATE_DELETION_SCHEDULE",
60858 + "name": "Update Deletion Schedule",
60859 + "description": "Update an existing deletion schedule in Zendesk. Deletion schedules define automated rules for deleting tickets, users, attachments, or other records based on specified conditions. Use this action when you need to: - Change a deletion schedule's title, description, or active status - Modify the conditions that determine which records are deleted - Pause or reactivate a deletion schedule This action is idempotent — re-running with the same parameters will produce the same result. Note: The 'object' field cannot be modified after schedule creation."
60860 + },
60861 + {
60862 + "slug": "ZENDESK_UPDATE_DYNAMIC_CONTENT_ITEMS_VARIANT",
60863 + "name": "Update Dynamic Content Variant",
60864 + "description": "Update a single variant of a dynamic content item in Zendesk. Use when you need to modify the content, locale, active status, or default status of one specific variant by its ID. This action is idempotent — re-running with the same parameters will produce the same result."
60865 + },
60866 + {
60867 + "slug": "ZENDESK_UPDATE_DYNAMIC_CONTENT_ITEMS_VARIANTS",
60868 + "name": "Update Many Dynamic Content Variants",
60869 + "description": "Update one or more variants of a dynamic content item in Zendesk. Use when you need to bulk update variant content, active status, or default status for a specific dynamic content item. Each variant can be identified by either its ID or locale ID. This action is idempotent — re-running with the same parameters will produce the same result."
60870 + },
60871 + {
60872 + "slug": "ZENDESK_UPDATE_MACRO",
60873 + "name": "Update Macro",
60874 + "description": "Update an existing macro in Zendesk. Macros are predefined responses that agents can apply to tickets to quickly perform common actions. Use this action when you need to: - Change a macro's title or description - Modify the actions the macro performs (e.g., change status, priority, or assignee) - Activate or deactivate a macro - Restrict macro access to specific users or groups This action is idempotent — re-running with the same parameters will produce the same result."
60875 + },
60876 + {
60877 + "slug": "ZENDESK_UPDATE_MANY_AUTOMATIONS",
60878 + "name": "Update Many Automations",
60879 + "description": "Update multiple automations in Zendesk in a single request. Use when you need to bulk update automation settings such as position, active status, or title for multiple automations at once. Note: You might be restricted from updating some default automations. If included in a bulk update, the unrestricted automations will be updated. This action is idempotent — re-running with the same parameters will produce the same result."
60880 + },
60881 + {
60882 + "slug": "ZENDESK_UPDATE_MANY_MACROS",
60883 + "name": "Update Many Macros",
60884 + "description": "Update multiple macros in Zendesk in a single request. Use when you need to bulk update macro settings such as position or active status for multiple macros at once. This action is idempotent — re-running with the same parameters will produce the same result."
60885 + },
60886 + {
60887 + "slug": "ZENDESK_UPDATE_MANY_OBJECT_TRIGGERS",
60888 + "name": "Update Many Object Triggers",
60889 + "description": "Update multiple custom object triggers in Zendesk in a single request. Use when you need to bulk update trigger settings such as position, active status, or title for multiple custom object triggers at once. This action is idempotent — re-running with the same parameters will produce the same result."
60890 + },
60891 + {
60892 + "slug": "ZENDESK_UPDATE_MANY_ORGANIZATIONS",
60893 + "name": "Update Many Zendesk Organizations",
60894 + "description": "Bulk update multiple Zendesk organizations in a single request. Use when you need to update organization details such as name, notes, details, domain names, or tags for multiple organizations at once. The action is queued as a background job - use the job_status URL to poll for completion. Maximum 100 organizations per request. Note: Agents without permission restrictions can only update 'notes' on organizations."
60895 + },
60896 + {
60897 + "slug": "ZENDESK_UPDATE_MANY_TICKETS",
60898 + "name": "Update Many Tickets",
60899 + "description": "Update multiple tickets in Zendesk in a single request. Use when you need to bulk update ticket fields such as status, priority, tags, assignee, or group for multiple tickets at once. The API accepts up to 100 ticket objects per request. Changes are processed asynchronously and return a job_status object for tracking progress."
60900 + },
60901 + {
60902 + "slug": "ZENDESK_UPDATE_MANY_TRIGGERS",
60903 + "name": "Update Many Ticket Triggers",
60904 + "description": "Update multiple ticket triggers in Zendesk in a single request. Use when you need to bulk update trigger settings such as position, active status, or category for multiple triggers at once. This action allows you to update the order (position) or activate/deactivate multiple triggers efficiently. This action is idempotent — re-running with the same parameters will produce the same result."
60905 + },
60906 + {
60907 + "slug": "ZENDESK_UPDATE_MANY_USERS",
60908 + "name": "Update Many Users",
60909 + "description": "Bulk update multiple Zendesk users in a single request. Use when you need to apply the same or different updates to up to 100 users at once. Provide either a single `user` object to apply identical changes to all specified users, or an array of `users` objects for individual updates per user. The operation is asynchronous and returns a job_status that you can poll to track completion. This action is idempotent — re-running with the same parameters will apply the same updates again."
60910 + },
60911 + {
60912 + "slug": "ZENDESK_UPDATE_MANY_VIEWS",
60913 + "name": "Update Many Views",
60914 + "description": "Update multiple views in Zendesk in a single request. Use when you need to bulk update view settings such as position, active status, or title for multiple views at once. Note: You might be restricted from updating some default views. If included in a bulk update, the unrestricted views will be updated. This action is idempotent — re-running with the same parameters will produce the same result."
60915 + },
60916 + {
60917 + "slug": "ZENDESK_UPDATE_OBJECT_TRIGGER",
60918 + "name": "Update Object Trigger",
60919 + "description": "Update an existing custom object trigger in Zendesk. Triggers define automated actions that execute when specific conditions are met on custom object records. Use this action when you need to: - Change a trigger's title or description - Enable or disable a trigger - Modify the conditions that cause the trigger to fire - Update the actions the trigger performs This action is idempotent — re-running with the same parameters will produce the same result."
60920 + },
60921 + {
60922 + "slug": "ZENDESK_UPDATE_ORGANIZATION_FIELD",
60923 + "name": "Update Organization Field",
60924 + "description": "Update a custom organization field in Zendesk. Use when you need to modify an existing organization field's properties such as title, type, description, options, or other settings. All existing custom_field_options must be included on update — omitted options will be deleted. Returns the updated organization field object."
60925 + },
60926 + {
60927 + "slug": "ZENDESK_UPDATE_ORGANIZATIONS_TAGS",
60928 + "name": "Add Organization Tags",
60929 + "description": "Add organization tags in Zendesk. Use when you need to tag an organization for categorization, filtering, or automation purposes. Tags are appended to the organization's existing tags. This action is idempotent — adding the same tag multiple times will not create duplicates in the organization's tag list."
60930 + },
60931 + {
60932 + "slug": "ZENDESK_UPDATE_PERMISSION_POLICY",
60933 + "name": "Update Permission Policy",
60934 + "description": "Update an existing permission policy for a custom object in Zendesk. Permission policies control which records of a custom object users with a specific role can access. Use this action when you need to: - Modify record access permissions (create, read, update, delete) for a custom role - Add or remove exceptions to what records users can access - Configure group-based exclusions for custom object record permissions This action is idempotent — re-running with the same parameters will produce the same result."
60935 + },
60936 + {
60937 + "slug": "ZENDESK_UPDATE_RESOURCE_COLLECTION",
60938 + "name": "Update Resource Collection",
60939 + "description": "Update an existing resource collection in Zendesk. Resource collections are groups of related resources (like triggers, automations, or ticket fields) that can be managed together. Use this action when you need to: - Rename a resource collection - Modify the resources included in a collection - Update the configuration of an existing collection This action is idempotent - re-running with the same parameters will produce the same result."
60940 + },
60941 + {
60942 + "slug": "ZENDESK_UPDATE_SIDE_CONVERSATION",
60943 + "name": "Update Side Conversation",
60944 + "description": "Update a side conversation on a ticket in Zendesk. Use this action to modify the state (open/closed) or subject of an existing side conversation attached to a ticket. Use when you need to: - Close a side conversation that has been resolved - Reopen a closed side conversation - Update the subject line of a side conversation This action is idempotent — re-running with the same parameters will produce the same result."
60945 + },
60946 + {
60947 + "slug": "ZENDESK_UPDATE_SUPPORT_ADDRESS",
60948 + "name": "Update Support Address",
60949 + "description": "Update an existing support address in Zendesk. Support addresses are email addresses that receive customer inquiries and can be configured per brand. Use this action when you need to: - Change the name of a support address - Set or change the default support address for the account - Associate a support address with a different brand Note: You cannot change the email address of an existing support address."
60950 + },
60951 + {
60952 + "slug": "ZENDESK_UPDATE_TARGET",
60953 + "name": "Update Zendesk Target",
60954 + "description": "Update an existing target in Zendesk. Targets are endpoints that receive data when triggers fire (e.g., HTTP targets, email targets, webhook targets). Use this action when you need to: - Change a target's title - Activate or deactivate a target - Update target-specific properties This action is idempotent — re-running with the same parameters will produce the same result."
60955 + },
60956 + {
60957 + "slug": "ZENDESK_UPDATE_TICKET_FIELD",
60958 + "name": "Update Ticket Field",
60959 + "description": "Update an existing ticket field in Zendesk. Ticket fields define the structure and properties of custom fields on tickets. Use this action when you need to: - Rename a ticket field or update its title - Update the description or agent-only description - Change the field's position in the ticket form - Enable or disable a ticket field - Set visibility and editability for portal and agents - Make fields required for solving tickets or creating requests - Configure validation patterns for regexp fields - Set tags for checkbox fields This action is idempotent — re-running with the same parameters will produce the same result. Requires admin permissions."
60960 + },
60961 + {
60962 + "slug": "ZENDESK_UPDATE_TICKETS_TAGS",
60963 + "name": "Update Zendesk Ticket Tags",
60964 + "description": "Update tags on a Zendesk ticket via PUT request to /api/v2/tickets/{ticket_id}/tags. Use when you need to add, replace, or manage tags on an existing ticket. This operation replaces all existing tags with the provided list."
60965 + },
60966 + {
60967 + "slug": "ZENDESK_UPDATE_TICKET_TRIGGER",
60968 + "name": "Update Ticket Trigger",
60969 + "description": "Update an existing ticket trigger in Zendesk. Triggers are business rules that automatically perform actions on tickets when certain conditions are met. Use this action when you need to: - Change a trigger's title, active status, position, or description - Modify the conditions that trigger the action - Update the actions the trigger performs - Reassign a trigger to a different category - Deactivate a trigger without deleting it This action is idempotent — re-running with the same parameters will produce the same result."
60970 + },
60971 + {
60972 + "slug": "ZENDESK_UPDATE_TRIGGER_CATEGORY",
60973 + "name": "Update Trigger Category",
60974 + "description": "Update an existing trigger category in Zendesk. Trigger categories are used to organize ticket triggers in the Zendesk admin interface. Use this action when you need to: - Rename a trigger category - Change the display order of a trigger category - Update both name and position of a trigger category This action is idempotent — re-running with the same parameters will produce the same result."
60975 + },
60976 + {
60977 + "slug": "ZENDESK_UPDATE_USER_FIELD",
60978 + "name": "Update Zendesk User Field",
60979 + "description": "Update an existing user field in Zendesk. Use when you need to modify the title, description, options, or other properties of a custom user field. Supports updating text, checkbox, dropdown, multiselect, date, integer, decimal, regexp validation, and lookup types. Only administrators can update user fields."
60980 + },
60981 + {
60982 + "slug": "ZENDESK_UPDATE_USER_PROFILE",
60983 + "name": "Update Zendesk User Profile",
60984 + "description": "Partially updates a user profile in Zendesk by identifier. Use when you need to modify specific fields of an existing profile without replacing the entire profile. This action uses JSON merge patch semantics — only provided fields are updated. Use this action when you have an existing profile identifier and need to update specific profile attributes, identifiers, or the profile name. The identifier must follow the format source:type:identifier_type:identifier_value."
60985 + },
60986 + {
60987 + "slug": "ZENDESK_UPDATE_USER_PROFILE_BY_ID",
60988 + "name": "Update Zendesk User Profile By ID",
60989 + "description": "Partially updates a user profile in Zendesk by profile ID. Use when you need to modify specific fields of an existing profile without replacing the entire profile. This action uses JSON merge patch semantics — only provided fields are updated. Use this action when you have a profile ID and need to update specific profile attributes, identifiers, name, source, or type. This is different from UpdateUserProfile which uses identifier lookup instead."
60990 + },
60991 + {
60992 + "slug": "ZENDESK_UPDATE_USERS_IDENTITY",
60993 + "name": "Update User Identity",
60994 + "description": "Update a user identity in Zendesk. Use when you need to modify an identity's verified status or other updatable fields. Note: the 'primary' field cannot be changed via this endpoint - use the Make Identity Primary endpoint instead."
60995 + },
60996 + {
60997 + "slug": "ZENDESK_UPDATE_USERS_ME_SETTINGS",
60998 + "name": "Update Current User Settings",
60999 + "description": "Update the settings for the currently authenticated Zendesk user. Use when modifying UI preferences like keyboard shortcuts, onboarding tooltips, theme preferences, or shared views order. This action modifies the caller's own settings only."
61000 + },
61001 + {
61002 + "slug": "ZENDESK_UPDATE_USERS_PROFILES",
61003 + "name": "Update Users Profiles",
61004 + "description": "Create or update a user profile for a specific Zendesk user by user ID and identifier. Use when you need to establish or modify a unified customer view for an existing Zendesk user. The profile is identified by both the user_id (path) and the identifier (query parameter). This endpoint uses PUT semantics - if a profile matching the identifier exists, it will be updated; otherwise, a new profile will be created. Use this action when you have a specific Zendesk user ID and need to create or update a profile using an identifier like email, phone number, or external ID."
61005 + },
61006 + {
61007 + "slug": "ZENDESK_UPDATE_USERS_TAGS",
61008 + "name": "Update User Tags",
61009 + "description": "Update (replace) tags for a specific Zendesk user. Use when you need to assign or modify tags on a user account for organizing, filtering, or categorizing user data. This action replaces all existing tags on the user with the provided list."
61010 + },
61011 + {
61012 + "slug": "ZENDESK_UPDATE_VIEW",
61013 + "name": "Update View",
61014 + "description": "Update an existing view in Zendesk. Views are saved searches that allow agents to filter and organize tickets. Use this action when you need to: - Change a view's title, description, or active status - Modify a view's position in the list - Update a view's conditions or display settings - Make a view the default view This action is idempotent — re-running with the same parameters will produce the same result."
61015 + },
61016 + {
61017 + "slug": "ZENDESK_UPDATE_ZENDESK_ACCOUNT_SETTINGS",
61018 + "name": "Update Zendesk Account Settings",
61019 + "description": "Update Zendesk account-level settings including tickets, branding, localization, routing, and more. Use when you need to configure or modify account-wide settings that affect all agents and end users. Requires admin privileges to update most settings. Settings changes are persistent and affect all users."
61020 + },
61021 + {
61022 + "slug": "ZENDESK_UPDATE_ZENDESK_ATTACHMENT",
61023 + "name": "Update Zendesk Attachment",
61024 + "description": "Updates an attachment's malware access override setting. Use when you need to enable or restrict agent access to attachments that have been flagged for malware."
61025 + },
61026 + {
61027 + "slug": "ZENDESK_UPDATE_ZENDESK_CUSTOM_OBJECT_FIELD",
61028 + "name": "Update Custom Object Field",
61029 + "description": "Update an existing custom object field in Zendesk. Custom object fields define the structure and properties of data within a custom object. Use this action when you need to: - Rename a custom object field - Update the description or display properties - Change the field's position in the UI - Enable or disable a field - Set validation patterns or make fields required This action is idempotent — re-running with the same parameters will produce the same result."
61030 + },
61031 + {
61032 + "slug": "ZENDESK_UPDATE_ZENDESK_DYNAMIC_CONTENT_ITEM",
61033 + "name": "Update Dynamic Content Item",
61034 + "description": "Update a dynamic content item in Zendesk. The only attribute that can be changed is the name. Use when you need to rename an existing dynamic content item after confirming its ID. Note: Dynamic content items are used to store multilingual content for use in triggers, automations, and macros. Updating the name affects all references to this item."
61035 },
61036 {
61037 "slug": "ZENDESK_UPDATE_ZENDESK_ORGANIZATION",
61038 "name": "Update Zendesk Organization",
61039 "description": "Update an organization in Zendesk. After updating, re-fetch via ZENDESK_GET_ZENDESK_ORGANIZATION if downstream logic depends on current data."
61040 },
61041 + {
61042 + "slug": "ZENDESK_UPDATE_ZENDESK_REQUESTS",
61043 + "name": "Update Request",
61044 + "description": "Update a ticket request in Zendesk with a comment or collaborators. Use when you need to modify request fields like status, priority, or add comments after confirming the request ID. After updating, re-fetch via ZENDESK_GET_REQUESTS if downstream logic depends on current data."
61045 + },
61046 {
61047 "slug": "ZENDESK_UPDATE_ZENDESK_TICKET",
61048 "name": "Update Zendesk Ticket",
61049 "description": "Tool to update a ticket in Zendesk. Use when you need to modify ticket fields like status, priority, or subject after confirming the ticket ID."
61050 + },
61051 + {
61052 + "slug": "ZENDESK_UPSERT_CUSTOM_OBJECT_RECORD_BY_EXTERNAL_ID_OR_NAME",
61053 + "name": "Upsert Custom Object Record By External ID or Name",
61054 + "description": "Create or update a custom object record in Zendesk by external_id or name. Use when you need to create a new record or update an existing one based on either its external_id (preferred) or name. If a record matching the external_id or name exists, it will be updated. If no matching record is found, a new one will be created. This action is idempotent and safe to retry. Note: Either external_id or name (or both) must be provided to identify the record. If both are provided, external_id takes precedence for matching."
61055 + },
61056 + {
61057 + "slug": "ZENDESK_VERIFY_SUBDOMAIN_AVAILABILITY",
61058 + "name": "Verify Subdomain Availability",
61059 + "description": "Verify if a subdomain name is available for use in Zendesk. Returns a success boolean indicating whether the subdomain can be registered. Use when checking if a desired subdomain name is available before creating a new Zendesk account or subdomain."
61060 + },
61061 + {
61062 + "slug": "ZENDESK_VERIFY_SUPPORT_ADDRESS",
61063 + "name": "Verify Support Address",
61064 + "description": "Verify a support address forwarding in Zendesk. This action sends a verification request for the specified support address to confirm that the address is properly configured and can receive email forwarding. Use this action when you need to: - Verify a newly created support address is working correctly - Re-verify an existing support address after configuration changes - Confirm email forwarding is properly set up for a support address This action is idempotent — verifying an already-verified address will return success."
61065 + },
61066 + {
61067 + "slug": "ZENDESK_VERIFY_USER_IDENTITY",
61068 + "name": "Verify User Identity",
61069 + "description": "Set a user identity as verified in Zendesk. This action marks an email address or other identity as confirmed, indicating the user has proven ownership. Use when you need to manually verify a user's identity after they have completed an out-of-band verification process or when you want to override the verification status for administrative purposes. Note: This action cannot verify the account owner's email identity due to security restrictions."
61070 }
61071 ],
61072 "triggers": [
@@ -58654,7 +61120,7 @@
61120 "type": "string",
61121 "description": "Scopes to request from the user, comma separated",
61122 "required": false,
58657 - "default": "organizations:read,organizations:write,tickets:read,tickets:write,users:read,users:write,webhooks:read,webhooks:write"
61123 + "default": "read,write,organizations:read,organizations:write,tickets:read,tickets:write,users:read,users:write,webhooks:read,webhooks:write"
61124 }
61125 ]
61126 },
@@ -58689,7 +61155,7 @@
61155 ],
61156 "toolCount": 14,
61157 "triggerCount": 0,
58692 - "version": "20260414_00",
61158 + "version": "20260429_00",
61159 "tools": [
61160 {
61161 "slug": "GOOGLEPHOTOS_ADD_ENRICHMENT",
@@ -58825,7 +61291,7 @@
61291 ],
61292 "toolCount": 8,
61293 "triggerCount": 0,
58828 - "version": "20260414_00",
61294 + "version": "20260424_00",
61295 "tools": [
61296 {
61297 "slug": "LMNT_CREATE_VOICE",
@@ -58907,7 +61373,7 @@
61373 ],
61374 "toolCount": 52,
61375 "triggerCount": 0,
58910 - "version": "20260414_00",
61376 + "version": "20260504_00",
61377 "tools": [
61378 {
61379 "slug": "METAADS_CREATE_AD",
@@ -59369,9 +61835,9 @@
61835 "composioManagedAuthSchemes": [
61836 "OAUTH2"
61837 ],
59372 - "toolCount": 431,
61838 + "toolCount": 440,
61839 "triggerCount": 20,
59374 - "version": "20260417_00",
61840 + "version": "20260506_02",
61841 "tools": [
61842 {
61843 "slug": "GOOGLESUPER_ACL_DELETE",
@@ -59711,7 +62177,7 @@
62177 {
62178 "slug": "GOOGLESUPER_CREATE_FILE",
62179 "name": "Create File or Folder",
59714 - "description": "Creates a new file or folder with metadata. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells; content must be added manually in the Google UI afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in `parents` rather than GOOGLEDRIVE_CREATE_FOLDER."
62180 + "description": "Creates a new file or folder in Google Drive. Supports both metadata-only creation (for folders and empty documents) and file upload with content. When file_to_upload is provided, uploads the actual file bytes; otherwise creates an empty file. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells when no content is provided; content must be added manually afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in `parents` rather than GOOGLEDRIVE_CREATE_FOLDER."
62181 },
62182 {
62183 "slug": "GOOGLESUPER_CREATE_FILE_FROM_TEXT",
@@ -59833,6 +62299,11 @@
62299 "name": "Create Team Drive (Deprecated)",
62300 "description": "Tool to create a Team Drive. Deprecated: Use drives.create instead. Use when you need to create a Team Drive for collaboration."
62301 },
62302 + {
62303 + "slug": "GOOGLESUPER_DELETE_CHART",
62304 + "name": "Delete Chart from Google Sheets",
62305 + "description": "Delete an existing chart from a Google Sheets spreadsheet. Use this action when you need to remove a chart that is no longer needed or needs to be replaced. This action is irreversible — once a chart is deleted, it cannot be recovered. The chart data source (the cells containing the data) remains unchanged; only the chart visualization is removed."
62306 + },
62307 {
62308 "slug": "GOOGLESUPER_DELETE_CHILD",
62309 "name": "Delete Child (v2)",
@@ -60583,6 +63054,11 @@
63054 "name": "Insert Text into Document",
63055 "description": "Tool to insert a string of text at a specified location within a Google Document. Use when you need to add new text content to an existing document. IMPORTANT: Two ways to specify insertion location: 1. Use 'insertion_index' to insert at a specific position (index 1 is safe for document start) 2. Use 'append_to_end=true' to append text to the end of the document (recommended for appending) CRITICAL CONSTRAINT: When using insertion_index, the index MUST fall within the bounds of an EXISTING paragraph. You cannot insert text at arbitrary indices or at structural boundaries (e.g., table starts). The index must also be strictly less than the document's end index. To safely append text without index concerns, use append_to_end=true."
63056 },
63057 + {
63058 + "slug": "GOOGLESUPER_LIST_ACCESSIBLE_CUSTOMERS",
63059 + "name": "List Accessible Customers",
63060 + "description": "ListAccessibleCustomers retrieves all Google Ads customer accounts accessible to the authenticated user. Returns resource names of customers (e.g., customers/1234567890) that can be accessed with the current OAuth credentials. Use this action to discover which customer IDs are available before making other API calls. Use this action when you need to determine which customer accounts the authenticated user has access to, or when you want to populate a dropdown of available accounts for the user to select from."
63061 + },
63062 {
63063 "slug": "GOOGLESUPER_LIST_ACCESS_PROPOSALS",
63064 "name": "List Access Proposals",
@@ -60643,11 +63119,21 @@
63119 "name": "List BigQuery Links",
63120 "description": "Tool to list BigQuery Links on a property. Use when you need to retrieve BigQuery link resources associated with a Google Analytics property. Results support pagination for large datasets."
63121 },
63122 + {
63123 + "slug": "GOOGLESUPER_LIST_BUILDINGS",
63124 + "name": "List Buildings",
63125 + "description": "Lists all buildings for a Google Workspace customer account with full details including addresses, coordinates, and floor names. Use this action when you need to retrieve the complete list of physical building locations configured in Google Workspace Calendar resources. This is useful for workspace administrators managing conference room and resource scheduling across multiple office buildings. Requires Google Workspace administrator privileges with Directory API access."
63126 + },
63127 {
63128 "slug": "GOOGLESUPER_LIST_CALCULATED_METRICS",
63129 "name": "List Calculated Metrics",
63130 "description": "List Calculated Metrics"
63131 },
63132 + {
63133 + "slug": "GOOGLESUPER_LIST_CALENDAR_RESOURCES",
63134 + "name": "List Calendar Resources",
63135 + "description": "Retrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API. Use this action when you need to list available meeting rooms, conference spaces, or other bookable calendar resources in an organization. The action supports filtering by resource category, capacity, building location, and other criteria. IMPORTANT: This requires Admin SDK Directory API access and appropriate admin permissions - it is NOT available for personal Gmail accounts, only Google Workspace domains."
63136 + },
63137 {
63138 "slug": "GOOGLESUPER_LIST_CALENDARS",
63139 "name": "List Google Calendars",
@@ -60978,6 +63464,16 @@
63464 "name": "Move to Trash",
63465 "description": "Moves an existing, non-deleted email message to the trash for the specified user. Trashed messages are recoverable and still count toward storage quota until purged. Prefer this over GMAIL_BATCH_DELETE_MESSAGES when recovery may be needed. For bulk operations, use GMAIL_BATCH_MODIFY_MESSAGES or GMAIL_BATCH_DELETE_MESSAGES instead of repeated calls to this tool."
63466 },
63467 + {
63468 + "slug": "GOOGLESUPER_MUTATE_AD_GROUPS",
63469 + "name": "Mutate Ad Groups",
63470 + "description": "Create, update, or remove ad groups within Google Ads campaigns. Supports batch operations with multiple ad group changes in a single request. Use when you need to manage ad groups programmatically, such as creating new ad groups for campaigns, updating ad group settings or status, or removing ad groups that are no longer needed. This action is irreversible for remove operations — deleted ad groups cannot be recovered once removed."
63471 + },
63472 + {
63473 + "slug": "GOOGLESUPER_MUTATE_CAMPAIGNS",
63474 + "name": "Mutate Campaigns",
63475 + "description": "Create, update, or remove Google Ads campaigns in batch. Supports multiple operations (create, update, remove) in a single request. Use when managing campaign lifecycle, applying bulk changes, or automating campaign management workflows. This action is irreversible for remove operations — deleted campaigns cannot be recovered. Plan accordingly and consider using validate_only=true to test changes before applying them."
63476 + },
63477 {
63478 "slug": "GOOGLESUPER_MUTATE_CONDITIONAL_FORMAT_RULES",
63479 "name": "Mutate conditional format rules",
@@ -61098,6 +63594,11 @@
63594 "name": "Remove attendee from event",
63595 "description": "Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist. Concurrent calls on the same event can overwrite attendee lists — apply changes sequentially per event."
63596 },
63597 + {
63598 + "slug": "GOOGLESUPER_REMOVE_LABEL",
63599 + "name": "Remove label (Deprecated)",
63600 + "description": "DEPRECATED: Use GMAIL_DELETE_LABEL instead. Permanently deletes a specific, existing user-created Gmail label by its ID for a user; cannot delete system labels."
63601 + },
63602 {
63603 "slug": "GOOGLESUPER_RENDER_AERIAL_VIDEO",
63604 "name": "Render Aerial Video",
@@ -61168,6 +63669,11 @@
63669 "name": "Search Spreadsheets",
63670 "description": "Search for Google Spreadsheets using various filters including name, content, date ranges, and more."
63671 },
63672 + {
63673 + "slug": "GOOGLESUPER_SEARCH_STREAM_GAQL",
63674 + "name": "Search Stream GAQL",
63675 + "description": "Execute a Google Ads Query Language (GAQL) query and stream all results in a single response. This method is more efficient than paginated search for bulk data retrieval of campaigns, ad groups, and performance metrics (clicks, impressions, cost). Use this action when you need the entire result set without pagination. Results are returned as a single response containing all matching rows."
63676 + },
63677 {
63678 "slug": "GOOGLESUPER_SEND_DRAFT",
63679 "name": "Send Draft",

This file is too large to show in full.

docs/public/openapi-v3.json
+3783 -1732
@@ -1002,7 +1002,7 @@
1002 "key": {
1003 "type": "string",
1004 "description": "The actual API key value (usually only shown once during creation)",
1005 - "example": "sk_live_abc123xyz456"
1005 + "example": "ak_a1b2c3d4e5f6g7h8i9j0"
1006 },
1007 "deleted": {
1008 "type": "boolean",
@@ -1046,20 +1046,71 @@
1046 "type": "string",
1047 "description": "Access role of the authenticated user within the organization",
1048 "example": "admin"
1049 + },
1050 + "metadata": {
1051 + "type": "object",
1052 + "properties": {
1053 + "createdInBetterAuth": {
1054 + "type": "boolean",
1055 + "description": "Whether the user was created via Better Auth (dashboard signup)."
1056 + },
1057 + "prefers_old_dashboard": {
1058 + "type": "boolean",
1059 + "description": "If true, the user will be redirected to the legacy dashboard at platform.composio.dev."
1060 + },
1061 + "onboarding_platform": {
1062 + "type": "string",
1063 + "enum": [
1064 + "consumer",
1065 + "developer"
1066 + ],
1067 + "description": "Platform the user onboarded on."
1068 + },
1069 + "seen_flow_consumer": {
1070 + "type": "boolean",
1071 + "description": "True once the user has completed the consumer onboarding flow."
1072 + },
1073 + "seen_flow_developer": {
1074 + "type": "boolean",
1075 + "description": "True once the user has completed the developer onboarding flow."
1076 + },
1077 + "seen_flow_cli": {
1078 + "type": "boolean",
1079 + "description": "True once the user has completed the CLI onboarding flow."
1080 + }
1081 + },
1082 + "additionalProperties": {
1083 + "anyOf": [
1084 + {
1085 + "type": "string"
1086 + },
1087 + {
1088 + "type": "boolean"
1089 + },
1090 + {
1091 + "type": "number"
1092 + }
1093 + ]
1094 + },
1095 + "description": "User metadata (JSONB). Typed keys are shown; additional keys pass through unchanged."
1096 }
1097 },
1098 "required": [
1099 "id",
1100 "email",
1101 "name",
1055 - "role"
1102 + "role",
1103 + "metadata"
1104 ],
1105 "description": "Information about the authenticated user",
1106 "example": {
1107 "id": "550e8400-e29b-41d4-a716-446655440002",
1108 "email": "user@example.com",
1109 "name": "John Doe",
1062 - "role": "admin"
1110 + "role": "admin",
1111 + "metadata": {
1112 + "prefers_old_dashboard": false
1113 + }
1114 }
1115 }
1116 },
@@ -2695,7 +2746,8 @@
2746 "ACTIVE",
2747 "FAILED",
2748 "EXPIRED",
2698 - "INACTIVE"
2749 + "INACTIVE",
2750 + "REVOKED"
2751 ]
2752 },
2753 "description": "The status of the connected account"
@@ -2914,7 +2966,8 @@
2966 "ACTIVE",
2967 "FAILED",
2968 "EXPIRED",
2917 - "INACTIVE"
2969 + "INACTIVE",
2970 + "REVOKED"
2971 ],
2972 "description": "The status of the connection"
2973 },
@@ -3084,7 +3137,7 @@
3137 "status_reason": {
3138 "type": "string",
3139 "nullable": true,
3087 - "description": "The reason the connection status changed. Possible reasons: Connection initiation did not complete within 10 minutes, Permanent auth error during token refresh, Max auth failures reached, OAuth callback failed during token exchange, Connection status updated by user, Auth config is disabled"
3140 + "description": "The reason the connection status changed. Possible reasons: Connection initiation did not complete within 10 minutes, Permanent auth error during token refresh, Max auth failures reached, OAuth callback failed during token exchange, Connection status updated by user, Auth config is disabled, Revoked via user-initiated revoke endpoint, Revoked via admin tool, Revoked as part of connection delete"
3141 },
3142 "is_disabled": {
3143 "type": "boolean",
@@ -3213,7 +3266,7 @@
3266 },
3267 "post": {
3268 "summary": "Create a new connected account",
3216 - "description": "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.",
3269 + "description": "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.\n\n**Deprecated for Composio-managed OAuth:** For Composio-managed auth configs on OAuth1, OAuth2, or DCR_OAUTH schemes, this endpoint is being retired and will start returning `400 BadRequest` on **2026-05-08** for new organizations and **2026-07-03** for all remaining organizations. Migrate those calls to `POST /api/v3/connected_accounts/link`. Custom auth configs and non-OAuth schemes (API key, bearer, basic) continue to be supported here. Responses on the retiring path carry a `Deprecation` header (RFC 9745) and a `Sunset` header (RFC 8594) for client-side detection.",
3270 "tags": [
3271 "Connected Accounts"
3272 ],
@@ -3616,7 +3669,8 @@
3669 "ACTIVE",
3670 "FAILED",
3671 "EXPIRED",
3619 - "INACTIVE"
3672 + "INACTIVE",
3673 + "REVOKED"
3674 ],
3675 "description": "DEPRECATED: This field will be removed in a future version",
3676 "deprecated": true
@@ -3857,7 +3911,8 @@
3911 "ACTIVE",
3912 "FAILED",
3913 "EXPIRED",
3860 - "INACTIVE"
3914 + "INACTIVE",
3915 + "REVOKED"
3916 ],
3917 "description": "The status of the connection"
3918 },
@@ -4027,7 +4082,7 @@
4082 "status_reason": {
4083 "type": "string",
4084 "nullable": true,
4030 - "description": "The reason the connection status changed. Possible reasons: Connection initiation did not complete within 10 minutes, Permanent auth error during token refresh, Max auth failures reached, OAuth callback failed during token exchange, Connection status updated by user, Auth config is disabled"
4085 + "description": "The reason the connection status changed. Possible reasons: Connection initiation did not complete within 10 minutes, Permanent auth error during token refresh, Max auth failures reached, OAuth callback failed during token exchange, Connection status updated by user, Auth config is disabled, Revoked via user-initiated revoke endpoint, Revoked via admin tool, Revoked as part of connection delete"
4086 },
4087 "is_disabled": {
4088 "type": "boolean",
@@ -4611,7 +4666,8 @@
4666 "ACTIVE",
4667 "FAILED",
4668 "EXPIRED",
4614 - "INACTIVE"
4669 + "INACTIVE",
4670 + "REVOKED"
4671 ],
4672 "description": "The current status of the connected account (e.g., active, pending, failed)"
4673 },
@@ -4676,8 +4732,8 @@
4732 }
4733 }
4734 },
4679 - "500": {
4680 - "description": "Internal server error - Failed to refresh the connected account authentication",
4735 + "409": {
4736 + "description": "Conflict - The connection cannot be refreshed because of a permanent attribute (e.g. its auth scheme does not support refresh, such as API_KEY or BEARER_TOKEN)",
4737 "content": {
4738 "application/json": {
4739 "schema": {
@@ -4686,8 +4742,18 @@
4742 }
4743 }
4744 },
4689 - "501": {
4690 - "description": "Not implemented - This operation is not supported for the requested connected account or authentication scheme",
4745 + "422": {
4746 + "description": "Unprocessable entity - The connection is in an invalid state for refresh (e.g. connection-data validation failed, or the stored connection status is incompatible with reinitiation)",
4747 + "content": {
4748 + "application/json": {
4749 + "schema": {
4750 + "$ref": "#/components/schemas/Error"
4751 + }
4752 + }
4753 + }
4754 + },
4755 + "500": {
4756 + "description": "Internal server error - Failed to refresh the connected account authentication",
4757 "content": {
4758 "application/json": {
4759 "schema": {
@@ -4917,6 +4983,9 @@
4983 },
4984 "description": "for slack user scopes"
4985 },
4986 + "revoked_at": {
4987 + "type": "string"
4988 + },
4989 "generic_api_key": {
4990 "type": "string"
4991 },
@@ -7033,14 +7102,14 @@
7102 "x-api-version": "3.0"
7103 }
7104 },
7036 - "/api/v3/toolkits": {
7037 - "get": {
7038 - "summary": "List available toolkits",
7039 - "description": "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.",
7105 + "/api/v3/webhook_endpoints": {
7106 + "post": {
7107 + "summary": "Create webhook endpoint",
7108 + "description": "Creates a shared webhook endpoint for a toolkit + OAuth app + project. Returns the webhook URL that the customer registers in their app dashboard. Idempotent — returns existing endpoint if one already exists for this toolkit + client_id + project.",
7109 "tags": [
7041 - "Toolkits"
7110 + "Webhooks"
7111 ],
7043 - "operationId": "getToolkits",
7112 + "operationId": "postWebhookEndpoints",
7113 "security": [
7114 {
7115 "ApiKeyAuth": []
@@ -7049,94 +7118,203 @@
7118 "UserApiKeyAuth": []
7119 }
7120 ],
7052 - "parameters": [
7053 - {
7054 - "schema": {
7055 - "type": "string",
7056 - "description": "Category ID or name to filter toolkits by",
7057 - "example": "productivity"
7058 - },
7059 - "required": false,
7060 - "description": "Filter toolkits by category",
7061 - "name": "category",
7062 - "in": "query"
7121 + "requestBody": {
7122 + "content": {
7123 + "application/json": {
7124 + "schema": {
7125 + "type": "object",
7126 + "properties": {
7127 + "toolkit_slug": {
7128 + "type": "string",
7129 + "minLength": 1,
7130 + "description": "Toolkit identifier (e.g., slack, discord)"
7131 + },
7132 + "client_id": {
7133 + "type": "string",
7134 + "minLength": 1,
7135 + "description": "OAuth app client ID — identifies which app this endpoint is for"
7136 + }
7137 + },
7138 + "required": [
7139 + "toolkit_slug",
7140 + "client_id"
7141 + ]
7142 + }
7143 + }
7144 + }
7145 + },
7146 + "responses": {
7147 + "200": {
7148 + "description": "Existing webhook endpoint returned",
7149 + "content": {
7150 + "application/json": {
7151 + "schema": {
7152 + "type": "object",
7153 + "properties": {
7154 + "id": {
7155 + "type": "string",
7156 + "description": "Webhook endpoint nano ID"
7157 + },
7158 + "toolkit_slug": {
7159 + "type": "string",
7160 + "description": "Toolkit this endpoint is for"
7161 + },
7162 + "client_id": {
7163 + "type": "string",
7164 + "nullable": true,
7165 + "description": "OAuth app client ID"
7166 + },
7167 + "webhook_url": {
7168 + "type": "string",
7169 + "description": "The webhook URL to register with the provider"
7170 + },
7171 + "data": {
7172 + "type": "object",
7173 + "nullable": true,
7174 + "additionalProperties": {
7175 + "type": "string"
7176 + },
7177 + "description": "Configured fields with secret values masked"
7178 + },
7179 + "created_at": {
7180 + "type": "string",
7181 + "description": "ISO 8601 timestamp"
7182 + }
7183 + },
7184 + "required": [
7185 + "id",
7186 + "toolkit_slug",
7187 + "client_id",
7188 + "webhook_url",
7189 + "data",
7190 + "created_at"
7191 + ]
7192 + }
7193 + }
7194 + }
7195 },
7064 - {
7065 - "schema": {
7066 - "type": "string",
7067 - "enum": [
7068 - "composio",
7069 - "all",
7070 - "project"
7071 - ],
7072 - "description": "Entity responsible for managing the toolkits"
7073 - },
7074 - "required": false,
7075 - "description": "Filter toolkits by who manages them",
7076 - "name": "managed_by",
7077 - "in": "query"
7196 + "201": {
7197 + "description": "Webhook endpoint created",
7198 + "content": {
7199 + "application/json": {
7200 + "schema": {
7201 + "type": "object",
7202 + "properties": {
7203 + "id": {
7204 + "type": "string",
7205 + "description": "Webhook endpoint nano ID"
7206 + },
7207 + "toolkit_slug": {
7208 + "type": "string",
7209 + "description": "Toolkit this endpoint is for"
7210 + },
7211 + "client_id": {
7212 + "type": "string",
7213 + "nullable": true,
7214 + "description": "OAuth app client ID"
7215 + },
7216 + "webhook_url": {
7217 + "type": "string",
7218 + "description": "The webhook URL to register with the provider"
7219 + },
7220 + "data": {
7221 + "type": "object",
7222 + "nullable": true,
7223 + "additionalProperties": {
7224 + "type": "string"
7225 + },
7226 + "description": "Configured fields with secret values masked"
7227 + },
7228 + "created_at": {
7229 + "type": "string",
7230 + "description": "ISO 8601 timestamp"
7231 + }
7232 + },
7233 + "required": [
7234 + "id",
7235 + "toolkit_slug",
7236 + "client_id",
7237 + "webhook_url",
7238 + "data",
7239 + "created_at"
7240 + ]
7241 + }
7242 + }
7243 + }
7244 + },
7245 + "400": {
7246 + "description": "Bad request",
7247 + "content": {
7248 + "application/json": {
7249 + "schema": {
7250 + "$ref": "#/components/schemas/Error"
7251 + }
7252 + }
7253 + }
7254 + },
7255 + "401": {
7256 + "description": "Unauthorized",
7257 + "content": {
7258 + "application/json": {
7259 + "schema": {
7260 + "$ref": "#/components/schemas/Error"
7261 + }
7262 + }
7263 + }
7264 + },
7265 + "404": {
7266 + "description": "Not found",
7267 + "content": {
7268 + "application/json": {
7269 + "schema": {
7270 + "$ref": "#/components/schemas/Error"
7271 + }
7272 + }
7273 + }
7274 },
7275 + "500": {
7276 + "description": "Internal server error",
7277 + "content": {
7278 + "application/json": {
7279 + "schema": {
7280 + "$ref": "#/components/schemas/Error"
7281 + }
7282 + }
7283 + }
7284 + }
7285 + },
7286 + "x-api-version": "3.0"
7287 + },
7288 + "get": {
7289 + "summary": "List webhook endpoints",
7290 + "description": "Lists webhook endpoints for the authenticated project, optionally filtered by toolkit.",
7291 + "tags": [
7292 + "Webhooks"
7293 + ],
7294 + "operationId": "getWebhookEndpoints",
7295 + "security": [
7296 {
7080 - "schema": {
7081 - "type": "string",
7082 - "enum": [
7083 - "usage",
7084 - "alphabetically"
7085 - ],
7086 - "description": "Determines how toolkits should be sorted in the response"
7087 - },
7088 - "required": false,
7089 - "description": "Sort order for returned toolkits",
7090 - "name": "sort_by",
7091 - "in": "query"
7297 + "ApiKeyAuth": []
7298 },
7299 + {
7300 + "UserApiKeyAuth": []
7301 + }
7302 + ],
7303 + "parameters": [
7304 {
7305 "schema": {
7095 - "type": "boolean",
7096 - "nullable": true,
7097 - "default": false,
7098 - "description": "Include deprecated toolkits in the response",
7099 - "example": true
7306 + "type": "string",
7307 + "description": "Filter by toolkit slug"
7308 },
7309 "required": false,
7102 - "description": "Include deprecated toolkits in the response",
7103 - "name": "include_deprecated",
7104 - "in": "query"
7105 - },
7106 - {
7107 - "schema": {
7108 - "type": "string",
7109 - "description": "Search query to filter toolkits by name, slug, or description (minimum 3 characters)",
7110 - "example": "gmail"
7111 - },
7112 - "required": false,
7113 - "description": "Search query to filter toolkits by name, slug, or description",
7114 - "name": "search",
7115 - "in": "query"
7116 - },
7117 - {
7118 - "schema": {
7119 - "type": "number",
7120 - "nullable": true
7121 - },
7122 - "required": false,
7123 - "description": "Number of items per page, max allowed is 1000",
7124 - "name": "limit",
7125 - "in": "query"
7126 - },
7127 - {
7128 - "schema": {
7129 - "type": "string"
7130 - },
7131 - "required": false,
7132 - "description": "Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.",
7133 - "name": "cursor",
7310 + "description": "Filter by toolkit slug",
7311 + "name": "toolkit_slug",
7312 "in": "query"
7313 }
7314 ],
7315 "responses": {
7316 "200": {
7139 - "description": "Toolkits retrieved successfully. Returns a paginated list of available toolkits with detailed metadata.",
7317 + "description": "Success",
7318 "content": {
7319 "application/json": {
7320 "schema": {
@@ -7147,204 +7325,37 @@
7325 "items": {
7326 "type": "object",
7327 "properties": {
7150 - "slug": {
7328 + "id": {
7329 "type": "string",
7152 - "description": "URL-friendly unique identifier for the toolkit",
7153 - "example": "github"
7330 + "description": "Webhook endpoint nano ID"
7331 },
7155 - "name": {
7332 + "toolkit_slug": {
7333 "type": "string",
7157 - "description": "Human-readable name of the toolkit",
7158 - "example": "GitHub"
7159 - },
7160 - "auth_schemes": {
7161 - "type": "array",
7162 - "items": {
7163 - "type": "string"
7164 - },
7165 - "description": "List of authentication methods supported by this toolkit",
7166 - "example": [
7167 - "oauth2",
7168 - "api_key"
7169 - ]
7170 - },
7171 - "composio_managed_auth_schemes": {
7172 - "type": "array",
7173 - "items": {
7174 - "type": "string"
7175 - },
7176 - "description": "List of authentication methods that Composio manages for this toolkit",
7177 - "example": [
7178 - "oauth2"
7179 - ]
7180 - },
7181 - "is_local_toolkit": {
7182 - "type": "boolean",
7183 - "description": "DEPRECATED: This field is no longer meaningful and will always return false. It was previously used to indicate if a toolkit is specific to the current project.",
7184 - "deprecated": true,
7185 - "example": false
7334 + "description": "Toolkit this endpoint is for"
7335 },
7187 - "no_auth": {
7188 - "type": "boolean",
7189 - "description": "When true, this toolkit can be used without authentication",
7190 - "example": false
7191 - },
7192 - "auth_guide_url": {
7336 + "client_id": {
7337 "type": "string",
7338 "nullable": true,
7195 - "description": "URL to a guide page with authentication setup instructions for this toolkit",
7196 - "example": "https://composio.dev/auth/github"
7197 - },
7198 - "deprecated": {
7199 - "$ref": "#/components/schemas/DeprecatedToolkitInfo"
7200 - },
7201 - "meta": {
7202 - "type": "object",
7203 - "properties": {
7204 - "created_at": {
7205 - "type": "string",
7206 - "description": "Creation date and time of the toolkit",
7207 - "example": "2023-01-15T09:30:00.000Z"
7208 - },
7209 - "updated_at": {
7210 - "type": "string",
7211 - "description": "Last modification date and time of the toolkit",
7212 - "example": "2023-05-20T14:45:00.000Z"
7213 - },
7214 - "description": {
7215 - "type": "string",
7216 - "description": "Human-readable description explaining the toolkit's purpose and functionality",
7217 - "example": "Integrate with GitHub repositories, issues, pull requests, and more."
7218 - },
7219 - "logo": {
7220 - "type": "string",
7221 - "description": "Image URL for the toolkit's branding",
7222 - "example": "https://assets.composio.dev/logos/github.png"
7223 - },
7224 - "app_url": {
7225 - "type": "string",
7226 - "nullable": true,
7227 - "description": "Link to the toolkit's main application or service website",
7228 - "example": "https://github.com"
7229 - },
7230 - "categories": {
7231 - "type": "array",
7232 - "items": {
7233 - "type": "object",
7234 - "properties": {
7235 - "id": {
7236 - "type": "string",
7237 - "description": "Category identifier",
7238 - "example": "developer-tools"
7239 - },
7240 - "name": {
7241 - "type": "string",
7242 - "description": "Human-readable category name",
7243 - "example": "Developer Tools"
7244 - }
7245 - },
7246 - "required": [
7247 - "id",
7248 - "name"
7249 - ]
7250 - },
7251 - "description": "List of categories associated with this toolkit",
7252 - "example": [
7253 - {
7254 - "id": "developer-tools",
7255 - "name": "Developer Tools"
7256 - },
7257 - {
7258 - "id": "productivity",
7259 - "name": "Productivity"
7260 - }
7261 - ]
7262 - },
7263 - "triggers_count": {
7264 - "type": "number",
7265 - "description": "Count of available triggers in this toolkit",
7266 - "example": 5
7267 - },
7268 - "tools_count": {
7269 - "type": "number",
7270 - "description": "Count of available tools in this toolkit",
7271 - "example": 12
7272 - },
7273 - "version": {
7274 - "type": "string",
7275 - "description": "Version of the toolkit",
7276 - "example": "20250905_00"
7277 - }
7278 - },
7279 - "required": [
7280 - "created_at",
7281 - "updated_at",
7282 - "description",
7283 - "logo",
7284 - "categories",
7285 - "triggers_count",
7286 - "tools_count",
7287 - "version"
7288 - ],
7289 - "description": "Additional metadata about the toolkit"
7339 + "description": "OAuth app client ID"
7340 }
7341 },
7342 "required": [
7293 - "slug",
7294 - "name",
7295 - "is_local_toolkit",
7296 - "deprecated",
7297 - "meta"
7298 - ],
7299 - "description": "Detailed information about a toolkit"
7343 + "id",
7344 + "toolkit_slug",
7345 + "client_id"
7346 + ]
7347 }
7301 - },
7302 - "next_cursor": {
7303 - "type": "string",
7304 - "nullable": true
7305 - },
7306 - "total_pages": {
7307 - "type": "number"
7308 - },
7309 - "current_page": {
7310 - "type": "number"
7311 - },
7312 - "total_items": {
7313 - "type": "number"
7348 }
7349 },
7350 "required": [
7317 - "items",
7318 - "total_pages",
7319 - "current_page",
7320 - "total_items"
7351 + "items"
7352 ]
7353 }
7354 }
7355 }
7356 },
7326 - "400": {
7327 - "description": "Bad request. The query parameters may be invalid or in an incorrect format.",
7328 - "content": {
7329 - "application/json": {
7330 - "schema": {
7331 - "$ref": "#/components/schemas/Error"
7332 - }
7333 - }
7334 - }
7335 - },
7357 "401": {
7337 - "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",
7338 - "content": {
7339 - "application/json": {
7340 - "schema": {
7341 - "$ref": "#/components/schemas/Error"
7342 - }
7343 - }
7344 - }
7345 - },
7346 - "404": {
7347 - "description": "Not found. The toolkits you are looking for do not exist.",
7358 + "description": "Unauthorized",
7359 "content": {
7360 "application/json": {
7361 "schema": {
@@ -7354,7 +7365,7 @@
7365 }
7366 },
7367 "500": {
7357 - "description": "Internal server error. An unexpected error occurred while processing the request.",
7368 + "description": "Internal server error",
7369 "content": {
7370 "application/json": {
7371 "schema": {
@@ -7367,14 +7378,14 @@
7378 "x-api-version": "3.0"
7379 }
7380 },
7370 - "/api/v3/toolkits/categories": {
7381 + "/api/v3/webhook_endpoints/{nano_id}": {
7382 "get": {
7372 - "summary": "List toolkit categories",
7373 - "description": "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.",
7383 + "summary": "Get webhook endpoint",
7384 + "description": "Retrieves a single webhook endpoint. Secret values are redacted. Use GET /webhook_endpoints/schema to discover field definitions.",
7385 "tags": [
7375 - "Toolkits"
7386 + "Webhooks"
7387 ],
7377 - "operationId": "getToolkitsCategories",
7388 + "operationId": "getWebhookEndpointsByNanoId",
7389 "security": [
7390 {
7391 "ApiKeyAuth": []
@@ -7383,63 +7394,70 @@
7394 "UserApiKeyAuth": []
7395 }
7396 ],
7397 + "parameters": [
7398 + {
7399 + "schema": {
7400 + "type": "string",
7401 + "description": "Webhook endpoint nano ID (e.g., we_abc123)"
7402 + },
7403 + "required": true,
7404 + "description": "Webhook endpoint nano ID (e.g., we_abc123)",
7405 + "name": "nano_id",
7406 + "in": "path"
7407 + }
7408 + ],
7409 "responses": {
7410 "200": {
7388 - "description": "Successfully retrieved a paginated list of all available toolkit categories with their identifiers and display names.",
7411 + "description": "Success",
7412 "content": {
7413 "application/json": {
7414 "schema": {
7415 "type": "object",
7416 "properties": {
7394 - "items": {
7395 - "type": "array",
7396 - "items": {
7397 - "type": "object",
7398 - "properties": {
7399 - "name": {
7400 - "type": "string",
7401 - "description": "Display name of the toolkit category",
7402 - "example": "Developer Tools"
7403 - },
7404 - "id": {
7405 - "type": "string",
7406 - "description": "URL-friendly unique identifier for the category, used for filtering toolkits",
7407 - "example": "developer-tools"
7408 - }
7409 - },
7410 - "required": [
7411 - "name",
7412 - "id"
7413 - ],
7414 - "description": "Information about a single toolkit category"
7415 - }
7417 + "id": {
7418 + "type": "string",
7419 + "description": "Webhook endpoint nano ID"
7420 },
7417 - "next_cursor": {
7421 + "toolkit_slug": {
7422 "type": "string",
7419 - "nullable": true
7423 + "description": "Toolkit this endpoint is for"
7424 },
7421 - "total_pages": {
7422 - "type": "number"
7425 + "client_id": {
7426 + "type": "string",
7427 + "nullable": true,
7428 + "description": "OAuth app client ID"
7429 },
7424 - "current_page": {
7425 - "type": "number"
7430 + "webhook_url": {
7431 + "type": "string",
7432 + "description": "The webhook URL to register with the provider"
7433 },
7427 - "total_items": {
7428 - "type": "number"
7434 + "data": {
7435 + "type": "object",
7436 + "nullable": true,
7437 + "additionalProperties": {
7438 + "type": "string"
7439 + },
7440 + "description": "Configured fields with secret values masked"
7441 + },
7442 + "created_at": {
7443 + "type": "string",
7444 + "description": "ISO 8601 timestamp"
7445 }
7446 },
7447 "required": [
7432 - "items",
7433 - "total_pages",
7434 - "current_page",
7435 - "total_items"
7448 + "id",
7449 + "toolkit_slug",
7450 + "client_id",
7451 + "webhook_url",
7452 + "data",
7453 + "created_at"
7454 ]
7455 }
7456 }
7457 }
7458 },
7459 "400": {
7442 - "description": "Bad request. The request may be invalid or in an incorrect format.",
7460 + "description": "Bad request",
7461 "content": {
7462 "application/json": {
7463 "schema": {
@@ -7449,7 +7467,7 @@
7467 }
7468 },
7469 "401": {
7452 - "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",
7470 + "description": "Unauthorized",
7471 "content": {
7472 "application/json": {
7473 "schema": {
@@ -7459,7 +7477,7 @@
7477 }
7478 },
7479 "404": {
7462 - "description": "Not found. The requested resource was not found.",
7480 + "description": "Not found",
7481 "content": {
7482 "application/json": {
7483 "schema": {
@@ -7469,7 +7487,7 @@
7487 }
7488 },
7489 "500": {
7472 - "description": "Internal server error. An unexpected error occurred while processing the request.",
7490 + "description": "Internal server error",
7491 "content": {
7492 "application/json": {
7493 "schema": {
@@ -7480,16 +7498,14 @@
7498 }
7499 },
7500 "x-api-version": "3.0"
7483 - }
7484 - },
7485 - "/api/v3/toolkits/{slug}": {
7486 - "get": {
7487 - "summary": "Get toolkit by slug",
7488 - "description": "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.",
7501 + },
7502 + "post": {
7503 + "summary": "Put webhook endpoint configuration",
7504 + "description": "Full replacement of webhook endpoint configuration. All required setup fields must be provided. Use PATCH to update individual fields.",
7505 "tags": [
7490 - "Toolkits"
7506 + "Webhooks"
7507 ],
7492 - "operationId": "getToolkitsBySlug",
7508 + "operationId": "postWebhookEndpointsByNanoId",
7509 "security": [
7510 {
7511 "ApiKeyAuth": []
@@ -7502,90 +7518,823 @@
7518 {
7519 "schema": {
7520 "type": "string",
7505 - "description": "The unique slug identifier of the toolkit to retrieve",
7506 - "example": "github"
7521 + "description": "Webhook endpoint nano ID (e.g., we_abc123)"
7522 },
7523 "required": true,
7509 - "description": "Toolkit slug identifier",
7510 - "name": "slug",
7524 + "description": "Webhook endpoint nano ID (e.g., we_abc123)",
7525 + "name": "nano_id",
7526 "in": "path"
7527 + }
7528 + ],
7529 + "requestBody": {
7530 + "content": {
7531 + "application/json": {
7532 + "schema": {
7533 + "type": "object",
7534 + "properties": {
7535 + "data": {
7536 + "type": "object",
7537 + "additionalProperties": {
7538 + "type": "string"
7539 + },
7540 + "description": "Key-value pairs for ALL required setup_fields. Unlike PATCH, all required fields must be provided — this is initial configuration."
7541 + }
7542 + },
7543 + "required": [
7544 + "data"
7545 + ]
7546 + }
7547 + }
7548 + }
7549 + },
7550 + "responses": {
7551 + "200": {
7552 + "description": "Configured",
7553 + "content": {
7554 + "application/json": {
7555 + "schema": {
7556 + "type": "object",
7557 + "properties": {
7558 + "id": {
7559 + "type": "string",
7560 + "description": "Webhook endpoint nano ID"
7561 + },
7562 + "toolkit_slug": {
7563 + "type": "string",
7564 + "description": "Toolkit this endpoint is for"
7565 + },
7566 + "client_id": {
7567 + "type": "string",
7568 + "nullable": true,
7569 + "description": "OAuth app client ID"
7570 + },
7571 + "webhook_url": {
7572 + "type": "string",
7573 + "description": "The webhook URL to register with the provider"
7574 + },
7575 + "data": {
7576 + "type": "object",
7577 + "nullable": true,
7578 + "additionalProperties": {
7579 + "type": "string"
7580 + },
7581 + "description": "Configured fields with secret values masked"
7582 + },
7583 + "created_at": {
7584 + "type": "string",
7585 + "description": "ISO 8601 timestamp"
7586 + }
7587 + },
7588 + "required": [
7589 + "id",
7590 + "toolkit_slug",
7591 + "client_id",
7592 + "webhook_url",
7593 + "data",
7594 + "created_at"
7595 + ]
7596 + }
7597 + }
7598 + }
7599 + },
7600 + "400": {
7601 + "description": "Bad request",
7602 + "content": {
7603 + "application/json": {
7604 + "schema": {
7605 + "$ref": "#/components/schemas/Error"
7606 + }
7607 + }
7608 + }
7609 + },
7610 + "401": {
7611 + "description": "Unauthorized",
7612 + "content": {
7613 + "application/json": {
7614 + "schema": {
7615 + "$ref": "#/components/schemas/Error"
7616 + }
7617 + }
7618 + }
7619 + },
7620 + "404": {
7621 + "description": "Not found",
7622 + "content": {
7623 + "application/json": {
7624 + "schema": {
7625 + "$ref": "#/components/schemas/Error"
7626 + }
7627 + }
7628 + }
7629 + },
7630 + "500": {
7631 + "description": "Internal server error",
7632 + "content": {
7633 + "application/json": {
7634 + "schema": {
7635 + "$ref": "#/components/schemas/Error"
7636 + }
7637 + }
7638 + }
7639 + }
7640 + },
7641 + "x-api-version": "3.0"
7642 + },
7643 + "patch": {
7644 + "summary": "Update webhook endpoint configuration",
7645 + "description": "Updates app-specific secrets and credentials. Uses merge semantics — only included fields are updated; omitted fields are preserved. Can be called on active endpoints (e.g., to rotate a signing secret).",
7646 + "tags": [
7647 + "Webhooks"
7648 + ],
7649 + "operationId": "patchWebhookEndpointsByNanoId",
7650 + "security": [
7651 + {
7652 + "ApiKeyAuth": []
7653 },
7654 + {
7655 + "UserApiKeyAuth": []
7656 + }
7657 + ],
7658 + "parameters": [
7659 {
7660 "schema": {
7661 "type": "string",
7516 - "default": "latest",
7517 - "description": "Version of the toolkit",
7518 - "example": "20250905_00"
7662 + "description": "Webhook endpoint nano ID (e.g., we_abc123)"
7663 },
7520 - "required": false,
7521 - "description": "Version of the toolkit",
7522 - "name": "version",
7523 - "in": "query"
7664 + "required": true,
7665 + "description": "Webhook endpoint nano ID (e.g., we_abc123)",
7666 + "name": "nano_id",
7667 + "in": "path"
7668 }
7669 ],
7670 + "requestBody": {
7671 + "content": {
7672 + "application/json": {
7673 + "schema": {
7674 + "type": "object",
7675 + "properties": {
7676 + "data": {
7677 + "type": "object",
7678 + "additionalProperties": {
7679 + "type": "string"
7680 + },
7681 + "description": "Key-value pairs matching the toolkit's setup_fields. Only include fields you want to update — omitted fields are preserved."
7682 + }
7683 + },
7684 + "required": [
7685 + "data"
7686 + ]
7687 + }
7688 + }
7689 + }
7690 + },
7691 "responses": {
7692 "200": {
7528 - "description": "Successfully retrieved detailed information about the requested toolkit, including authentication options, metadata, and feature counts.",
7693 + "description": "Updated",
7694 "content": {
7695 "application/json": {
7696 "schema": {
7697 "type": "object",
7698 "properties": {
7534 - "slug": {
7699 + "id": {
7700 "type": "string",
7536 - "description": "URL-friendly unique identifier for the toolkit",
7537 - "example": "github"
7701 + "description": "Webhook endpoint nano ID"
7702 },
7539 - "name": {
7703 + "toolkit_slug": {
7704 "type": "string",
7541 - "description": "Human-readable name of the toolkit",
7542 - "example": "GitHub"
7705 + "description": "Toolkit this endpoint is for"
7706 },
7544 - "enabled": {
7545 - "type": "boolean",
7546 - "description": "Indicates if this toolkit is currently enabled and available for use",
7547 - "example": true
7707 + "client_id": {
7708 + "type": "string",
7709 + "nullable": true,
7710 + "description": "OAuth app client ID"
7711 },
7549 - "composio_managed_auth_schemes": {
7550 - "type": "array",
7551 - "items": {
7712 + "webhook_url": {
7713 + "type": "string",
7714 + "description": "The webhook URL to register with the provider"
7715 + },
7716 + "data": {
7717 + "type": "object",
7718 + "nullable": true,
7719 + "additionalProperties": {
7720 "type": "string"
7721 },
7554 - "description": "List of authentication methods that Composio manages for this toolkit",
7555 - "example": [
7556 - "oauth2"
7557 - ]
7558 - },
7559 - "is_local_toolkit": {
7560 - "type": "boolean",
7561 - "description": "DEPRECATED: This field is no longer meaningful and will always return false. It was previously used to indicate if a toolkit is specific to the current project.",
7562 - "deprecated": true,
7563 - "example": false
7722 + "description": "Configured fields with secret values masked"
7723 },
7565 - "auth_config_details": {
7566 - "type": "array",
7567 - "items": {
7568 - "type": "object",
7569 - "properties": {
7570 - "mode": {
7571 - "type": "string",
7572 - "description": "The type of authentication mode (e.g., oauth2, basic_auth, api_key)",
7573 - "example": "oauth2"
7574 - },
7575 - "fields": {
7576 - "type": "object",
7577 - "properties": {
7578 - "auth_config_creation": {
7579 - "type": "object",
7580 - "properties": {
7581 - "required": {
7582 - "type": "array",
7583 - "items": {
7584 - "type": "object",
7585 - "properties": {
7586 - "name": {
7587 - "type": "string"
7588 - },
7724 + "created_at": {
7725 + "type": "string",
7726 + "description": "ISO 8601 timestamp"
7727 + }
7728 + },
7729 + "required": [
7730 + "id",
7731 + "toolkit_slug",
7732 + "client_id",
7733 + "webhook_url",
7734 + "data",
7735 + "created_at"
7736 + ]
7737 + }
7738 + }
7739 + }
7740 + },
7741 + "400": {
7742 + "description": "Bad request",
7743 + "content": {
7744 + "application/json": {
7745 + "schema": {
7746 + "$ref": "#/components/schemas/Error"
7747 + }
7748 + }
7749 + }
7750 + },
7751 + "401": {
7752 + "description": "Unauthorized",
7753 + "content": {
7754 + "application/json": {
7755 + "schema": {
7756 + "$ref": "#/components/schemas/Error"
7757 + }
7758 + }
7759 + }
7760 + },
7761 + "404": {
7762 + "description": "Not found",
7763 + "content": {
7764 + "application/json": {
7765 + "schema": {
7766 + "$ref": "#/components/schemas/Error"
7767 + }
7768 + }
7769 + }
7770 + },
7771 + "500": {
7772 + "description": "Internal server error",
7773 + "content": {
7774 + "application/json": {
7775 + "schema": {
7776 + "$ref": "#/components/schemas/Error"
7777 + }
7778 + }
7779 + }
7780 + }
7781 + },
7782 + "x-api-version": "3.0"
7783 + }
7784 + },
7785 + "/api/v3/toolkits": {
7786 + "get": {
7787 + "summary": "List available toolkits",
7788 + "description": "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.",
7789 + "tags": [
7790 + "Toolkits"
7791 + ],
7792 + "operationId": "getToolkits",
7793 + "security": [
7794 + {
7795 + "ApiKeyAuth": []
7796 + },
7797 + {
7798 + "UserApiKeyAuth": []
7799 + }
7800 + ],
7801 + "parameters": [
7802 + {
7803 + "schema": {
7804 + "type": "string",
7805 + "description": "Category ID or name to filter toolkits by",
7806 + "example": "productivity"
7807 + },
7808 + "required": false,
7809 + "description": "Filter toolkits by category",
7810 + "name": "category",
7811 + "in": "query"
7812 + },
7813 + {
7814 + "schema": {
7815 + "type": "string",
7816 + "enum": [
7817 + "composio",
7818 + "all",
7819 + "project"
7820 + ],
7821 + "description": "Entity responsible for managing the toolkits"
7822 + },
7823 + "required": false,
7824 + "description": "Filter toolkits by who manages them",
7825 + "name": "managed_by",
7826 + "in": "query"
7827 + },
7828 + {
7829 + "schema": {
7830 + "type": "string",
7831 + "enum": [
7832 + "usage",
7833 + "alphabetically"
7834 + ],
7835 + "description": "Determines how toolkits should be sorted in the response"
7836 + },
7837 + "required": false,
7838 + "description": "Sort order for returned toolkits",
7839 + "name": "sort_by",
7840 + "in": "query"
7841 + },
7842 + {
7843 + "schema": {
7844 + "type": "boolean",
7845 + "nullable": true,
7846 + "default": false,
7847 + "description": "Include deprecated toolkits in the response",
7848 + "example": true
7849 + },
7850 + "required": false,
7851 + "description": "Include deprecated toolkits in the response",
7852 + "name": "include_deprecated",
7853 + "in": "query"
7854 + },
7855 + {
7856 + "schema": {
7857 + "type": "string",
7858 + "description": "Search query to filter toolkits by name, slug, or description (minimum 3 characters)",
7859 + "example": "gmail"
7860 + },
7861 + "required": false,
7862 + "description": "Search query to filter toolkits by name, slug, or description",
7863 + "name": "search",
7864 + "in": "query"
7865 + },
7866 + {
7867 + "schema": {
7868 + "type": "number",
7869 + "nullable": true
7870 + },
7871 + "required": false,
7872 + "description": "Number of items per page, max allowed is 1000",
7873 + "name": "limit",
7874 + "in": "query"
7875 + },
7876 + {
7877 + "schema": {
7878 + "type": "string"
7879 + },
7880 + "required": false,
7881 + "description": "Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.",
7882 + "name": "cursor",
7883 + "in": "query"
7884 + }
7885 + ],
7886 + "responses": {
7887 + "200": {
7888 + "description": "Toolkits retrieved successfully. Returns a paginated list of available toolkits with detailed metadata.",
7889 + "content": {
7890 + "application/json": {
7891 + "schema": {
7892 + "type": "object",
7893 + "properties": {
7894 + "items": {
7895 + "type": "array",
7896 + "items": {
7897 + "type": "object",
7898 + "properties": {
7899 + "slug": {
7900 + "type": "string",
7901 + "description": "URL-friendly unique identifier for the toolkit",
7902 + "example": "github"
7903 + },
7904 + "name": {
7905 + "type": "string",
7906 + "description": "Human-readable name of the toolkit",
7907 + "example": "GitHub"
7908 + },
7909 + "auth_schemes": {
7910 + "type": "array",
7911 + "items": {
7912 + "type": "string"
7913 + },
7914 + "description": "List of authentication methods supported by this toolkit",
7915 + "example": [
7916 + "oauth2",
7917 + "api_key"
7918 + ]
7919 + },
7920 + "composio_managed_auth_schemes": {
7921 + "type": "array",
7922 + "items": {
7923 + "type": "string"
7924 + },
7925 + "description": "List of authentication methods that Composio manages for this toolkit",
7926 + "example": [
7927 + "oauth2"
7928 + ]
7929 + },
7930 + "is_local_toolkit": {
7931 + "type": "boolean",
7932 + "description": "DEPRECATED: This field is no longer meaningful and will always return false. It was previously used to indicate if a toolkit is specific to the current project.",
7933 + "deprecated": true,
7934 + "example": false
7935 + },
7936 + "no_auth": {
7937 + "type": "boolean",
7938 + "description": "When true, this toolkit can be used without authentication",
7939 + "example": false
7940 + },
7941 + "auth_guide_url": {
7942 + "type": "string",
7943 + "nullable": true,
7944 + "description": "URL to a guide page with authentication setup instructions for this toolkit",
7945 + "example": "https://composio.dev/auth/github"
7946 + },
7947 + "deprecated": {
7948 + "$ref": "#/components/schemas/DeprecatedToolkitInfo"
7949 + },
7950 + "meta": {
7951 + "type": "object",
7952 + "properties": {
7953 + "created_at": {
7954 + "type": "string",
7955 + "description": "Creation date and time of the toolkit",
7956 + "example": "2023-01-15T09:30:00.000Z"
7957 + },
7958 + "updated_at": {
7959 + "type": "string",
7960 + "description": "Last modification date and time of the toolkit",
7961 + "example": "2023-05-20T14:45:00.000Z"
7962 + },
7963 + "description": {
7964 + "type": "string",
7965 + "description": "Human-readable description explaining the toolkit's purpose and functionality",
7966 + "example": "Integrate with GitHub repositories, issues, pull requests, and more."
7967 + },
7968 + "logo": {
7969 + "type": "string",
7970 + "description": "Image URL for the toolkit's branding",
7971 + "example": "https://assets.composio.dev/logos/github.png"
7972 + },
7973 + "app_url": {
7974 + "type": "string",
7975 + "nullable": true,
7976 + "description": "Link to the toolkit's main application or service website",
7977 + "example": "https://github.com"
7978 + },
7979 + "categories": {
7980 + "type": "array",
7981 + "items": {
7982 + "type": "object",
7983 + "properties": {
7984 + "id": {
7985 + "type": "string",
7986 + "description": "Category identifier",
7987 + "example": "developer-tools"
7988 + },
7989 + "name": {
7990 + "type": "string",
7991 + "description": "Human-readable category name",
7992 + "example": "Developer Tools"
7993 + }
7994 + },
7995 + "required": [
7996 + "id",
7997 + "name"
7998 + ]
7999 + },
8000 + "description": "List of categories associated with this toolkit",
8001 + "example": [
8002 + {
8003 + "id": "developer-tools",
8004 + "name": "Developer Tools"
8005 + },
8006 + {
8007 + "id": "productivity",
8008 + "name": "Productivity"
8009 + }
8010 + ]
8011 + },
8012 + "triggers_count": {
8013 + "type": "number",
8014 + "description": "Count of available triggers in this toolkit",
8015 + "example": 5
8016 + },
8017 + "tools_count": {
8018 + "type": "number",
8019 + "description": "Count of available tools in this toolkit",
8020 + "example": 12
8021 + },
8022 + "version": {
8023 + "type": "string",
8024 + "description": "Version of the toolkit",
8025 + "example": "20250905_00"
8026 + }
8027 + },
8028 + "required": [
8029 + "created_at",
8030 + "updated_at",
8031 + "description",
8032 + "logo",
8033 + "categories",
8034 + "triggers_count",
8035 + "tools_count",
8036 + "version"
8037 + ],
8038 + "description": "Additional metadata about the toolkit"
8039 + }
8040 + },
8041 + "required": [
8042 + "slug",
8043 + "name",
8044 + "is_local_toolkit",
8045 + "deprecated",
8046 + "meta"
8047 + ],
8048 + "description": "Detailed information about a toolkit"
8049 + }
8050 + },
8051 + "next_cursor": {
8052 + "type": "string",
8053 + "nullable": true
8054 + },
8055 + "total_pages": {
8056 + "type": "number"
8057 + },
8058 + "current_page": {
8059 + "type": "number"
8060 + },
8061 + "total_items": {
8062 + "type": "number"
8063 + }
8064 + },
8065 + "required": [
8066 + "items",
8067 + "total_pages",
8068 + "current_page",
8069 + "total_items"
8070 + ]
8071 + }
8072 + }
8073 + }
8074 + },
8075 + "400": {
8076 + "description": "Bad request. The query parameters may be invalid or in an incorrect format.",
8077 + "content": {
8078 + "application/json": {
8079 + "schema": {
8080 + "$ref": "#/components/schemas/Error"
8081 + }
8082 + }
8083 + }
8084 + },
8085 + "401": {
8086 + "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",
8087 + "content": {
8088 + "application/json": {
8089 + "schema": {
8090 + "$ref": "#/components/schemas/Error"
8091 + }
8092 + }
8093 + }
8094 + },
8095 + "404": {
8096 + "description": "Not found. The toolkits you are looking for do not exist.",
8097 + "content": {
8098 + "application/json": {
8099 + "schema": {
8100 + "$ref": "#/components/schemas/Error"
8101 + }
8102 + }
8103 + }
8104 + },
8105 + "500": {
8106 + "description": "Internal server error. An unexpected error occurred while processing the request.",
8107 + "content": {
8108 + "application/json": {
8109 + "schema": {
8110 + "$ref": "#/components/schemas/Error"
8111 + }
8112 + }
8113 + }
8114 + }
8115 + },
8116 + "x-api-version": "3.0"
8117 + }
8118 + },
8119 + "/api/v3/toolkits/categories": {
8120 + "get": {
8121 + "summary": "List toolkit categories",
8122 + "description": "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.",
8123 + "tags": [
8124 + "Toolkits"
8125 + ],
8126 + "operationId": "getToolkitsCategories",
8127 + "security": [
8128 + {
8129 + "ApiKeyAuth": []
8130 + },
8131 + {
8132 + "UserApiKeyAuth": []
8133 + }
8134 + ],
8135 + "responses": {
8136 + "200": {
8137 + "description": "Successfully retrieved a paginated list of all available toolkit categories with their identifiers and display names.",
8138 + "content": {
8139 + "application/json": {
8140 + "schema": {
8141 + "type": "object",
8142 + "properties": {
8143 + "items": {
8144 + "type": "array",
8145 + "items": {
8146 + "type": "object",
8147 + "properties": {
8148 + "name": {
8149 + "type": "string",
8150 + "description": "Display name of the toolkit category",
8151 + "example": "Developer Tools"
8152 + },
8153 + "id": {
8154 + "type": "string",
8155 + "description": "URL-friendly unique identifier for the category, used for filtering toolkits",
8156 + "example": "developer-tools"
8157 + }
8158 + },
8159 + "required": [
8160 + "name",
8161 + "id"
8162 + ],
8163 + "description": "Information about a single toolkit category"
8164 + }
8165 + },
8166 + "next_cursor": {
8167 + "type": "string",
8168 + "nullable": true
8169 + },
8170 + "total_pages": {
8171 + "type": "number"
8172 + },
8173 + "current_page": {
8174 + "type": "number"
8175 + },
8176 + "total_items": {
8177 + "type": "number"
8178 + }
8179 + },
8180 + "required": [
8181 + "items",
8182 + "total_pages",
8183 + "current_page",
8184 + "total_items"
8185 + ]
8186 + }
8187 + }
8188 + }
8189 + },
8190 + "400": {
8191 + "description": "Bad request. The request may be invalid or in an incorrect format.",
8192 + "content": {
8193 + "application/json": {
8194 + "schema": {
8195 + "$ref": "#/components/schemas/Error"
8196 + }
8197 + }
8198 + }
8199 + },
8200 + "401": {
8201 + "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",
8202 + "content": {
8203 + "application/json": {
8204 + "schema": {
8205 + "$ref": "#/components/schemas/Error"
8206 + }
8207 + }
8208 + }
8209 + },
8210 + "404": {
8211 + "description": "Not found. The requested resource was not found.",
8212 + "content": {
8213 + "application/json": {
8214 + "schema": {
8215 + "$ref": "#/components/schemas/Error"
8216 + }
8217 + }
8218 + }
8219 + },
8220 + "500": {
8221 + "description": "Internal server error. An unexpected error occurred while processing the request.",
8222 + "content": {
8223 + "application/json": {
8224 + "schema": {
8225 + "$ref": "#/components/schemas/Error"
8226 + }
8227 + }
8228 + }
8229 + }
8230 + },
8231 + "x-api-version": "3.0"
8232 + }
8233 + },
8234 + "/api/v3/toolkits/{slug}": {
8235 + "get": {
8236 + "summary": "Get toolkit by slug",
8237 + "description": "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.",
8238 + "tags": [
8239 + "Toolkits"
8240 + ],
8241 + "operationId": "getToolkitsBySlug",
8242 + "security": [
8243 + {
8244 + "ApiKeyAuth": []
8245 + },
8246 + {
8247 + "UserApiKeyAuth": []
8248 + }
8249 + ],
8250 + "parameters": [
8251 + {
8252 + "schema": {
8253 + "type": "string",
8254 + "description": "The unique slug identifier of the toolkit to retrieve",
8255 + "example": "github"
8256 + },
8257 + "required": true,
8258 + "description": "Toolkit slug identifier",
8259 + "name": "slug",
8260 + "in": "path"
8261 + },
8262 + {
8263 + "schema": {
8264 + "type": "string",
8265 + "default": "latest",
8266 + "description": "Version of the toolkit",
8267 + "example": "20250905_00"
8268 + },
8269 + "required": false,
8270 + "description": "Version of the toolkit",
8271 + "name": "version",
8272 + "in": "query"
8273 + }
8274 + ],
8275 + "responses": {
8276 + "200": {
8277 + "description": "Successfully retrieved detailed information about the requested toolkit, including authentication options, metadata, and feature counts.",
8278 + "content": {
8279 + "application/json": {
8280 + "schema": {
8281 + "type": "object",
8282 + "properties": {
8283 + "slug": {
8284 + "type": "string",
8285 + "description": "URL-friendly unique identifier for the toolkit",
8286 + "example": "github"
8287 + },
8288 + "name": {
8289 + "type": "string",
8290 + "description": "Human-readable name of the toolkit",
8291 + "example": "GitHub"
8292 + },
8293 + "enabled": {
8294 + "type": "boolean",
8295 + "description": "Indicates if this toolkit is currently enabled and available for use",
8296 + "example": true
8297 + },
8298 + "composio_managed_auth_schemes": {
8299 + "type": "array",
8300 + "items": {
8301 + "type": "string"
8302 + },
8303 + "description": "List of authentication methods that Composio manages for this toolkit",
8304 + "example": [
8305 + "oauth2"
8306 + ]
8307 + },
8308 + "is_local_toolkit": {
8309 + "type": "boolean",
8310 + "description": "DEPRECATED: This field is no longer meaningful and will always return false. It was previously used to indicate if a toolkit is specific to the current project.",
8311 + "deprecated": true,
8312 + "example": false
8313 + },
8314 + "auth_config_details": {
8315 + "type": "array",
8316 + "items": {
8317 + "type": "object",
8318 + "properties": {
8319 + "mode": {
8320 + "type": "string",
8321 + "description": "The type of authentication mode (e.g., oauth2, basic_auth, api_key)",
8322 + "example": "oauth2"
8323 + },
8324 + "fields": {
8325 + "type": "object",
8326 + "properties": {
8327 + "auth_config_creation": {
8328 + "type": "object",
8329 + "properties": {
8330 + "required": {
8331 + "type": "array",
8332 + "items": {
8333 + "type": "object",
8334 + "properties": {
8335 + "name": {
8336 + "type": "string"
8337 + },
8338 "displayName": {
8339 "type": "string"
8340 },
@@ -14499,7 +15248,7 @@
15248 "Jira Attachment": {
15249 "value": {
15250 "toolkit_slug": "jira",
14502 - "tool_slug": "JIRA_ADD_ATTACHMENT",
15251 + "tool_slug": "JIRA_ADD_ATTACHMENT_TO_ISSUE",
15252 "filename": "error_logs.txt",
15253 "mimetype": "text/plain",
15254 "md5": "e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
@@ -14523,15 +15272,15 @@
15272 },
15273 "key": {
15274 "type": "string",
14526 - "description": "Object storage upload location. Example: \"projects/prj_xyz789/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx\""
15275 + "description": "Object storage upload location. Example: \"projects/pr_1a2b3c4d5e6f/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx\""
15276 },
15277 "new_presigned_url": {
15278 "type": "string",
14530 - "description": "Presigned URL for upload. Example: \"https://storage.composio.dev/projects/prj_xyz789/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600...\""
15279 + "description": "Presigned URL for upload. Example: \"https://storage.composio.dev/projects/pr_1a2b3c4d5e6f/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600...\""
15280 },
15281 "newPresignedUrl": {
15282 "type": "string",
14534 - "description": "[DEPRECATED] Use new_presigned_url instead. Presigned URL for upload. Example: \"https://storage.composio.dev/projects/prj_xyz789/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600...\"",
15283 + "description": "[DEPRECATED] Use new_presigned_url instead. Presigned URL for upload. Example: \"https://storage.composio.dev/projects/pr_1a2b3c4d5e6f/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600...\"",
15284 "deprecated": true
15285 },
15286 "type": {
@@ -14814,227 +15563,762 @@
15563 "description": "The identifier of the user who is initiating the session, ideally a unique identifier from your database like a user ID or email address",
15564 "example": "user_123456789"
15565 },
14817 - "toolkits": {
15566 + "toolkits": {
15567 + "anyOf": [
15568 + {
15569 + "type": "object",
15570 + "properties": {
15571 + "enable": {
15572 + "type": "array",
15573 + "items": {
15574 + "type": "string"
15575 + },
15576 + "description": "Only these specific toolkits will be enabled",
15577 + "example": [
15578 + "gmail",
15579 + "slack",
15580 + "github"
15581 + ]
15582 + }
15583 + },
15584 + "required": [
15585 + "enable"
15586 + ],
15587 + "additionalProperties": false,
15588 + "description": "Enable only specific toolkits (allowlist)"
15589 + },
15590 + {
15591 + "type": "object",
15592 + "properties": {
15593 + "disable": {
15594 + "type": "array",
15595 + "items": {
15596 + "type": "string"
15597 + },
15598 + "description": "These specific toolkits will be disabled",
15599 + "example": [
15600 + "gmail",
15601 + "slack"
15602 + ]
15603 + }
15604 + },
15605 + "required": [
15606 + "disable"
15607 + ],
15608 + "additionalProperties": false,
15609 + "description": "Disable specific toolkits (denylist)"
15610 + }
15611 + ],
15612 + "description": "Toolkit configuration - specify either enable toolkits (allowlist) or disable toolkits (denylist). Mutually exclusive."
15613 + },
15614 + "auth_configs": {
15615 + "type": "object",
15616 + "additionalProperties": {
15617 + "type": "string",
15618 + "format": "authConfigId"
15619 + },
15620 + "description": "The auth configs to use for the session. This will override the default behavior and use the given auth config when specific toolkits are being executed",
15621 + "example": {
15622 + "gmail": "ac_1a2b3c4d5e6f",
15623 + "slack": "ac_7g8h9i0j1k2l"
15624 + }
15625 + },
15626 + "connected_accounts": {
15627 + "type": "object",
15628 + "description": "Per-toolkit connected account override (single nano-ID). Each connected account must exist (not deleted or disabled) and belong to the same `user_id` as the session.",
15629 + "additionalProperties": {
15630 + "type": "string",
15631 + "example": "ca_3m4n5o6p7q8r"
15632 + },
15633 + "example": {
15634 + "github": "ca_3m4n5o6p7q8r"
15635 + }
15636 + },
15637 + "manage_connections": {
15638 + "type": "object",
15639 + "properties": {
15640 + "enable": {
15641 + "type": "boolean",
15642 + "nullable": true,
15643 + "default": true,
15644 + "description": "Whether to enable the connection manager for automatic connection handling. If true, we will provide a tool your agent can use to initiate connections to toolkits if it doesnt exist. If set to false, then you have to manage connections manually.",
15645 + "example": true
15646 + },
15647 + "callback_url": {
15648 + "type": "string",
15649 + "format": "uri",
15650 + "description": "The URL to redirect to after a user completes authentication for a connected account. This allows you to handle the auth callback in your own application.",
15651 + "example": "https://your-app.com/auth/callback"
15652 + },
15653 + "enable_wait_for_connections": {
15654 + "type": "boolean",
15655 + "nullable": true,
15656 + "default": false,
15657 + "description": "When true, the COMPOSIO_WAIT_FOR_CONNECTIONS tool is available for agents to poll connection status after sharing auth URLs. Default is false (disabled). May not work reliably with GPT models.",
15658 + "example": false
15659 + },
15660 + "enable_connection_removal": {
15661 + "type": "boolean",
15662 + "nullable": true,
15663 + "default": true,
15664 + "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS to allow deleting connected accounts. Default true."
15665 + }
15666 + },
15667 + "default": {
15668 + "enable": true,
15669 + "enable_wait_for_connections": false,
15670 + "enable_connection_removal": true
15671 + },
15672 + "additionalProperties": false,
15673 + "description": "Configuration for connection management settings"
15674 + },
15675 + "tools": {
15676 + "type": "object",
15677 + "additionalProperties": {
15678 + "anyOf": [
15679 + {
15680 + "type": "object",
15681 + "properties": {
15682 + "enable": {
15683 + "type": "array",
15684 + "items": {
15685 + "type": "string"
15686 + },
15687 + "description": "Only these specific tools will be available for this toolkit",
15688 + "example": [
15689 + "GMAIL_SEND_EMAIL",
15690 + "GMAIL_FETCH_EMAILS"
15691 + ]
15692 + }
15693 + },
15694 + "required": [
15695 + "enable"
15696 + ],
15697 + "additionalProperties": false
15698 + },
15699 + {
15700 + "type": "object",
15701 + "properties": {
15702 + "disable": {
15703 + "type": "array",
15704 + "items": {
15705 + "type": "string"
15706 + },
15707 + "description": "These specific tools will be disabled for this toolkit",
15708 + "example": [
15709 + "SLACK_ADD_EMOJI"
15710 + ]
15711 + }
15712 + },
15713 + "required": [
15714 + "disable"
15715 + ],
15716 + "additionalProperties": false
15717 + },
15718 + {
15719 + "type": "object",
15720 + "properties": {
15721 + "tags": {
15722 + "anyOf": [
15723 + {
15724 + "type": "array",
15725 + "items": {
15726 + "type": "string",
15727 + "enum": [
15728 + "readOnlyHint",
15729 + "destructiveHint",
15730 + "idempotentHint",
15731 + "openWorldHint"
15732 + ]
15733 + }
15734 + },
15735 + {
15736 + "type": "object",
15737 + "properties": {
15738 + "enable": {
15739 + "type": "array",
15740 + "items": {
15741 + "type": "string",
15742 + "enum": [
15743 + "readOnlyHint",
15744 + "destructiveHint",
15745 + "idempotentHint",
15746 + "openWorldHint"
15747 + ]
15748 + }
15749 + },
15750 + "disable": {
15751 + "type": "array",
15752 + "items": {
15753 + "type": "string",
15754 + "enum": [
15755 + "readOnlyHint",
15756 + "destructiveHint",
15757 + "idempotentHint",
15758 + "openWorldHint"
15759 + ]
15760 + }
15761 + }
15762 + }
15763 + }
15764 + ],
15765 + "description": "MCP tags to filter tools. Array format is treated as enabled list. Object format supports both enabled and disabled lists.",
15766 + "example": {
15767 + "enable": [
15768 + "openWorldHint"
15769 + ],
15770 + "disable": [
15771 + "destructiveHint"
15772 + ]
15773 + }
15774 + }
15775 + },
15776 + "required": [
15777 + "tags"
15778 + ],
15779 + "additionalProperties": false
15780 + }
15781 + ]
15782 + },
15783 + "description": "Tool-level configuration per toolkit. Allows you to enable, disable, or filter by tags for specific tools within each toolkit. Every slug passed in `enable` / `disable` must be a valid Composio tool slug for that toolkit — invalid or typo'd slugs fail session creation with a clear error listing which ones didn't match.",
15784 + "example": {
15785 + "gmail": {
15786 + "enable": [
15787 + "GMAIL_SEND_EMAIL",
15788 + "GMAIL_FETCH_EMAILS"
15789 + ]
15790 + },
15791 + "slack": {
15792 + "disable": [
15793 + "SLACK_ADD_EMOJI"
15794 + ]
15795 + },
15796 + "slackbot": {
15797 + "tags": {
15798 + "enable": [
15799 + "destructiveHint"
15800 + ],
15801 + "disable": [
15802 + "openWorldHint"
15803 + ]
15804 + }
15805 + }
15806 + }
15807 + },
15808 + "tags": {
15809 "anyOf": [
15810 + {
15811 + "type": "array",
15812 + "items": {
15813 + "type": "string",
15814 + "enum": [
15815 + "readOnlyHint",
15816 + "destructiveHint",
15817 + "idempotentHint",
15818 + "openWorldHint"
15819 + ]
15820 + }
15821 + },
15822 {
15823 "type": "object",
15824 "properties": {
15825 "enable": {
15826 "type": "array",
15827 "items": {
14825 - "type": "string"
15828 + "type": "string",
15829 + "enum": [
15830 + "readOnlyHint",
15831 + "destructiveHint",
15832 + "idempotentHint",
15833 + "openWorldHint"
15834 + ]
15835 + }
15836 + },
15837 + "disable": {
15838 + "type": "array",
15839 + "items": {
15840 + "type": "string",
15841 + "enum": [
15842 + "readOnlyHint",
15843 + "destructiveHint",
15844 + "idempotentHint",
15845 + "openWorldHint"
15846 + ]
15847 + }
15848 + }
15849 + }
15850 + }
15851 + ],
15852 + "description": "Global MCP tool annotation hints for filtering. Array format is treated as enabled list. Object format supports both enabled (tool must have at least one) and disabled (tool must NOT have any) lists. Toolkit-level tags override this. Toolkit enabled/disabled lists take precedence over tag filtering.",
15853 + "example": {
15854 + "enable": [
15855 + "openWorldHint"
15856 + ],
15857 + "disable": [
15858 + "destructiveHint"
15859 + ]
15860 + }
15861 + },
15862 + "workbench": {
15863 + "type": "object",
15864 + "properties": {
15865 + "enable": {
15866 + "type": "boolean",
15867 + "default": true,
15868 + "description": "Set to false to disable the workbench entirely. When disabled, no code execution tools are available in the session.",
15869 + "example": true
15870 + },
15871 + "enable_proxy_execution": {
15872 + "type": "boolean",
15873 + "default": true,
15874 + "description": "Whether proxy execution is enabled. When enabled, workbench can call URLs and APIs directly.",
15875 + "example": true
15876 + },
15877 + "auto_offload_threshold": {
15878 + "type": "number",
15879 + "minimum": 0,
15880 + "exclusiveMinimum": true,
15881 + "description": "Character threshold for automatic offloading. When workbench response exceeds this threshold, it will be automatically offloaded. Default is picked automatically based on the response size.",
15882 + "example": 20000
15883 + },
15884 + "sandbox_size": {
15885 + "type": "string",
15886 + "enum": [
15887 + "standard",
15888 + "medium",
15889 + "large",
15890 + "xlarge"
15891 + ],
15892 + "default": "standard",
15893 + "description": "Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4 vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard.",
15894 + "example": "standard"
15895 + }
15896 + },
15897 + "default": {
15898 + "enable": true,
15899 + "enable_proxy_execution": true
15900 + },
15901 + "additionalProperties": false,
15902 + "description": "Configuration for workbench behavior"
15903 + },
15904 + "multi_account": {
15905 + "type": "object",
15906 + "properties": {
15907 + "enable": {
15908 + "type": "boolean",
15909 + "description": "When true, enables multi-account mode for this session. When not set, falls back to org/project-level configuration.",
15910 + "example": true
15911 + },
15912 + "max_accounts_per_toolkit": {
15913 + "type": "integer",
15914 + "minimum": 2,
15915 + "maximum": 10,
15916 + "description": "Maximum number of connected accounts allowed per toolkit. Must be between 2 and 10.",
15917 + "example": 5
15918 + },
15919 + "require_explicit_selection": {
15920 + "type": "boolean",
15921 + "description": "When true, the agent must explicitly select which account to use. When false (default), the first/default account is used automatically.",
15922 + "example": false
15923 + }
15924 + },
15925 + "additionalProperties": false,
15926 + "description": "Configure multi-account behavior. When enabled, users can connect multiple accounts per toolkit."
15927 + },
15928 + "experimental": {
15929 + "type": "object",
15930 + "properties": {
15931 + "assistive_prompt_config": {
15932 + "type": "object",
15933 + "properties": {
15934 + "user_timezone": {
15935 + "type": "string",
15936 + "description": "IANA timezone identifier (e.g., 'America/New_York', 'Europe/London'). Used to customize the system prompt with timezone-aware instructions.",
15937 + "example": "America/New_York"
15938 + }
15939 + },
15940 + "additionalProperties": false,
15941 + "description": "Customize assistive prompt generation (e.g., timezone)."
15942 + },
15943 + "custom_toolkits": {
15944 + "type": "array",
15945 + "items": {
15946 + "type": "object",
15947 + "properties": {
15948 + "slug": {
15949 + "type": "string",
15950 + "minLength": 1,
15951 + "pattern": "^[a-zA-Z0-9_-]+$",
15952 + "description": "Unique slug for the toolkit. Must not conflict with existing Composio toolkit slugs. Alphanumeric, underscores, and hyphens only.",
15953 + "example": "ecommerce"
15954 + },
15955 + "name": {
15956 + "type": "string",
15957 + "minLength": 1,
15958 + "maxLength": 128,
15959 + "description": "Display name shown to the LLM and in search results.",
15960 + "example": "E-Commerce API"
15961 + },
15962 + "description": {
15963 + "type": "string",
15964 + "minLength": 1,
15965 + "maxLength": 2048,
15966 + "description": "Used for BM25 search matching and shown in toolkit connection statuses.",
15967 + "example": "Internal e-commerce API for order management and fulfillment"
15968 + },
15969 + "preload": {
15970 + "type": "boolean",
15971 + "description": "SDK hint for direct custom-tool exposure. Not stored in session config; echoed in create/attach responses for inline custom definitions."
15972 + },
15973 + "tools": {
15974 + "type": "array",
15975 + "items": {
15976 + "type": "object",
15977 + "properties": {
15978 + "slug": {
15979 + "type": "string",
15980 + "minLength": 1,
15981 + "pattern": "^[a-zA-Z0-9_-]+$",
15982 + "description": "Tool slug. Combined with toolkit slug to form LOCAL_<TOOLKIT>_<TOOL> (max 60 chars total).",
15983 + "example": "GET_CUSTOMER_ORDERS"
15984 + },
15985 + "name": {
15986 + "type": "string",
15987 + "minLength": 1,
15988 + "maxLength": 128,
15989 + "description": "Human-readable display name",
15990 + "example": "Get Customer Orders"
15991 + },
15992 + "description": {
15993 + "type": "string",
15994 + "minLength": 1,
15995 + "maxLength": 5120,
15996 + "description": "Used for BM25 search matching and shown to the LLM.",
15997 + "example": "Fetch recent orders for a customer by their email address"
15998 + },
15999 + "input_schema": {
16000 + "type": "object",
16001 + "additionalProperties": {},
16002 + "description": "Must have type: \"object\" and a properties field.",
16003 + "example": {
16004 + "type": "object",
16005 + "properties": {
16006 + "email": {
16007 + "type": "string",
16008 + "description": "Customer email"
16009 + }
16010 + },
16011 + "required": [
16012 + "email"
16013 + ]
16014 + }
16015 + },
16016 + "output_schema": {
16017 + "type": "object",
16018 + "additionalProperties": {},
16019 + "description": "Optional output schema for the tool response."
16020 + },
16021 + "preload": {
16022 + "type": "boolean",
16023 + "description": "SDK hint for direct custom-tool exposure. Not stored in session config; echoed in create/attach responses for inline custom definitions."
16024 + }
16025 + },
16026 + "required": [
16027 + "slug",
16028 + "name",
16029 + "description",
16030 + "input_schema"
16031 + ]
16032 + },
16033 + "minItems": 1,
16034 + "maxItems": 100,
16035 + "description": "Tools in this custom toolkit"
16036 + }
16037 + },
16038 + "required": [
16039 + "slug",
16040 + "name",
16041 + "description",
16042 + "tools"
16043 + ]
16044 + },
16045 + "description": "Custom toolkits with grouped tools. Toolkit slugs must not conflict with existing Composio toolkits. All tools are no-auth."
16046 + },
16047 + "custom_tools": {
16048 + "type": "array",
16049 + "items": {
16050 + "type": "object",
16051 + "properties": {
16052 + "slug": {
16053 + "type": "string",
16054 + "minLength": 1,
16055 + "pattern": "^[a-zA-Z0-9_-]+$",
16056 + "description": "Tool slug. Forms LOCAL_<TOOL> (standalone) or LOCAL_<TOOLKIT>_<TOOL> (extending). Max 60 chars total.",
16057 + "example": "GET_IMPORTANT_EMAILS"
16058 },
14827 - "description": "Only these specific toolkits will be enabled",
14828 - "example": [
14829 - "gmail",
14830 - "slack",
14831 - "github"
14832 - ]
14833 - }
16059 + "name": {
16060 + "type": "string",
16061 + "minLength": 1,
16062 + "maxLength": 128,
16063 + "description": "Human-readable display name",
16064 + "example": "Get Important Emails"
16065 + },
16066 + "description": {
16067 + "type": "string",
16068 + "minLength": 1,
16069 + "maxLength": 5120,
16070 + "description": "Used for BM25 search matching and shown to the LLM.",
16071 + "example": "Fetch emails marked as important from the last 24 hours"
16072 + },
16073 + "input_schema": {
16074 + "type": "object",
16075 + "additionalProperties": {},
16076 + "description": "Must have type: \"object\" and a properties field.",
16077 + "example": {
16078 + "type": "object",
16079 + "properties": {
16080 + "limit": {
16081 + "type": "number",
16082 + "description": "Max results to return"
16083 + }
16084 + }
16085 + }
16086 + },
16087 + "output_schema": {
16088 + "type": "object",
16089 + "additionalProperties": {},
16090 + "description": "JSON Schema describing tool output (optional)"
16091 + },
16092 + "extends_toolkit": {
16093 + "type": "string",
16094 + "minLength": 1,
16095 + "description": "If set, must be a valid Composio toolkit slug. The tool inherits that toolkit's auth/connection status. If omitted, the tool is standalone (no-auth).",
16096 + "example": "gmail"
16097 + },
16098 + "preload": {
16099 + "type": "boolean",
16100 + "description": "SDK hint for direct custom-tool exposure. Not stored in session config; echoed in create/attach responses for inline custom definitions."
16101 + }
16102 + },
16103 + "required": [
16104 + "slug",
16105 + "name",
16106 + "description",
16107 + "input_schema"
16108 + ]
16109 },
14835 - "required": [
14836 - "enable"
14837 - ],
14838 - "additionalProperties": false,
14839 - "description": "Enable only specific toolkits (allowlist)"
16110 + "description": "Custom tools to include in search. Standalone tools need no auth. Tools with extends_toolkit inherit the Composio toolkit's connection."
16111 },
14841 - {
16112 + "permissions": {
16113 "type": "object",
16114 "properties": {
14844 - "disable": {
14845 - "type": "array",
14846 - "items": {
14847 - "type": "string"
16115 + "default": {
16116 + "type": "string",
16117 + "enum": [
16118 + "allow_all",
16119 + "ask_every_call",
16120 + "ask_once_per_session"
16121 + ],
16122 + "description": "Default elicitation behavior when no override matches. `allow_all` runs every tool without prompting; `ask_every_call` prompts on each invocation; `ask_once_per_session` prompts once and remembers the answer for the rest of the session."
16123 + },
16124 + "overrides": {
16125 + "type": "object",
16126 + "additionalProperties": {
16127 + "type": "string",
16128 + "enum": [
16129 + "always_allow",
16130 + "always_deny",
16131 + "ask_once",
16132 + "ask_always"
16133 + ]
16134 },
14849 - "description": "These specific toolkits will be disabled",
14850 - "example": [
14851 - "gmail",
14852 - "slack"
14853 - ]
16135 + "description": "Per-tool overrides keyed by `${toolSlug}:${connectedAccountId ?? \"__none__\"}`, plus account-wide overrides keyed by `*:${connectedAccountId ?? \"__none__\"}`. Exact tool overrides take precedence over account-wide overrides. `always_allow` skips the prompt and runs the tool; `always_deny` blocks the tool; `ask_once` prompts once per session (allow/deny) and remembers; `ask_always` prompts on every call with allow-once/allow-session/deny, ignoring any cached session allow. Overrides take precedence over `default`."
16136 }
16137 },
16138 "required": [
14857 - "disable"
16139 + "default"
16140 ],
14859 - "additionalProperties": false,
14860 - "description": "Disable specific toolkits (denylist)"
16141 + "description": "Per-tool elicitation permission config. Default behavior + per-tool always_allow/always_deny overrides. Mutation via PATCH."
16142 + },
16143 + "link_url_overwrite": {
16144 + "type": "string",
16145 + "format": "uri",
16146 + "description": "Experimental base URL override for connection link redirects created from this tool-router session. When set, link creation returns `${link_url_overwrite}/link/{link_token}` instead of the default Composio Connect base URL. Use only when your integration needs links to open through a custom Connect host.",
16147 + "x-experimental": true
16148 }
14862 - ],
14863 - "description": "Toolkit configuration - specify either enable toolkits (allowlist) or disable toolkits (denylist). Mutually exclusive."
16149 + },
16150 + "description": "Experimental features - not stable, may be modified or removed in future versions.",
16151 + "x-experimental": true
16152 },
14865 - "auth_configs": {
16153 + "preload": {
16154 "type": "object",
14867 - "additionalProperties": {
14868 - "type": "string",
14869 - "format": "authConfigId"
16155 + "properties": {
16156 + "tools": {
16157 + "type": "array",
16158 + "items": {
16159 + "type": "string"
16160 + },
16161 + "description": "Composio tool slugs to preload. Each slug must be allowed by the session filters (`toolkits`, `tools`, `tags`) — unknown, blocked, meta, or custom slugs return a 400 at session creation.",
16162 + "example": [
16163 + "GMAIL_FETCH_EMAILS",
16164 + "SLACK_SEND_MESSAGE"
16165 + ]
16166 + }
16167 + },
16168 + "additionalProperties": false,
16169 + "description": "Preload configuration for Composio tools. Controls which tools appear in `session.tools` and the MCP server tool list so the agent can call them directly without going through search first. Custom tools use `preload` on the custom tool/toolkit definition instead. Not supported when multi-account is enabled. Each preloaded tool adds to the agent context window, so keep the list at or under ~20 tools."
16170 + }
16171 + },
16172 + "required": [
16173 + "user_id"
16174 + ]
16175 + },
16176 + "examples": {
16177 + "Session with all toolkits": {
16178 + "value": {
16179 + "user_id": "user_123456789"
16180 + }
16181 + },
16182 + "Session with only specific toolkits": {
16183 + "value": {
16184 + "user_id": "user_123456789",
16185 + "toolkits": {
16186 + "enable": [
16187 + "gmail",
16188 + "slack"
16189 + ]
16190 + }
16191 + }
16192 + },
16193 + "Session with only specific toolkits disabled": {
16194 + "value": {
16195 + "user_id": "user_123456789",
16196 + "toolkits": {
16197 + "disable": [
16198 + "gmail",
16199 + "slack"
16200 + ]
16201 + }
16202 + }
16203 + },
16204 + "Session with connection manager enabled": {
16205 + "value": {
16206 + "user_id": "user_123456789",
16207 + "manage_connections": {
16208 + "enable": true
16209 + }
16210 + }
16211 + },
16212 + "Session with connection manager and specific toolkits": {
16213 + "value": {
16214 + "user_id": "user_123456789",
16215 + "toolkits": {
16216 + "enable": [
16217 + "gmail",
16218 + "slack"
16219 + ]
16220 + },
16221 + "manage_connections": {
16222 + "enable": true
16223 + }
16224 + }
16225 + },
16226 + "Session with custom callback URL": {
16227 + "value": {
16228 + "user_id": "user_123456789",
16229 + "toolkits": {
16230 + "enable": [
16231 + "github",
16232 + "slack"
16233 + ]
16234 + },
16235 + "manage_connections": {
16236 + "enable": true,
16237 + "callback_url": "https://your-app.com/auth/callback"
16238 + }
16239 + }
16240 + },
16241 + "Session with workbench configuration": {
16242 + "value": {
16243 + "user_id": "user_123456789",
16244 + "toolkits": {
16245 + "enable": [
16246 + "gmail"
16247 + ]
16248 + },
16249 + "workbench": {
16250 + "enable_proxy_execution": true,
16251 + "auto_offload_threshold": 10000
16252 + }
16253 + }
16254 + },
16255 + "Session with global tags filter": {
16256 + "value": {
16257 + "user_id": "user_123456789",
16258 + "toolkits": {
16259 + "enable": [
16260 + "gmail",
16261 + "slack"
16262 + ]
16263 + },
16264 + "tags": [
16265 + "readOnlyHint",
16266 + "idempotentHint"
16267 + ]
16268 + }
16269 + },
16270 + "Session with auth config overrides": {
16271 + "value": {
16272 + "user_id": "user_123456789",
16273 + "toolkits": {
16274 + "enable": [
16275 + "gmail",
16276 + "slack"
16277 + ]
16278 },
14871 - "description": "The auth configs to use for the session. This will override the default behavior and use the given auth config when specific toolkits are being executed",
14872 - "example": {
16279 + "auth_configs": {
16280 "gmail": "ac_1a2b3c4d5e6f",
16281 "slack": "ac_7g8h9i0j1k2l"
16282 }
14876 - },
14877 - "connected_accounts": {
14878 - "type": "object",
14879 - "additionalProperties": {
14880 - "type": "string",
14881 - "format": "connectedAccountId"
16283 + }
16284 + },
16285 + "Session with connected account overrides": {
16286 + "value": {
16287 + "user_id": "user_123456789",
16288 + "toolkits": {
16289 + "enable": [
16290 + "gmail",
16291 + "slack"
16292 + ]
16293 },
14883 - "description": "The connected accounts to use for the session. This will override the default behaviour and use the given connected account when specific toolkits are being executed",
14884 - "example": {
14885 - "github": "ca_3m4n5o6p7q8r"
16294 + "connected_accounts": {
16295 + "gmail": "ca_1a2b3c4d5e6f",
16296 + "slack": "ca_7g8h9i0j1k2l"
16297 }
14887 - },
14888 - "manage_connections": {
14889 - "type": "object",
14890 - "properties": {
14891 - "enable": {
14892 - "type": "boolean",
14893 - "nullable": true,
14894 - "default": true,
14895 - "description": "Whether to enable the connection manager for automatic connection handling. If true, we will provide a tool your agent can use to initiate connections to toolkits if it doesnt exist. If set to false, then you have to manage connections manually.",
14896 - "example": true
14897 - },
14898 - "callback_url": {
14899 - "type": "string",
14900 - "format": "uri",
14901 - "description": "The URL to redirect to after a user completes authentication for a connected account. This allows you to handle the auth callback in your own application.",
14902 - "example": "https://your-app.com/auth/callback"
14903 - },
14904 - "enable_wait_for_connections": {
14905 - "type": "boolean",
14906 - "nullable": true,
14907 - "default": false,
14908 - "description": "When true, the COMPOSIO_WAIT_FOR_CONNECTIONS tool is available for agents to poll connection status after sharing auth URLs. Default is false (disabled). May not work reliably with GPT models.",
14909 - "example": false
14910 - },
14911 - "enable_connection_removal": {
14912 - "type": "boolean",
14913 - "nullable": true,
14914 - "default": true,
14915 - "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS to allow deleting connected accounts. Default true."
14916 - }
16298 + }
16299 + },
16300 + "Session with comprehensive configuration": {
16301 + "value": {
16302 + "user_id": "user_123456789",
16303 + "toolkits": {
16304 + "enable": [
16305 + "gmail",
16306 + "slack",
16307 + "github"
16308 + ]
16309 },
14918 - "default": {
14919 - "enable": true,
14920 - "enable_wait_for_connections": false,
14921 - "enable_connection_removal": true
16310 + "auth_configs": {
16311 + "gmail": "ac_1a2b3c4d5e6f",
16312 + "slack": "ac_7g8h9i0j1k2l"
16313 },
14923 - "additionalProperties": false,
14924 - "description": "Configuration for connection management settings"
14925 - },
14926 - "tools": {
14927 - "type": "object",
14928 - "additionalProperties": {
14929 - "anyOf": [
14930 - {
14931 - "type": "object",
14932 - "properties": {
14933 - "enable": {
14934 - "type": "array",
14935 - "items": {
14936 - "type": "string"
14937 - },
14938 - "description": "Only these specific tools will be available for this toolkit",
14939 - "example": [
14940 - "GMAIL_SEND_EMAIL",
14941 - "GMAIL_FETCH_EMAILS"
14942 - ]
14943 - }
14944 - },
14945 - "required": [
14946 - "enable"
14947 - ],
14948 - "additionalProperties": false
14949 - },
14950 - {
14951 - "type": "object",
14952 - "properties": {
14953 - "disable": {
14954 - "type": "array",
14955 - "items": {
14956 - "type": "string"
14957 - },
14958 - "description": "These specific tools will be disabled for this toolkit",
14959 - "example": [
14960 - "SLACK_ADD_EMOJI"
14961 - ]
14962 - }
14963 - },
14964 - "required": [
14965 - "disable"
14966 - ],
14967 - "additionalProperties": false
14968 - },
14969 - {
14970 - "type": "object",
14971 - "properties": {
14972 - "tags": {
14973 - "anyOf": [
14974 - {
14975 - "type": "array",
14976 - "items": {
14977 - "type": "string",
14978 - "enum": [
14979 - "readOnlyHint",
14980 - "destructiveHint",
14981 - "idempotentHint",
14982 - "openWorldHint"
14983 - ]
14984 - }
14985 - },
14986 - {
14987 - "type": "object",
14988 - "properties": {
14989 - "enable": {
14990 - "type": "array",
14991 - "items": {
14992 - "type": "string",
14993 - "enum": [
14994 - "readOnlyHint",
14995 - "destructiveHint",
14996 - "idempotentHint",
14997 - "openWorldHint"
14998 - ]
14999 - },
15000 - "description": "Tags that the tool must have at least one of"
15001 - },
15002 - "disable": {
15003 - "type": "array",
15004 - "items": {
15005 - "type": "string",
15006 - "enum": [
15007 - "readOnlyHint",
15008 - "destructiveHint",
15009 - "idempotentHint",
15010 - "openWorldHint"
15011 - ]
15012 - },
15013 - "description": "Tags that the tool must NOT have any of"
15014 - }
15015 - }
15016 - }
15017 - ],
15018 - "description": "MCP tags to filter tools. Array format is treated as enabled list. Object format supports both enabled and disabled lists.",
15019 - "example": {
15020 - "enable": [
15021 - "openWorldHint"
15022 - ],
15023 - "disable": [
15024 - "destructiveHint"
15025 - ]
15026 - }
15027 - }
15028 - },
15029 - "required": [
15030 - "tags"
15031 - ],
15032 - "additionalProperties": false
15033 - }
15034 - ]
16314 + "connected_accounts": {
16315 + "github": "ca_3m4n5o6p7q8r"
16316 },
15036 - "description": "Tool-level configuration per toolkit - either specify enable tools (whitelist), disable tools (blacklist), or filter by MCP tags for each toolkit",
15037 - "example": {
16317 + "manage_connections": {
16318 + "enable": true,
16319 + "callback_url": "https://your-app.com/auth/callback"
16320 + },
16321 + "tools": {
16322 "gmail": {
16323 "enable": [
16324 "GMAIL_SEND_EMAIL",
@@ -15046,503 +16330,1019 @@
16330 "SLACK_ADD_EMOJI"
16331 ]
16332 },
15049 - "slack_bot": {
15050 - "tags": {
15051 - "enable": [
15052 - "destructiveHint"
15053 - ],
15054 - "disable": [
15055 - "openWorldHint"
15056 - ]
15057 - }
16333 + "slackbot": {
16334 + "tags": [
16335 + "destructiveHint"
16336 + ]
16337 }
16338 + },
16339 + "tags": [
16340 + "destructiveHint",
16341 + "idempotentHint"
16342 + ],
16343 + "workbench": {
16344 + "enable_proxy_execution": true,
16345 + "auto_offload_threshold": 10000
16346 }
15060 - },
15061 - "tags": {
15062 - "anyOf": [
15063 - {
15064 - "type": "array",
15065 - "items": {
16347 + }
16348 + },
16349 + "Session with disabled toolkits and global tags": {
16350 + "value": {
16351 + "user_id": "user_123456789",
16352 + "toolkits": {
16353 + "disable": [
16354 + "gmail"
16355 + ]
16356 + },
16357 + "tags": [
16358 + "readOnlyHint"
16359 + ]
16360 + }
16361 + }
16362 + }
16363 + }
16364 + }
16365 + },
16366 + "responses": {
16367 + "201": {
16368 + "description": "Session successfully created. Returns the session ID and MCP server URL for the created session.",
16369 + "content": {
16370 + "application/json": {
16371 + "schema": {
16372 + "type": "object",
16373 + "properties": {
16374 + "session_id": {
16375 + "type": "string",
16376 + "format": "toolRouterSessionId",
16377 + "description": "The identifier of the session",
16378 + "example": "trs_1a2b3c4d5e6f"
16379 + },
16380 + "mcp": {
16381 + "type": "object",
16382 + "properties": {
16383 + "type": {
16384 "type": "string",
16385 "enum": [
15068 - "readOnlyHint",
15069 - "destructiveHint",
15070 - "idempotentHint",
15071 - "openWorldHint"
15072 - ]
16386 + "http"
16387 + ],
16388 + "description": "The type of the MCP server. Can be http"
16389 + },
16390 + "url": {
16391 + "type": "string",
16392 + "format": "uri",
16393 + "description": "The URL of the MCP server",
16394 + "example": "https://app.composio.dev/tool_router/v3/trs_1a2b3c4d5e6f/mcp"
16395 }
16396 },
15075 - {
15076 - "type": "object",
15077 - "properties": {
15078 - "enable": {
15079 - "type": "array",
15080 - "items": {
15081 - "type": "string",
15082 - "enum": [
15083 - "readOnlyHint",
15084 - "destructiveHint",
15085 - "idempotentHint",
15086 - "openWorldHint"
15087 - ]
16397 + "required": [
16398 + "type",
16399 + "url"
16400 + ]
16401 + },
16402 + "tool_router_tools": {
16403 + "type": "array",
16404 + "items": {
16405 + "type": "string"
16406 + },
16407 + "description": "List of available tools in this session"
16408 + },
16409 + "config": {
16410 + "type": "object",
16411 + "properties": {
16412 + "user_id": {
16413 + "type": "string",
16414 + "description": "User identifier for this session"
16415 + },
16416 + "toolkits": {
16417 + "anyOf": [
16418 + {
16419 + "type": "object",
16420 + "properties": {
16421 + "enabled": {
16422 + "type": "array",
16423 + "items": {
16424 + "type": "string"
16425 + }
16426 + }
16427 + },
16428 + "required": [
16429 + "enabled"
16430 + ],
16431 + "additionalProperties": false
16432 },
15089 - "description": "Tags that the tool must have at least one of"
16433 + {
16434 + "type": "object",
16435 + "properties": {
16436 + "disabled": {
16437 + "type": "array",
16438 + "items": {
16439 + "type": "string"
16440 + }
16441 + }
16442 + },
16443 + "required": [
16444 + "disabled"
16445 + ],
16446 + "additionalProperties": false
16447 + }
16448 + ],
16449 + "description": "Toolkit configuration - either enabled list or disabled list"
16450 + },
16451 + "auth_configs": {
16452 + "type": "object",
16453 + "additionalProperties": {
16454 + "type": "string",
16455 + "format": "authConfigId"
16456 },
15091 - "disable": {
16457 + "description": "Auth config overrides per toolkit"
16458 + },
16459 + "connected_accounts": {
16460 + "type": "object",
16461 + "additionalProperties": {
16462 + "type": "string",
16463 + "format": "connectedAccountId"
16464 + },
16465 + "description": "Per-toolkit connected account override (single nano-ID). Returns the first override when multi-account is enabled; see `all_connected_accounts` for the full list."
16466 + },
16467 + "all_connected_accounts": {
16468 + "type": "object",
16469 + "additionalProperties": {
16470 "type": "array",
16471 "items": {
16472 "type": "string",
15095 - "enum": [
15096 - "readOnlyHint",
15097 - "destructiveHint",
15098 - "idempotentHint",
15099 - "openWorldHint"
15100 - ]
16473 + "format": "connectedAccountId"
16474 },
15102 - "description": "Tags that the tool must NOT have any of"
15103 - }
15104 - }
15105 - }
15106 - ],
15107 - "description": "Global MCP tool annotation hints for filtering. Array format is treated as enabled list. Object format supports both enabled (tool must have at least one) and disabled (tool must NOT have any) lists. Toolkit-level tags override this. Toolkit enabled/disabled lists take precedence over tag filtering.",
15108 - "example": {
15109 - "enable": [
15110 - "openWorldHint"
15111 - ],
15112 - "disable": [
15113 - "destructiveHint"
15114 - ]
15115 - }
15116 - },
15117 - "workbench": {
15118 - "type": "object",
15119 - "properties": {
15120 - "enable": {
15121 - "type": "boolean",
15122 - "default": true,
15123 - "description": "Set to false to disable the workbench entirely. When disabled, no code execution tools are available in the session.",
15124 - "example": true
15125 - },
15126 - "enable_proxy_execution": {
15127 - "type": "boolean",
15128 - "default": true,
15129 - "description": "Whether proxy execution is enabled. When enabled, workbench can call URLs and APIs directly.",
15130 - "example": true
15131 - },
15132 - "auto_offload_threshold": {
15133 - "type": "number",
15134 - "minimum": 0,
15135 - "exclusiveMinimum": true,
15136 - "description": "Character threshold for automatic offloading. When workbench response exceeds this threshold, it will be automatically offloaded. Default is picked automatically based on the response size.",
15137 - "example": 20000
15138 - }
15139 - },
15140 - "default": {
15141 - "enable": true,
15142 - "enable_proxy_execution": true
15143 - },
15144 - "additionalProperties": false,
15145 - "description": "Configuration for workbench behavior"
15146 - },
15147 - "multi_account": {
15148 - "type": "object",
15149 - "properties": {
15150 - "enable": {
15151 - "type": "boolean",
15152 - "description": "When true, enables multi-account mode for this session. When not set, falls back to org/project-level configuration.",
15153 - "example": true
15154 - },
15155 - "max_accounts_per_toolkit": {
15156 - "type": "integer",
15157 - "minimum": 2,
15158 - "maximum": 10,
15159 - "description": "Maximum number of connected accounts allowed per toolkit. Must be between 2 and 10.",
15160 - "example": 5
15161 - },
15162 - "require_explicit_selection": {
15163 - "type": "boolean",
15164 - "description": "When true, the agent must explicitly select which account to use. When false (default), the first/default account is used automatically.",
15165 - "example": false
15166 - }
15167 - },
15168 - "additionalProperties": false,
15169 - "description": "Configure multi-account behavior. When enabled, users can connect multiple accounts per toolkit."
15170 - },
15171 - "experimental": {
15172 - "type": "object",
15173 - "properties": {
15174 - "assistive_prompt_config": {
15175 - "type": "object",
15176 - "properties": {
15177 - "user_timezone": {
15178 - "type": "string",
15179 - "description": "IANA timezone identifier (e.g., 'America/New_York', 'Europe/London'). Used to customize the system prompt with timezone-aware instructions.",
15180 - "example": "America/New_York"
15181 - }
16475 + "minItems": 1
16476 + },
16477 + "description": "Full per-toolkit connected account overrides as arrays. Populated whenever `connected_accounts` is non-empty; carries the complete list when multi-account is enabled."
16478 },
15183 - "additionalProperties": false,
15184 - "description": "Customize assistive prompt generation (e.g., timezone)."
15185 - },
15186 - "custom_toolkits": {
15187 - "type": "array",
15188 - "items": {
16479 + "manage_connections": {
16480 "type": "object",
16481 "properties": {
15191 - "slug": {
15192 - "type": "string",
15193 - "minLength": 1,
15194 - "pattern": "^[a-zA-Z0-9_-]+$",
15195 - "description": "Unique slug for the toolkit. Must not conflict with existing Composio toolkit slugs. Alphanumeric, underscores, and hyphens only.",
15196 - "example": "ecommerce"
16482 + "enabled": {
16483 + "type": "boolean",
16484 + "default": true,
16485 + "description": "Whether to enable the connection manager for automatic connection handling"
16486 },
15198 - "name": {
16487 + "callback_url": {
16488 "type": "string",
15200 - "minLength": 1,
15201 - "maxLength": 128,
15202 - "description": "Display name shown to the LLM and in search results.",
15203 - "example": "E-Commerce API"
16489 + "format": "uri",
16490 + "description": "Custom callback URL for connected account auth flows"
16491 },
15205 - "description": {
15206 - "type": "string",
15207 - "minLength": 1,
15208 - "maxLength": 2048,
15209 - "description": "Used for BM25 search matching and shown in toolkit connection statuses.",
15210 - "example": "Internal e-commerce API for order management and fulfillment"
16492 + "enable_wait_for_connections": {
16493 + "type": "boolean",
16494 + "default": false,
16495 + "description": "Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status. Default false. May not work reliably with GPT models."
16496 },
15212 - "tools": {
15213 - "type": "array",
15214 - "items": {
16497 + "enable_connection_removal": {
16498 + "type": "boolean",
16499 + "default": true,
16500 + "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS. Default true."
16501 + }
16502 + },
16503 + "description": "Manage connections configuration"
16504 + },
16505 + "tools": {
16506 + "type": "object",
16507 + "additionalProperties": {
16508 + "anyOf": [
16509 + {
16510 + "type": "object",
16511 + "properties": {
16512 + "enabled": {
16513 + "type": "array",
16514 + "items": {
16515 + "type": "string"
16516 + }
16517 + }
16518 + },
16519 + "required": [
16520 + "enabled"
16521 + ],
16522 + "additionalProperties": false
16523 + },
16524 + {
16525 + "type": "object",
16526 + "properties": {
16527 + "disabled": {
16528 + "type": "array",
16529 + "items": {
16530 + "type": "string"
16531 + }
16532 + }
16533 + },
16534 + "required": [
16535 + "disabled"
16536 + ],
16537 + "additionalProperties": false
16538 + },
16539 + {
16540 "type": "object",
16541 "properties": {
15217 - "slug": {
15218 - "type": "string",
15219 - "minLength": 1,
15220 - "pattern": "^[a-zA-Z0-9_-]+$",
15221 - "description": "Tool slug. Combined with toolkit slug to form LOCAL_<TOOLKIT>_<TOOL> (max 60 chars total).",
15222 - "example": "GET_CUSTOMER_ORDERS"
15223 - },
15224 - "name": {
15225 - "type": "string",
15226 - "minLength": 1,
15227 - "maxLength": 128,
15228 - "description": "Human-readable display name",
15229 - "example": "Get Customer Orders"
15230 - },
15231 - "description": {
15232 - "type": "string",
15233 - "minLength": 1,
15234 - "maxLength": 5120,
15235 - "description": "Used for BM25 search matching and shown to the LLM.",
15236 - "example": "Fetch recent orders for a customer by their email address"
15237 - },
15238 - "input_schema": {
16542 + "tags": {
16543 "type": "object",
15240 - "additionalProperties": {},
15241 - "description": "Must have type: \"object\" and a properties field.",
15242 - "example": {
15243 - "type": "object",
15244 - "properties": {
15245 - "email": {
16544 + "properties": {
16545 + "enabled": {
16546 + "type": "array",
16547 + "items": {
16548 "type": "string",
15247 - "description": "Customer email"
15248 - }
16549 + "enum": [
16550 + "readOnlyHint",
16551 + "destructiveHint",
16552 + "idempotentHint",
16553 + "openWorldHint"
16554 + ]
16555 + },
16556 + "description": "Tags that the tool must have at least one of"
16557 },
15250 - "required": [
15251 - "email"
15252 - ]
16558 + "disabled": {
16559 + "type": "array",
16560 + "items": {
16561 + "type": "string",
16562 + "enum": [
16563 + "readOnlyHint",
16564 + "destructiveHint",
16565 + "idempotentHint",
16566 + "openWorldHint"
16567 + ]
16568 + },
16569 + "description": "Tags that the tool must NOT have any of"
16570 + }
16571 }
15254 - },
15255 - "output_schema": {
15256 - "type": "object",
15257 - "additionalProperties": {},
15258 - "description": "Optional output schema for the tool response."
16572 }
16573 },
16574 "required": [
15262 - "slug",
15263 - "name",
15264 - "description",
15265 - "input_schema"
16575 + "tags"
16576 + ],
16577 + "additionalProperties": false
16578 + }
16579 + ]
16580 + },
16581 + "description": "Tool-level configuration per toolkit"
16582 + },
16583 + "tags": {
16584 + "type": "object",
16585 + "properties": {
16586 + "enabled": {
16587 + "type": "array",
16588 + "items": {
16589 + "type": "string",
16590 + "enum": [
16591 + "readOnlyHint",
16592 + "destructiveHint",
16593 + "idempotentHint",
16594 + "openWorldHint"
16595 ]
16596 },
15268 - "minItems": 1,
15269 - "maxItems": 100,
15270 - "description": "Tools in this custom toolkit"
16597 + "description": "Tags that the tool must have at least one of"
16598 + },
16599 + "disabled": {
16600 + "type": "array",
16601 + "items": {
16602 + "type": "string",
16603 + "enum": [
16604 + "readOnlyHint",
16605 + "destructiveHint",
16606 + "idempotentHint",
16607 + "openWorldHint"
16608 + ]
16609 + },
16610 + "description": "Tags that the tool must NOT have any of"
16611 }
16612 },
15273 - "required": [
15274 - "slug",
15275 - "name",
15276 - "description",
15277 - "tools"
15278 - ]
16613 + "description": "MCP tool annotation hints for filtering tools with enabled/disabled support. enabled: tags that the tool must have at least one of. disabled: tags that the tool must NOT have any of. Both conditions must be satisfied."
16614 },
15280 - "description": "Custom toolkits with grouped tools. Toolkit slugs must not conflict with existing Composio toolkits. All tools are no-auth."
15281 - },
15282 - "custom_tools": {
15283 - "type": "array",
15284 - "items": {
16615 + "workbench": {
16616 "type": "object",
16617 "properties": {
15287 - "slug": {
15288 - "type": "string",
15289 - "minLength": 1,
15290 - "pattern": "^[a-zA-Z0-9_-]+$",
15291 - "description": "Tool slug. Forms LOCAL_<TOOL> (standalone) or LOCAL_<TOOLKIT>_<TOOL> (extending). Max 60 chars total.",
15292 - "example": "GET_IMPORTANT_EMAILS"
16618 + "enable": {
16619 + "type": "boolean",
16620 + "description": "Whether the workbench (code execution sandbox) is enabled. When false, COMPOSIO_REMOTE_WORKBENCH and COMPOSIO_REMOTE_BASH_TOOL are not exposed."
16621 },
15294 - "name": {
15295 - "type": "string",
15296 - "minLength": 1,
15297 - "maxLength": 128,
15298 - "description": "Human-readable display name",
15299 - "example": "Get Important Emails"
16622 + "proxy_execution_enabled": {
16623 + "type": "boolean",
16624 + "description": "Whether proxy execution is enabled in the workbench"
16625 },
15301 - "description": {
16626 + "auto_offload_threshold": {
16627 + "type": "number",
16628 + "minimum": 0,
16629 + "exclusiveMinimum": true,
16630 + "description": "Character threshold after which tool execution response are saved to a file in workbench. Default is 20k."
16631 + },
16632 + "sandbox_size": {
16633 "type": "string",
15303 - "minLength": 1,
15304 - "maxLength": 5120,
15305 - "description": "Used for BM25 search matching and shown to the LLM.",
15306 - "example": "Fetch emails marked as important from the last 24 hours"
16634 + "enum": [
16635 + "standard",
16636 + "medium",
16637 + "large",
16638 + "xlarge"
16639 + ],
16640 + "description": "Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4 vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard."
16641 + }
16642 + },
16643 + "default": {
16644 + "enable": true,
16645 + "proxy_execution_enabled": true
16646 + },
16647 + "description": "Workbench configuration"
16648 + },
16649 + "multi_account": {
16650 + "type": "object",
16651 + "properties": {
16652 + "enable": {
16653 + "type": "boolean",
16654 + "description": "When true, enables multi-account mode for this session. When not set, falls back to org/project-level configuration."
16655 },
15308 - "input_schema": {
15309 - "type": "object",
15310 - "additionalProperties": {},
15311 - "description": "Must have type: \"object\" and a properties field.",
15312 - "example": {
15313 - "type": "object",
15314 - "properties": {
15315 - "limit": {
15316 - "type": "number",
15317 - "description": "Max results to return"
15318 - }
16656 + "max_accounts_per_toolkit": {
16657 + "type": "integer",
16658 + "description": "Maximum number of connected accounts allowed per toolkit. Defaults to 5 when multi-account is enabled."
16659 + },
16660 + "require_explicit_selection": {
16661 + "type": "boolean",
16662 + "description": "When true, require explicit account selection when multiple accounts are connected. When false (default), use the first/default account."
16663 + }
16664 + },
16665 + "description": "Multi-account configuration for this session."
16666 + },
16667 + "preload": {
16668 + "type": "object",
16669 + "properties": {
16670 + "tools": {
16671 + "type": "array",
16672 + "items": {
16673 + "type": "string"
16674 + },
16675 + "description": "Tool slugs preloaded for this session. Appear in `session.tools` and the MCP server tool list, callable directly without going through search. Empty array when no preload was configured."
16676 + }
16677 + },
16678 + "required": [
16679 + "tools"
16680 + ],
16681 + "additionalProperties": false,
16682 + "description": "Preload configuration. Controls which tools appear in `session.tools` and the MCP server tool list, callable directly without going through search. Each preloaded tool adds to the agent context — roughly ≤20 tools is recommended. Always present in the response (empty `tools: []` when the session was created without a preload config)."
16683 + }
16684 + },
16685 + "required": [
16686 + "user_id",
16687 + "preload"
16688 + ],
16689 + "description": "The session configuration including user, toolkits, and overrides"
16690 + },
16691 + "config_version": {
16692 + "type": "integer",
16693 + "description": "Monotonic version of the config. Incremented on each PATCH. Use for optimistic concurrency control."
16694 + },
16695 + "experimental": {
16696 + "type": "object",
16697 + "properties": {
16698 + "assistive_prompt": {
16699 + "type": "string",
16700 + "description": "The assistive system prompt for the tool router session"
16701 + },
16702 + "custom_toolkits": {
16703 + "type": "array",
16704 + "items": {
16705 + "type": "object",
16706 + "properties": {
16707 + "slug": {
16708 + "type": "string",
16709 + "minLength": 1,
16710 + "pattern": "^[a-zA-Z0-9_-]+$"
16711 + },
16712 + "name": {
16713 + "type": "string",
16714 + "minLength": 1,
16715 + "maxLength": 128
16716 + },
16717 + "description": {
16718 + "type": "string",
16719 + "minLength": 1,
16720 + "maxLength": 2048
16721 + },
16722 + "tools": {
16723 + "type": "array",
16724 + "items": {
16725 + "type": "object",
16726 + "properties": {
16727 + "slug": {
16728 + "type": "string",
16729 + "description": "Prefixed tool slug (e.g. LOCAL_CRM_FIND_CUSTOMER)"
16730 + },
16731 + "name": {
16732 + "type": "string",
16733 + "minLength": 1,
16734 + "maxLength": 128
16735 + },
16736 + "description": {
16737 + "type": "string",
16738 + "minLength": 1,
16739 + "maxLength": 5120
16740 + },
16741 + "input_schema": {
16742 + "type": "object",
16743 + "additionalProperties": {}
16744 + },
16745 + "output_schema": {
16746 + "type": "object",
16747 + "additionalProperties": {}
16748 + },
16749 + "original_slug": {
16750 + "type": "string",
16751 + "description": "Original tool slug as provided by the user"
16752 + }
16753 + },
16754 + "required": [
16755 + "slug",
16756 + "name",
16757 + "description",
16758 + "input_schema",
16759 + "original_slug"
16760 + ]
16761 }
16762 }
16763 },
15322 - "output_schema": {
15323 - "type": "object",
15324 - "additionalProperties": {},
15325 - "description": "JSON Schema describing tool output (optional)"
15326 - },
15327 - "extends_toolkit": {
15328 - "type": "string",
15329 - "minLength": 1,
15330 - "description": "If set, must be a valid Composio toolkit slug. The tool inherits that toolkit's auth/connection status. If omitted, the tool is standalone (no-auth).",
15331 - "example": "gmail"
15332 - }
16764 + "required": [
16765 + "slug",
16766 + "name",
16767 + "description",
16768 + "tools"
16769 + ]
16770 },
15334 - "required": [
15335 - "slug",
15336 - "name",
15337 - "description",
15338 - "input_schema"
15339 - ]
16771 + "description": "User-defined custom toolkits with grouped tools (no-auth)"
16772 },
15341 - "description": "Custom tools to include in search. Standalone tools need no auth. Tools with extends_toolkit inherit the Composio toolkit's connection."
15342 - }
15343 - },
15344 - "additionalProperties": false,
15345 - "description": "Experimental features - not stable, may be modified or removed in future versions.",
15346 - "x-experimental": true
15347 - }
15348 - },
15349 - "required": [
15350 - "user_id"
15351 - ]
15352 - },
15353 - "examples": {
15354 - "Session with all toolkits": {
15355 - "value": {
15356 - "user_id": "user_123456789"
15357 - }
15358 - },
15359 - "Session with only specific toolkits": {
15360 - "value": {
15361 - "user_id": "user_123456789",
15362 - "toolkits": {
15363 - "enable": [
15364 - "gmail",
15365 - "slack"
15366 - ]
15367 - }
15368 - }
15369 - },
15370 - "Session with only specific toolkits disabled": {
15371 - "value": {
15372 - "user_id": "user_123456789",
15373 - "toolkits": {
15374 - "disable": [
15375 - "gmail",
15376 - "slack"
15377 - ]
15378 - }
15379 - }
15380 - },
15381 - "Session with connection manager enabled": {
15382 - "value": {
15383 - "user_id": "user_123456789",
15384 - "manage_connections": {
15385 - "enable": true
15386 - }
15387 - }
15388 - },
15389 - "Session with connection manager and specific toolkits": {
15390 - "value": {
15391 - "user_id": "user_123456789",
15392 - "toolkits": {
15393 - "enable": [
15394 - "gmail",
15395 - "slack"
15396 - ]
16773 + "custom_tools": {
16774 + "type": "array",
16775 + "items": {
16776 + "type": "object",
16777 + "properties": {
16778 + "slug": {
16779 + "type": "string",
16780 + "description": "Prefixed tool slug (e.g. LOCAL_GMAIL_GET_IMPORTANT_EMAILS)"
16781 + },
16782 + "name": {
16783 + "type": "string",
16784 + "minLength": 1,
16785 + "maxLength": 128
16786 + },
16787 + "description": {
16788 + "type": "string",
16789 + "minLength": 1,
16790 + "maxLength": 5120
16791 + },
16792 + "input_schema": {
16793 + "type": "object",
16794 + "additionalProperties": {}
16795 + },
16796 + "output_schema": {
16797 + "type": "object",
16798 + "additionalProperties": {}
16799 + },
16800 + "extends_toolkit": {
16801 + "type": "string",
16802 + "minLength": 1
16803 + },
16804 + "original_slug": {
16805 + "type": "string",
16806 + "description": "Original tool slug as provided by the user"
16807 + }
16808 + },
16809 + "required": [
16810 + "slug",
16811 + "name",
16812 + "description",
16813 + "input_schema",
16814 + "original_slug"
16815 + ]
16816 + },
16817 + "description": "Custom tools — standalone or extending Composio toolkits"
16818 + }
16819 + },
16820 + "description": "Experimental features including the generated system prompt. Only returned on session creation, not on GET.",
16821 + "x-experimental": true
16822 },
15398 - "manage_connections": {
15399 - "enable": true
15400 - }
15401 - }
15402 - },
15403 - "Session with custom callback URL": {
15404 - "value": {
15405 - "user_id": "user_123456789",
15406 - "toolkits": {
15407 - "enable": [
15408 - "github",
15409 - "slack"
16823 + "warnings": {
16824 + "type": "array",
16825 + "items": {
16826 + "type": "object",
16827 + "properties": {
16828 + "code": {
16829 + "type": "string",
16830 + "enum": [
16831 + "PRELOAD_TOOLS_HIGH_CONTEXT_USAGE"
16832 + ],
16833 + "description": "Stable machine code identifying the advisory. Safe to switch on in client code.",
16834 + "example": "PRELOAD_TOOLS_HIGH_CONTEXT_USAGE"
16835 + },
16836 + "message": {
16837 + "type": "string",
16838 + "description": "Human-readable description of the advisory. Suitable for logging or surfacing to end users.",
16839 + "example": "Session preloads 25 tools; each preloaded tool adds to the agent context window. Consider keeping the list at or under ~20 tools."
16840 + }
16841 + },
16842 + "required": [
16843 + "code",
16844 + "message"
16845 + ]
16846 + },
16847 + "default": [],
16848 + "description": "Advisory list — the session exists and is usable, but the listed issues may warrant attention.",
16849 + "example": [
16850 + {
16851 + "code": "PRELOAD_TOOLS_HIGH_CONTEXT_USAGE",
16852 + "message": "Session preloads 25 tools; each preloaded tool adds to the agent context window. Consider keeping the list at or under ~20 tools."
16853 + }
16854 ]
15411 - },
15412 - "manage_connections": {
15413 - "enable": true,
15414 - "callback_url": "https://your-app.com/auth/callback"
16855 }
15416 - }
15417 - },
15418 - "Session with workbench configuration": {
15419 - "value": {
15420 - "user_id": "user_123456789",
15421 - "toolkits": {
15422 - "enable": [
15423 - "gmail"
15424 - ]
15425 - },
15426 - "workbench": {
15427 - "enable_proxy_execution": true,
15428 - "auto_offload_threshold": 10000
16856 + },
16857 + "required": [
16858 + "session_id",
16859 + "mcp",
16860 + "tool_router_tools",
16861 + "config",
16862 + "config_version"
16863 + ]
16864 + }
16865 + }
16866 + }
16867 + },
16868 + "400": {
16869 + "description": "Bad request. This may occur if the user_id format is invalid, toolkit names are invalid, or auth_config_id IDs are malformed.",
16870 + "content": {
16871 + "application/json": {
16872 + "schema": {
16873 + "$ref": "#/components/schemas/Error"
16874 + }
16875 + }
16876 + }
16877 + },
16878 + "401": {
16879 + "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",
16880 + "content": {
16881 + "application/json": {
16882 + "schema": {
16883 + "$ref": "#/components/schemas/Error"
16884 + }
16885 + }
16886 + }
16887 + },
16888 + "403": {
16889 + "description": "Forbidden. The user is not authorized to create a tool router session.",
16890 + "content": {
16891 + "application/json": {
16892 + "schema": {
16893 + "$ref": "#/components/schemas/Error"
16894 + }
16895 + }
16896 + }
16897 + },
16898 + "408": {
16899 + "description": "Request timeout. The session creation took too long to complete.",
16900 + "content": {
16901 + "application/json": {
16902 + "schema": {
16903 + "$ref": "#/components/schemas/Error"
16904 + }
16905 + }
16906 + }
16907 + },
16908 + "500": {
16909 + "description": "Internal server error. An unexpected error occurred while processing the request.",
16910 + "content": {
16911 + "application/json": {
16912 + "schema": {
16913 + "$ref": "#/components/schemas/Error"
16914 + }
16915 + }
16916 + }
16917 + }
16918 + },
16919 + "x-api-version": "3.0"
16920 + }
16921 + },
16922 + "/api/v3/tool_router/session/{session_id}/execute": {
16923 + "post": {
16924 + "summary": "Execute a tool within a tool router session",
16925 + "description": "Executes a specific tool within a tool router session. This is the primary execution endpoint for both meta tools and app tools exposed by the session. The toolkit is automatically inferred from the tool slug. For app tools, the tool must belong to an allowed toolkit and must not be disabled in the session configuration. The endpoint validates permissions, resolves connected accounts when needed, and executes the tool with the session context. The top-level account field applies only to direct app tool execution in multi-account sessions. Meta/helper tools either ignore it or define their own account-selection fields, for example COMPOSIO_MULTI_EXECUTE_TOOL.tools[].account.",
16926 + "tags": [
16927 + "Tool Router"
16928 + ],
16929 + "operationId": "postToolRouterSessionBySessionIdExecute",
16930 + "security": [
16931 + {
16932 + "ApiKeyAuth": []
16933 + },
16934 + {
16935 + "UserApiKeyAuth": []
16936 + },
16937 + {
16938 + "workbench_access_key": []
16939 + }
16940 + ],
16941 + "parameters": [
16942 + {
16943 + "schema": {
16944 + "type": "string",
16945 + "format": "toolRouterSessionId",
16946 + "description": "The unique identifier of the tool router session. Required for public API endpoints, optional for internal endpoints where it is injected by middleware.",
16947 + "example": "trs_LX9uJKBinWWr"
16948 + },
16949 + "required": false,
16950 + "description": "Tool router session ID (required for public API, optional for internal - injected by middleware)",
16951 + "name": "session_id",
16952 + "in": "path"
16953 + }
16954 + ],
16955 + "requestBody": {
16956 + "content": {
16957 + "application/json": {
16958 + "schema": {
16959 + "type": "object",
16960 + "properties": {
16961 + "tool_slug": {
16962 + "type": "string",
16963 + "minLength": 1,
16964 + "description": "The unique slug identifier of the tool to execute. Supports both meta tools and app tools exposed by the session.",
16965 + "example": "GITHUB_CREATE_AN_ISSUE"
16966 + },
16967 + "arguments": {
16968 + "type": "object",
16969 + "additionalProperties": {},
16970 + "default": {},
16971 + "description": "The arguments required by the tool",
16972 + "example": {
16973 + "repository": "octocat/Hello-World",
16974 + "workflow_id": "main.yml",
16975 + "ref": "main",
16976 + "inputs": {
16977 + "environment": "production"
16978 + }
16979 }
16980 + },
16981 + "account": {
16982 + "type": "string",
16983 + "description": "Account identifier to specify which connected account to use for direct tool execution. Use the account ID (e.g. \"coup_hurricane_dal_analytical\") or an alias. When omitted with a single account, the default is used. When omitted with multiple accounts, an error lists available accounts. Meta/helper tools either ignore this top-level field or define their own account-selection fields, for example COMPOSIO_MULTI_EXECUTE_TOOL.tools[].account.",
16984 + "example": "coup_hurricane_dal_analytical"
16985 + },
16986 + "enable_auto_workbench_offload": {
16987 + "type": "boolean",
16988 + "description": "When true, direct non-meta tool execution may return a workbench offload preview if the response exceeds the configured threshold and the session workbench is enabled. When omitted or false, direct tool execution returns the normal inline response. Meta/helper tools are unaffected, and COMPOSIO_MULTI_EXECUTE_TOOL uses session.workbench configuration for its own batch-level offload behavior.",
16989 + "example": true
16990 }
16991 },
15432 - "Session with global tags filter": {
15433 - "value": {
15434 - "user_id": "user_123456789",
15435 - "toolkits": {
15436 - "enable": [
15437 - "gmail",
15438 - "slack"
15439 - ]
16992 + "required": [
16993 + "tool_slug"
16994 + ]
16995 + }
16996 + }
16997 + }
16998 + },
16999 + "responses": {
17000 + "200": {
17001 + "description": "Successfully executed the tool. Returns execution result, logs, and status.",
17002 + "content": {
17003 + "application/json": {
17004 + "schema": {
17005 + "type": "object",
17006 + "properties": {
17007 + "data": {
17008 + "type": "object",
17009 + "additionalProperties": {},
17010 + "description": "The data returned by the tool execution",
17011 + "example": {
17012 + "message": "Hello, World!",
17013 + "status": "success"
17014 + }
17015 },
15441 - "tags": [
15442 - "readOnlyHint",
15443 - "idempotentHint"
15444 - ]
15445 - }
15446 - },
15447 - "Session with auth config overrides": {
15448 - "value": {
15449 - "user_id": "user_123456789",
15450 - "toolkits": {
15451 - "enable": [
15452 - "gmail",
15453 - "slack"
15454 - ]
17016 + "error": {
17017 + "type": "string",
17018 + "nullable": true,
17019 + "description": "Error message if the execution failed, null otherwise"
17020 },
15456 - "auth_configs": {
15457 - "gmail": "ac_1a2b3c4d5e6f",
15458 - "slack": "ac_7g8h9i0j1k2l"
17021 + "log_id": {
17022 + "type": "string",
17023 + "description": "Unique identifier for the execution log",
17024 + "example": "log_abc123xyz"
17025 }
15460 - }
15461 - },
15462 - "Session with connected account overrides": {
15463 - "value": {
15464 - "user_id": "user_123456789",
15465 - "toolkits": {
15466 - "enable": [
15467 - "gmail",
15468 - "slack"
15469 - ]
15470 - },
15471 - "connected_accounts": {
15472 - "gmail": "ca_1a2b3c4d5e6f",
15473 - "slack": "ca_7g8h9i0j1k2l"
17026 + },
17027 + "required": [
17028 + "data",
17029 + "error",
17030 + "log_id"
17031 + ]
17032 + }
17033 + }
17034 + }
17035 + },
17036 + "400": {
17037 + "description": "Bad request",
17038 + "content": {
17039 + "application/json": {
17040 + "schema": {
17041 + "$ref": "#/components/schemas/Error"
17042 + }
17043 + }
17044 + }
17045 + },
17046 + "401": {
17047 + "description": "Unauthorized",
17048 + "content": {
17049 + "application/json": {
17050 + "schema": {
17051 + "$ref": "#/components/schemas/Error"
17052 + }
17053 + }
17054 + }
17055 + },
17056 + "403": {
17057 + "description": "Forbidden",
17058 + "content": {
17059 + "application/json": {
17060 + "schema": {
17061 + "$ref": "#/components/schemas/Error"
17062 + }
17063 + }
17064 + }
17065 + },
17066 + "404": {
17067 + "description": "Not found",
17068 + "content": {
17069 + "application/json": {
17070 + "schema": {
17071 + "$ref": "#/components/schemas/Error"
17072 + }
17073 + }
17074 + }
17075 + },
17076 + "413": {
17077 + "description": "Payload too large",
17078 + "content": {
17079 + "application/json": {
17080 + "schema": {
17081 + "$ref": "#/components/schemas/Error"
17082 + }
17083 + }
17084 + }
17085 + },
17086 + "429": {
17087 + "description": "Too many requests",
17088 + "content": {
17089 + "application/json": {
17090 + "schema": {
17091 + "$ref": "#/components/schemas/Error"
17092 + }
17093 + }
17094 + }
17095 + },
17096 + "500": {
17097 + "description": "Internal server error",
17098 + "content": {
17099 + "application/json": {
17100 + "schema": {
17101 + "$ref": "#/components/schemas/Error"
17102 + }
17103 + }
17104 + }
17105 + },
17106 + "502": {
17107 + "description": "Bad gateway",
17108 + "content": {
17109 + "application/json": {
17110 + "schema": {
17111 + "$ref": "#/components/schemas/Error"
17112 + }
17113 + }
17114 + }
17115 + }
17116 + },
17117 + "x-api-version": "3.0"
17118 + }
17119 + },
17120 + "/api/v3/tool_router/session/{session_id}/execute_meta": {
17121 + "post": {
17122 + "summary": "Execute a meta tool within a tool router session",
17123 + "description": "Executes a Composio meta tool (COMPOSIO_*) within a tool router session. This endpoint is kept for meta-tool compatibility; clients can also use the primary /execute endpoint.",
17124 + "tags": [
17125 + "Tool Router"
17126 + ],
17127 + "operationId": "postToolRouterSessionBySessionIdExecuteMeta",
17128 + "security": [
17129 + {
17130 + "ApiKeyAuth": []
17131 + },
17132 + {
17133 + "UserApiKeyAuth": []
17134 + }
17135 + ],
17136 + "parameters": [
17137 + {
17138 + "schema": {
17139 + "type": "string",
17140 + "format": "toolRouterSessionId",
17141 + "description": "The unique identifier of the tool router session. Required for public API endpoints, optional for internal endpoints where it is injected by middleware.",
17142 + "example": "trs_LX9uJKBinWWr"
17143 + },
17144 + "required": false,
17145 + "description": "Tool router session ID (required for public API, optional for internal - injected by middleware)",
17146 + "name": "session_id",
17147 + "in": "path"
17148 + }
17149 + ],
17150 + "requestBody": {
17151 + "content": {
17152 + "application/json": {
17153 + "schema": {
17154 + "type": "object",
17155 + "properties": {
17156 + "slug": {
17157 + "type": "string",
17158 + "enum": [
17159 + "COMPOSIO_SEARCH_TOOLS",
17160 + "COMPOSIO_MULTI_EXECUTE_TOOL",
17161 + "COMPOSIO_MANAGE_CONNECTIONS",
17162 + "COMPOSIO_WAIT_FOR_CONNECTIONS",
17163 + "COMPOSIO_REMOTE_WORKBENCH",
17164 + "COMPOSIO_REMOTE_BASH_TOOL",
17165 + "COMPOSIO_GET_TOOL_SCHEMAS",
17166 + "COMPOSIO_UPSERT_RECIPE",
17167 + "COMPOSIO_GET_RECIPE"
17168 + ],
17169 + "description": "The unique slug identifier of the meta tool to execute",
17170 + "example": "COMPOSIO_MANAGE_CONNECTIONS"
17171 + },
17172 + "arguments": {
17173 + "type": "object",
17174 + "additionalProperties": {},
17175 + "default": {},
17176 + "description": "The arguments required by the meta tool",
17177 + "example": {
17178 + "toolkits": [
17179 + "github"
17180 + ],
17181 + "reinitiate_all": false
17182 }
17183 }
17184 },
15477 - "Session with comprehensive configuration": {
15478 - "value": {
15479 - "user_id": "user_123456789",
15480 - "toolkits": {
15481 - "enable": [
15482 - "gmail",
15483 - "slack",
15484 - "github"
15485 - ]
15486 - },
15487 - "auth_configs": {
15488 - "gmail": "ac_1a2b3c4d5e6f",
15489 - "slack": "ac_7g8h9i0j1k2l"
15490 - },
15491 - "connected_accounts": {
15492 - "github": "ca_3m4n5o6p7q8r"
15493 - },
15494 - "manage_connections": {
15495 - "enable": true,
15496 - "callback_url": "https://your-app.com/auth/callback"
15497 - },
15498 - "tools": {
15499 - "gmail": {
15500 - "enable": [
15501 - "GMAIL_SEND_EMAIL",
15502 - "GMAIL_FETCH_EMAILS"
15503 - ]
15504 - },
15505 - "slack": {
15506 - "disable": [
15507 - "SLACK_ADD_EMOJI"
15508 - ]
15509 - },
15510 - "slack_bot": {
15511 - "tags": [
15512 - "destructiveHint"
15513 - ]
17185 + "required": [
17186 + "slug"
17187 + ]
17188 + }
17189 + }
17190 + }
17191 + },
17192 + "responses": {
17193 + "200": {
17194 + "description": "Successfully executed the meta tool. Returns execution result, logs, and status.",
17195 + "content": {
17196 + "application/json": {
17197 + "schema": {
17198 + "type": "object",
17199 + "properties": {
17200 + "data": {
17201 + "type": "object",
17202 + "additionalProperties": {},
17203 + "description": "The data returned by the tool execution",
17204 + "example": {
17205 + "message": "Hello, World!",
17206 + "status": "success"
17207 }
17208 },
15516 - "tags": [
15517 - "destructiveHint",
15518 - "idempotentHint"
15519 - ],
15520 - "workbench": {
15521 - "enable_proxy_execution": true,
15522 - "auto_offload_threshold": 10000
15523 - }
15524 - }
15525 - },
15526 - "Session with disabled toolkits and global tags": {
15527 - "value": {
15528 - "user_id": "user_123456789",
15529 - "toolkits": {
15530 - "disable": [
15531 - "gmail"
15532 - ]
17209 + "error": {
17210 + "type": "string",
17211 + "nullable": true,
17212 + "description": "Error message if the execution failed, null otherwise"
17213 },
15534 - "tags": [
15535 - "readOnlyHint"
15536 - ]
15537 - }
17214 + "log_id": {
17215 + "type": "string",
17216 + "description": "Unique identifier for the execution log",
17217 + "example": "log_abc123xyz"
17218 + }
17219 + },
17220 + "required": [
17221 + "data",
17222 + "error",
17223 + "log_id"
17224 + ]
17225 + }
17226 + }
17227 + }
17228 + },
17229 + "400": {
17230 + "description": "Bad request",
17231 + "content": {
17232 + "application/json": {
17233 + "schema": {
17234 + "$ref": "#/components/schemas/Error"
17235 + }
17236 + }
17237 + }
17238 + },
17239 + "401": {
17240 + "description": "Unauthorized",
17241 + "content": {
17242 + "application/json": {
17243 + "schema": {
17244 + "$ref": "#/components/schemas/Error"
17245 + }
17246 + }
17247 + }
17248 + },
17249 + "403": {
17250 + "description": "Forbidden",
17251 + "content": {
17252 + "application/json": {
17253 + "schema": {
17254 + "$ref": "#/components/schemas/Error"
17255 + }
17256 + }
17257 + }
17258 + },
17259 + "404": {
17260 + "description": "Not found",
17261 + "content": {
17262 + "application/json": {
17263 + "schema": {
17264 + "$ref": "#/components/schemas/Error"
17265 + }
17266 + }
17267 + }
17268 + },
17269 + "413": {
17270 + "description": "Payload too large",
17271 + "content": {
17272 + "application/json": {
17273 + "schema": {
17274 + "$ref": "#/components/schemas/Error"
17275 + }
17276 + }
17277 + }
17278 + },
17279 + "429": {
17280 + "description": "Too many requests",
17281 + "content": {
17282 + "application/json": {
17283 + "schema": {
17284 + "$ref": "#/components/schemas/Error"
17285 + }
17286 + }
17287 + }
17288 + },
17289 + "500": {
17290 + "description": "Internal server error",
17291 + "content": {
17292 + "application/json": {
17293 + "schema": {
17294 + "$ref": "#/components/schemas/Error"
17295 + }
17296 + }
17297 + }
17298 + },
17299 + "502": {
17300 + "description": "Bad gateway",
17301 + "content": {
17302 + "application/json": {
17303 + "schema": {
17304 + "$ref": "#/components/schemas/Error"
17305 }
17306 }
17307 }
17308 }
17309 },
17310 + "x-api-version": "3.0"
17311 + }
17312 + },
17313 + "/api/v3/tool_router/session/{session_id}": {
17314 + "get": {
17315 + "summary": "Get a tool router session by ID",
17316 + "description": "Retrieves an existing tool router session by its ID. Returns the session configuration, MCP server URL, and available tools.",
17317 + "tags": [
17318 + "Tool Router"
17319 + ],
17320 + "operationId": "getToolRouterSessionBySessionId",
17321 + "security": [
17322 + {
17323 + "ApiKeyAuth": []
17324 + },
17325 + {
17326 + "UserApiKeyAuth": []
17327 + }
17328 + ],
17329 + "parameters": [
17330 + {
17331 + "schema": {
17332 + "type": "string",
17333 + "format": "toolRouterSessionId",
17334 + "description": "The session ID returned when creating the session",
17335 + "example": "trs_1a2b3c4d5e6f"
17336 + },
17337 + "required": true,
17338 + "description": "The unique identifier of the tool router session",
17339 + "name": "session_id",
17340 + "in": "path"
17341 + }
17342 + ],
17343 "responses": {
15544 - "201": {
15545 - "description": "Session successfully created. Returns the session ID and MCP server URL for the created session.",
17344 + "200": {
17345 + "description": "Session successfully retrieved. Returns the session details including configuration.",
17346 "content": {
17347 "application/json": {
17348 "schema": {
@@ -15636,10 +17436,22 @@
17436 "connected_accounts": {
17437 "type": "object",
17438 "additionalProperties": {
15639 - "type": "string",
15640 - "format": "connectedAccountId"
17439 + "type": "string",
17440 + "format": "connectedAccountId"
17441 + },
17442 + "description": "Per-toolkit connected account override (single nano-ID). Returns the first override when multi-account is enabled; see `all_connected_accounts` for the full list."
17443 + },
17444 + "all_connected_accounts": {
17445 + "type": "object",
17446 + "additionalProperties": {
17447 + "type": "array",
17448 + "items": {
17449 + "type": "string",
17450 + "format": "connectedAccountId"
17451 + },
17452 + "minItems": 1
17453 },
15642 - "description": "Connected account overrides per toolkit"
17454 + "description": "Full per-toolkit connected account overrides as arrays. Populated whenever `connected_accounts` is non-empty; carries the complete list when multi-account is enabled."
17455 },
17456 "manage_connections": {
17457 "type": "object",
@@ -15665,758 +17477,867 @@
17477 "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS. Default true."
17478 }
17479 },
15668 - "description": "Manage connections configuration"
17480 + "description": "Manage connections configuration"
17481 + },
17482 + "tools": {
17483 + "type": "object",
17484 + "additionalProperties": {
17485 + "anyOf": [
17486 + {
17487 + "type": "object",
17488 + "properties": {
17489 + "enabled": {
17490 + "type": "array",
17491 + "items": {
17492 + "type": "string"
17493 + }
17494 + }
17495 + },
17496 + "required": [
17497 + "enabled"
17498 + ],
17499 + "additionalProperties": false
17500 + },
17501 + {
17502 + "type": "object",
17503 + "properties": {
17504 + "disabled": {
17505 + "type": "array",
17506 + "items": {
17507 + "type": "string"
17508 + }
17509 + }
17510 + },
17511 + "required": [
17512 + "disabled"
17513 + ],
17514 + "additionalProperties": false
17515 + },
17516 + {
17517 + "type": "object",
17518 + "properties": {
17519 + "tags": {
17520 + "type": "object",
17521 + "properties": {
17522 + "enabled": {
17523 + "type": "array",
17524 + "items": {
17525 + "type": "string",
17526 + "enum": [
17527 + "readOnlyHint",
17528 + "destructiveHint",
17529 + "idempotentHint",
17530 + "openWorldHint"
17531 + ]
17532 + },
17533 + "description": "Tags that the tool must have at least one of"
17534 + },
17535 + "disabled": {
17536 + "type": "array",
17537 + "items": {
17538 + "type": "string",
17539 + "enum": [
17540 + "readOnlyHint",
17541 + "destructiveHint",
17542 + "idempotentHint",
17543 + "openWorldHint"
17544 + ]
17545 + },
17546 + "description": "Tags that the tool must NOT have any of"
17547 + }
17548 + }
17549 + }
17550 + },
17551 + "required": [
17552 + "tags"
17553 + ],
17554 + "additionalProperties": false
17555 + }
17556 + ]
17557 + },
17558 + "description": "Tool-level configuration per toolkit"
17559 + },
17560 + "tags": {
17561 + "type": "object",
17562 + "properties": {
17563 + "enabled": {
17564 + "type": "array",
17565 + "items": {
17566 + "type": "string",
17567 + "enum": [
17568 + "readOnlyHint",
17569 + "destructiveHint",
17570 + "idempotentHint",
17571 + "openWorldHint"
17572 + ]
17573 + },
17574 + "description": "Tags that the tool must have at least one of"
17575 + },
17576 + "disabled": {
17577 + "type": "array",
17578 + "items": {
17579 + "type": "string",
17580 + "enum": [
17581 + "readOnlyHint",
17582 + "destructiveHint",
17583 + "idempotentHint",
17584 + "openWorldHint"
17585 + ]
17586 + },
17587 + "description": "Tags that the tool must NOT have any of"
17588 + }
17589 + },
17590 + "description": "MCP tool annotation hints for filtering tools with enabled/disabled support. enabled: tags that the tool must have at least one of. disabled: tags that the tool must NOT have any of. Both conditions must be satisfied."
17591 + },
17592 + "workbench": {
17593 + "type": "object",
17594 + "properties": {
17595 + "enable": {
17596 + "type": "boolean",
17597 + "description": "Whether the workbench (code execution sandbox) is enabled. When false, COMPOSIO_REMOTE_WORKBENCH and COMPOSIO_REMOTE_BASH_TOOL are not exposed."
17598 + },
17599 + "proxy_execution_enabled": {
17600 + "type": "boolean",
17601 + "description": "Whether proxy execution is enabled in the workbench"
17602 + },
17603 + "auto_offload_threshold": {
17604 + "type": "number",
17605 + "minimum": 0,
17606 + "exclusiveMinimum": true,
17607 + "description": "Character threshold after which tool execution response are saved to a file in workbench. Default is 20k."
17608 + },
17609 + "sandbox_size": {
17610 + "type": "string",
17611 + "enum": [
17612 + "standard",
17613 + "medium",
17614 + "large",
17615 + "xlarge"
17616 + ],
17617 + "description": "Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4 vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard."
17618 + }
17619 + },
17620 + "default": {
17621 + "enable": true,
17622 + "proxy_execution_enabled": true
17623 + },
17624 + "description": "Workbench configuration"
17625 + },
17626 + "multi_account": {
17627 + "type": "object",
17628 + "properties": {
17629 + "enable": {
17630 + "type": "boolean",
17631 + "description": "When true, enables multi-account mode for this session. When not set, falls back to org/project-level configuration."
17632 + },
17633 + "max_accounts_per_toolkit": {
17634 + "type": "integer",
17635 + "description": "Maximum number of connected accounts allowed per toolkit. Defaults to 5 when multi-account is enabled."
17636 + },
17637 + "require_explicit_selection": {
17638 + "type": "boolean",
17639 + "description": "When true, require explicit account selection when multiple accounts are connected. When false (default), use the first/default account."
17640 + }
17641 + },
17642 + "description": "Multi-account configuration for this session."
17643 + },
17644 + "preload": {
17645 + "type": "object",
17646 + "properties": {
17647 + "tools": {
17648 + "type": "array",
17649 + "items": {
17650 + "type": "string"
17651 + },
17652 + "description": "Tool slugs preloaded for this session. Appear in `session.tools` and the MCP server tool list, callable directly without going through search. Empty array when no preload was configured."
17653 + }
17654 + },
17655 + "required": [
17656 + "tools"
17657 + ],
17658 + "additionalProperties": false,
17659 + "description": "Preload configuration. Controls which tools appear in `session.tools` and the MCP server tool list, callable directly without going through search. Each preloaded tool adds to the agent context — roughly ≤20 tools is recommended. Always present in the response (empty `tools: []` when the session was created without a preload config)."
17660 + }
17661 + },
17662 + "required": [
17663 + "user_id",
17664 + "preload"
17665 + ],
17666 + "description": "The session configuration including user, toolkits, and overrides"
17667 + },
17668 + "config_version": {
17669 + "type": "integer",
17670 + "description": "Monotonic version of the config. Incremented on each PATCH. Use for optimistic concurrency control."
17671 + },
17672 + "experimental": {
17673 + "type": "object",
17674 + "properties": {
17675 + "assistive_prompt": {
17676 + "type": "string",
17677 + "description": "The assistive system prompt for the tool router session"
17678 + },
17679 + "custom_toolkits": {
17680 + "type": "array",
17681 + "items": {
17682 + "type": "object",
17683 + "properties": {
17684 + "slug": {
17685 + "type": "string",
17686 + "minLength": 1,
17687 + "pattern": "^[a-zA-Z0-9_-]+$"
17688 + },
17689 + "name": {
17690 + "type": "string",
17691 + "minLength": 1,
17692 + "maxLength": 128
17693 + },
17694 + "description": {
17695 + "type": "string",
17696 + "minLength": 1,
17697 + "maxLength": 2048
17698 + },
17699 + "tools": {
17700 + "type": "array",
17701 + "items": {
17702 + "type": "object",
17703 + "properties": {
17704 + "slug": {
17705 + "type": "string",
17706 + "description": "Prefixed tool slug (e.g. LOCAL_CRM_FIND_CUSTOMER)"
17707 + },
17708 + "name": {
17709 + "type": "string",
17710 + "minLength": 1,
17711 + "maxLength": 128
17712 + },
17713 + "description": {
17714 + "type": "string",
17715 + "minLength": 1,
17716 + "maxLength": 5120
17717 + },
17718 + "input_schema": {
17719 + "type": "object",
17720 + "additionalProperties": {}
17721 + },
17722 + "output_schema": {
17723 + "type": "object",
17724 + "additionalProperties": {}
17725 + },
17726 + "original_slug": {
17727 + "type": "string",
17728 + "description": "Original tool slug as provided by the user"
17729 + }
17730 + },
17731 + "required": [
17732 + "slug",
17733 + "name",
17734 + "description",
17735 + "input_schema",
17736 + "original_slug"
17737 + ]
17738 + }
17739 + }
17740 + },
17741 + "required": [
17742 + "slug",
17743 + "name",
17744 + "description",
17745 + "tools"
17746 + ]
17747 + },
17748 + "description": "User-defined custom toolkits with grouped tools (no-auth)"
17749 },
15670 - "tools": {
15671 - "type": "object",
15672 - "additionalProperties": {
15673 - "anyOf": [
15674 - {
15675 - "type": "object",
15676 - "properties": {
15677 - "enabled": {
15678 - "type": "array",
15679 - "items": {
15680 - "type": "string"
15681 - }
15682 - }
15683 - },
15684 - "required": [
15685 - "enabled"
15686 - ],
15687 - "additionalProperties": false
17750 + "custom_tools": {
17751 + "type": "array",
17752 + "items": {
17753 + "type": "object",
17754 + "properties": {
17755 + "slug": {
17756 + "type": "string",
17757 + "description": "Prefixed tool slug (e.g. LOCAL_GMAIL_GET_IMPORTANT_EMAILS)"
17758 },
15689 - {
17759 + "name": {
17760 + "type": "string",
17761 + "minLength": 1,
17762 + "maxLength": 128
17763 + },
17764 + "description": {
17765 + "type": "string",
17766 + "minLength": 1,
17767 + "maxLength": 5120
17768 + },
17769 + "input_schema": {
17770 "type": "object",
15691 - "properties": {
15692 - "disabled": {
15693 - "type": "array",
15694 - "items": {
15695 - "type": "string"
15696 - }
15697 - }
15698 - },
15699 - "required": [
15700 - "disabled"
15701 - ],
15702 - "additionalProperties": false
17771 + "additionalProperties": {}
17772 },
15704 - {
17773 + "output_schema": {
17774 "type": "object",
15706 - "properties": {
15707 - "tags": {
15708 - "type": "object",
15709 - "properties": {
15710 - "enabled": {
15711 - "type": "array",
15712 - "items": {
15713 - "type": "string",
15714 - "enum": [
15715 - "readOnlyHint",
15716 - "destructiveHint",
15717 - "idempotentHint",
15718 - "openWorldHint"
15719 - ]
15720 - },
15721 - "description": "Tags that the tool must have at least one of"
15722 - },
15723 - "disabled": {
15724 - "type": "array",
15725 - "items": {
15726 - "type": "string",
15727 - "enum": [
15728 - "readOnlyHint",
15729 - "destructiveHint",
15730 - "idempotentHint",
15731 - "openWorldHint"
15732 - ]
15733 - },
15734 - "description": "Tags that the tool must NOT have any of"
15735 - }
15736 - }
15737 - }
15738 - },
15739 - "required": [
15740 - "tags"
15741 - ],
15742 - "additionalProperties": false
17775 + "additionalProperties": {}
17776 + },
17777 + "extends_toolkit": {
17778 + "type": "string",
17779 + "minLength": 1
17780 + },
17781 + "original_slug": {
17782 + "type": "string",
17783 + "description": "Original tool slug as provided by the user"
17784 }
17785 + },
17786 + "required": [
17787 + "slug",
17788 + "name",
17789 + "description",
17790 + "input_schema",
17791 + "original_slug"
17792 + ]
17793 + },
17794 + "description": "Custom tools — standalone or extending Composio toolkits"
17795 + }
17796 + },
17797 + "description": "Experimental features",
17798 + "x-experimental": true
17799 + },
17800 + "warnings": {
17801 + "type": "array",
17802 + "items": {
17803 + "type": "object",
17804 + "properties": {
17805 + "code": {
17806 + "type": "string",
17807 + "enum": [
17808 + "PRELOAD_TOOLS_HIGH_CONTEXT_USAGE"
17809 + ],
17810 + "description": "Stable machine code identifying the advisory. Safe to switch on in client code.",
17811 + "example": "PRELOAD_TOOLS_HIGH_CONTEXT_USAGE"
17812 + },
17813 + "message": {
17814 + "type": "string",
17815 + "description": "Human-readable description of the advisory. Suitable for logging or surfacing to end users.",
17816 + "example": "Session preloads 25 tools; each preloaded tool adds to the agent context window. Consider keeping the list at or under ~20 tools."
17817 + }
17818 + },
17819 + "required": [
17820 + "code",
17821 + "message"
17822 + ]
17823 + },
17824 + "default": [],
17825 + "description": "Advisory list — the session exists and is usable, but the listed issues may warrant attention.",
17826 + "example": [
17827 + {
17828 + "code": "PRELOAD_TOOLS_HIGH_CONTEXT_USAGE",
17829 + "message": "Session preloads 25 tools; each preloaded tool adds to the agent context window. Consider keeping the list at or under ~20 tools."
17830 + }
17831 + ]
17832 + }
17833 + },
17834 + "required": [
17835 + "session_id",
17836 + "mcp",
17837 + "tool_router_tools",
17838 + "config",
17839 + "config_version"
17840 + ]
17841 + }
17842 + }
17843 + }
17844 + },
17845 + "400": {
17846 + "description": "Bad request. This may occur if the session_id format is invalid, please pass this in trs_ prefix format",
17847 + "content": {
17848 + "application/json": {
17849 + "schema": {
17850 + "$ref": "#/components/schemas/Error"
17851 + }
17852 + }
17853 + }
17854 + },
17855 + "401": {
17856 + "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",
17857 + "content": {
17858 + "application/json": {
17859 + "schema": {
17860 + "$ref": "#/components/schemas/Error"
17861 + }
17862 + }
17863 + }
17864 + },
17865 + "404": {
17866 + "description": "Not found. The session with the provided ID does not exist or has been deleted.",
17867 + "content": {
17868 + "application/json": {
17869 + "schema": {
17870 + "$ref": "#/components/schemas/Error"
17871 + }
17872 + }
17873 + }
17874 + },
17875 + "500": {
17876 + "description": "Internal server error. An unexpected error occurred while processing the request.",
17877 + "content": {
17878 + "application/json": {
17879 + "schema": {
17880 + "$ref": "#/components/schemas/Error"
17881 + }
17882 + }
17883 + }
17884 + }
17885 + },
17886 + "x-api-version": "3.0"
17887 + },
17888 + "patch": {
17889 + "summary": "Patch a tool router session config",
17890 + "description": "Partially updates the configuration of an existing tool router session. Only the fields provided in the request body will be updated. Uses optimistic concurrency control to prevent lost updates. The previous config is stored in config history.",
17891 + "tags": [
17892 + "Tool Router"
17893 + ],
17894 + "operationId": "patchToolRouterSessionBySessionId",
17895 + "security": [
17896 + {
17897 + "ApiKeyAuth": []
17898 + },
17899 + {
17900 + "UserApiKeyAuth": []
17901 + }
17902 + ],
17903 + "parameters": [
17904 + {
17905 + "schema": {
17906 + "type": "string",
17907 + "format": "toolRouterSessionId",
17908 + "description": "The unique identifier of the tool router session",
17909 + "example": "trs_1a2b3c4d5e6f"
17910 + },
17911 + "required": true,
17912 + "description": "The unique identifier of the tool router session",
17913 + "name": "session_id",
17914 + "in": "path"
17915 + }
17916 + ],
17917 + "requestBody": {
17918 + "content": {
17919 + "application/json": {
17920 + "schema": {
17921 + "type": "object",
17922 + "properties": {
17923 + "toolkits": {
17924 + "anyOf": [
17925 + {
17926 + "type": "object",
17927 + "properties": {
17928 + "enable": {
17929 + "type": "array",
17930 + "items": {
17931 + "type": "string"
17932 + },
17933 + "description": "Only these specific toolkits will be enabled",
17934 + "example": [
17935 + "gmail",
17936 + "slack",
17937 + "github"
17938 + ]
17939 + }
17940 + },
17941 + "required": [
17942 + "enable"
17943 + ],
17944 + "additionalProperties": false,
17945 + "description": "Enable only specific toolkits (allowlist)"
17946 + },
17947 + {
17948 + "type": "object",
17949 + "properties": {
17950 + "disable": {
17951 + "type": "array",
17952 + "items": {
17953 + "type": "string"
17954 + },
17955 + "description": "These specific toolkits will be disabled",
17956 + "example": [
17957 + "gmail",
17958 + "slack"
17959 ]
15745 - },
15746 - "description": "Tool-level configuration per toolkit"
17960 + }
17961 },
15748 - "tags": {
17962 + "required": [
17963 + "disable"
17964 + ],
17965 + "additionalProperties": false,
17966 + "description": "Disable specific toolkits (denylist)"
17967 + }
17968 + ],
17969 + "description": "Toolkit configuration - specify either enable toolkits (allowlist) or disable toolkits (denylist). Mutually exclusive."
17970 + },
17971 + "auth_configs": {
17972 + "type": "object",
17973 + "additionalProperties": {
17974 + "type": "string",
17975 + "format": "authConfigId"
17976 + },
17977 + "description": "The auth configs to use for the session. This will override the default behavior and use the given auth config when specific toolkits are being executed",
17978 + "example": {
17979 + "gmail": "ac_1a2b3c4d5e6f",
17980 + "slack": "ac_7g8h9i0j1k2l"
17981 + }
17982 + },
17983 + "connected_accounts": {
17984 + "type": "object",
17985 + "description": "Per-toolkit connected account override (single nano-ID). Each connected account must exist (not deleted or disabled) and belong to the same `user_id` as the session.",
17986 + "additionalProperties": {
17987 + "type": "string",
17988 + "example": "ca_3m4n5o6p7q8r"
17989 + },
17990 + "example": {
17991 + "github": "ca_3m4n5o6p7q8r"
17992 + }
17993 + },
17994 + "manage_connections": {
17995 + "type": "object",
17996 + "nullable": true,
17997 + "properties": {
17998 + "enable": {
17999 + "type": "boolean",
18000 + "nullable": true,
18001 + "description": "Whether to enable the connection manager for automatic connection handling. If true, we will provide a tool your agent can use to initiate connections to toolkits if it doesnt exist. If set to false, then you have to manage connections manually.",
18002 + "example": true
18003 + },
18004 + "callback_url": {
18005 + "type": "string",
18006 + "format": "uri",
18007 + "description": "The URL to redirect to after a user completes authentication for a connected account. This allows you to handle the auth callback in your own application.",
18008 + "example": "https://your-app.com/auth/callback"
18009 + },
18010 + "enable_wait_for_connections": {
18011 + "type": "boolean",
18012 + "nullable": true,
18013 + "description": "When true, the COMPOSIO_WAIT_FOR_CONNECTIONS tool is available for agents to poll connection status after sharing auth URLs. Default is false (disabled). May not work reliably with GPT models.",
18014 + "example": false
18015 + },
18016 + "enable_connection_removal": {
18017 + "type": "boolean",
18018 + "nullable": true,
18019 + "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS to allow deleting connected accounts. Default true."
18020 + }
18021 + },
18022 + "additionalProperties": false
18023 + },
18024 + "tools": {
18025 + "type": "object",
18026 + "additionalProperties": {
18027 + "anyOf": [
18028 + {
18029 "type": "object",
18030 "properties": {
15751 - "enabled": {
15752 - "type": "array",
15753 - "items": {
15754 - "type": "string",
15755 - "enum": [
15756 - "readOnlyHint",
15757 - "destructiveHint",
15758 - "idempotentHint",
15759 - "openWorldHint"
15760 - ]
15761 - },
15762 - "description": "Tags that the tool must have at least one of"
15763 - },
15764 - "disabled": {
18031 + "enable": {
18032 "type": "array",
18033 "items": {
15767 - "type": "string",
15768 - "enum": [
15769 - "readOnlyHint",
15770 - "destructiveHint",
15771 - "idempotentHint",
15772 - "openWorldHint"
15773 - ]
18034 + "type": "string"
18035 },
15775 - "description": "Tags that the tool must NOT have any of"
18036 + "description": "Only these specific tools will be available for this toolkit",
18037 + "example": [
18038 + "GMAIL_SEND_EMAIL",
18039 + "GMAIL_FETCH_EMAILS"
18040 + ]
18041 }
18042 },
15778 - "description": "MCP tool annotation hints for filtering tools with enabled/disabled support. enabled: tags that the tool must have at least one of. disabled: tags that the tool must NOT have any of. Both conditions must be satisfied."
18043 + "required": [
18044 + "enable"
18045 + ],
18046 + "additionalProperties": false
18047 },
15780 - "workbench": {
18048 + {
18049 "type": "object",
18050 "properties": {
15783 - "enable": {
15784 - "type": "boolean",
15785 - "description": "Whether the workbench (code execution sandbox) is enabled. When false, COMPOSIO_REMOTE_WORKBENCH and COMPOSIO_REMOTE_BASH_TOOL are not exposed."
15786 - },
15787 - "proxy_execution_enabled": {
15788 - "type": "boolean",
15789 - "description": "Whether proxy execution is enabled in the workbench"
15790 - },
15791 - "auto_offload_threshold": {
15792 - "type": "number",
15793 - "minimum": 0,
15794 - "exclusiveMinimum": true,
15795 - "description": "Character threshold after which tool execution response are saved to a file in workbench. Default is 20k."
18051 + "disable": {
18052 + "type": "array",
18053 + "items": {
18054 + "type": "string"
18055 + },
18056 + "description": "These specific tools will be disabled for this toolkit",
18057 + "example": [
18058 + "SLACK_ADD_EMOJI"
18059 + ]
18060 }
18061 },
15798 - "default": {
15799 - "enable": true,
15800 - "proxy_execution_enabled": true
15801 - },
15802 - "description": "Workbench configuration"
18062 + "required": [
18063 + "disable"
18064 + ],
18065 + "additionalProperties": false
18066 },
15804 - "multi_account": {
18067 + {
18068 "type": "object",
18069 "properties": {
15807 - "enable": {
15808 - "type": "boolean",
15809 - "description": "When true, enables multi-account mode for this session. When not set, falls back to org/project-level configuration."
15810 - },
15811 - "max_accounts_per_toolkit": {
15812 - "type": "integer",
15813 - "description": "Maximum number of connected accounts allowed per toolkit. Defaults to 5 when multi-account is enabled."
15814 - },
15815 - "require_explicit_selection": {
15816 - "type": "boolean",
15817 - "description": "When true, require explicit account selection when multiple accounts are connected. When false (default), use the first/default account."
15818 - }
15819 - },
15820 - "description": "Multi-account configuration for this session."
15821 - }
15822 - },
15823 - "required": [
15824 - "user_id"
15825 - ],
15826 - "description": "The session configuration including user, toolkits, and overrides"
15827 - },
15828 - "experimental": {
15829 - "type": "object",
15830 - "properties": {
15831 - "assistive_prompt": {
15832 - "type": "string",
15833 - "description": "The assistive system prompt for the tool router session"
15834 - },
15835 - "custom_toolkits": {
15836 - "type": "array",
15837 - "items": {
15838 - "type": "object",
15839 - "properties": {
15840 - "slug": {
15841 - "type": "string",
15842 - "minLength": 1,
15843 - "pattern": "^[a-zA-Z0-9_-]+$"
15844 - },
15845 - "name": {
15846 - "type": "string",
15847 - "minLength": 1,

This file is too large to show in full.

docs/public/openapi.json
+18129 -13240
@@ -451,6 +451,363 @@
451 "total_items"
452 ]
453 },
454 + "ToolRouterSessionV31ConfigHistoryListResponse": {
455 + "type": "object",
456 + "properties": {
457 + "items": {
458 + "type": "array",
459 + "items": {
460 + "type": "object",
461 + "properties": {
462 + "version": {
463 + "type": "integer",
464 + "description": "The config version this entry represents"
465 + },
466 + "created_at": {
467 + "type": "string",
468 + "format": "date-time",
469 + "description": "ISO timestamp. For history rows, when the entry was archived (i.e. the moment the version was superseded by a PATCH)."
470 + },
471 + "config": {
472 + "type": "object",
473 + "properties": {
474 + "user_id": {
475 + "type": "string",
476 + "description": "User identifier for this session"
477 + },
478 + "toolkits": {
479 + "anyOf": [
480 + {
481 + "type": "object",
482 + "properties": {
483 + "enabled": {
484 + "type": "array",
485 + "items": {
486 + "type": "string"
487 + }
488 + }
489 + },
490 + "required": [
491 + "enabled"
492 + ],
493 + "additionalProperties": false
494 + },
495 + {
496 + "type": "object",
497 + "properties": {
498 + "disabled": {
499 + "type": "array",
500 + "items": {
501 + "type": "string"
502 + }
503 + }
504 + },
505 + "required": [
506 + "disabled"
507 + ],
508 + "additionalProperties": false
509 + }
510 + ],
511 + "description": "Toolkit configuration - either enabled list or disabled list"
512 + },
513 + "auth_configs": {
514 + "type": "object",
515 + "additionalProperties": {
516 + "type": "string",
517 + "format": "authConfigId"
518 + },
519 + "description": "Auth config overrides per toolkit"
520 + },
521 + "manage_connections": {
522 + "type": "object",
523 + "properties": {
524 + "enabled": {
525 + "type": "boolean",
526 + "default": true,
527 + "description": "Whether to enable the connection manager for automatic connection handling"
528 + },
529 + "callback_url": {
530 + "type": "string",
531 + "format": "uri",
532 + "description": "Custom callback URL for connected account auth flows"
533 + },
534 + "enable_wait_for_connections": {
535 + "type": "boolean",
536 + "default": false,
537 + "description": "Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status. Default false. May not work reliably with GPT models."
538 + },
539 + "enable_connection_removal": {
540 + "type": "boolean",
541 + "default": true,
542 + "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS. Default true."
543 + }
544 + },
545 + "description": "Manage connections configuration"
546 + },
547 + "tools": {
548 + "type": "object",
549 + "additionalProperties": {
550 + "anyOf": [
551 + {
552 + "type": "object",
553 + "properties": {
554 + "enabled": {
555 + "type": "array",
556 + "items": {
557 + "type": "string"
558 + }
559 + }
560 + },
561 + "required": [
562 + "enabled"
563 + ],
564 + "additionalProperties": false
565 + },
566 + {
567 + "type": "object",
568 + "properties": {
569 + "disabled": {
570 + "type": "array",
571 + "items": {
572 + "type": "string"
573 + }
574 + }
575 + },
576 + "required": [
577 + "disabled"
578 + ],
579 + "additionalProperties": false
580 + },
581 + {
582 + "type": "object",
583 + "properties": {
584 + "tags": {
585 + "type": "object",
586 + "properties": {
587 + "enabled": {
588 + "type": "array",
589 + "items": {
590 + "type": "string",
591 + "enum": [
592 + "readOnlyHint",
593 + "destructiveHint",
594 + "idempotentHint",
595 + "openWorldHint"
596 + ]
597 + },
598 + "description": "Tags that the tool must have at least one of"
599 + },
600 + "disabled": {
601 + "type": "array",
602 + "items": {
603 + "type": "string",
604 + "enum": [
605 + "readOnlyHint",
606 + "destructiveHint",
607 + "idempotentHint",
608 + "openWorldHint"
609 + ]
610 + },
611 + "description": "Tags that the tool must NOT have any of"
612 + }
613 + }
614 + }
615 + },
616 + "required": [
617 + "tags"
618 + ],
619 + "additionalProperties": false
620 + }
621 + ]
622 + },
623 + "description": "Tool-level configuration per toolkit"
624 + },
625 + "tags": {
626 + "type": "object",
627 + "properties": {
628 + "enabled": {
629 + "type": "array",
630 + "items": {
631 + "type": "string",
632 + "enum": [
633 + "readOnlyHint",
634 + "destructiveHint",
635 + "idempotentHint",
636 + "openWorldHint"
637 + ]
638 + },
639 + "description": "Tags that the tool must have at least one of"
640 + },
641 + "disabled": {
642 + "type": "array",
643 + "items": {
644 + "type": "string",
645 + "enum": [
646 + "readOnlyHint",
647 + "destructiveHint",
648 + "idempotentHint",
649 + "openWorldHint"
650 + ]
651 + },
652 + "description": "Tags that the tool must NOT have any of"
653 + }
654 + },
655 + "description": "MCP tool annotation hints for filtering tools with enabled/disabled support. enabled: tags that the tool must have at least one of. disabled: tags that the tool must NOT have any of. Both conditions must be satisfied."
656 + },
657 + "workbench": {
658 + "type": "object",
659 + "properties": {
660 + "enable": {
661 + "type": "boolean",
662 + "description": "Whether the workbench (code execution sandbox) is enabled. When false, COMPOSIO_REMOTE_WORKBENCH and COMPOSIO_REMOTE_BASH_TOOL are not exposed."
663 + },
664 + "proxy_execution_enabled": {
665 + "type": "boolean",
666 + "description": "Whether proxy execution is enabled in the workbench"
667 + },
668 + "auto_offload_threshold": {
669 + "type": "number",
670 + "minimum": 0,
671 + "exclusiveMinimum": true,
672 + "description": "Character threshold after which tool execution response are saved to a file in workbench. Default is 20k."
673 + },
674 + "sandbox_size": {
675 + "type": "string",
676 + "enum": [
677 + "standard",
678 + "medium",
679 + "large",
680 + "xlarge"
681 + ],
682 + "description": "Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4 vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard."
683 + }
684 + },
685 + "default": {
686 + "enable": true,
687 + "proxy_execution_enabled": true
688 + },
689 + "description": "Workbench configuration"
690 + },
691 + "multi_account": {
692 + "type": "object",
693 + "properties": {
694 + "enable": {
695 + "type": "boolean",
696 + "description": "When true, enables multi-account mode for this session. When not set, falls back to org/project-level configuration."
697 + },
698 + "max_accounts_per_toolkit": {
699 + "type": "integer",
700 + "description": "Maximum number of connected accounts allowed per toolkit. Defaults to 5 when multi-account is enabled."
701 + },
702 + "require_explicit_selection": {
703 + "type": "boolean",
704 + "description": "When true, require explicit account selection when multiple accounts are connected. When false (default), use the first/default account."
705 + }
706 + },
707 + "description": "Multi-account configuration for this session."
708 + },
709 + "preload": {
710 + "type": "object",
711 + "properties": {
712 + "tools": {
713 + "anyOf": [
714 + {
715 + "type": "array",
716 + "items": {
717 + "type": "string"
718 + }
719 + },
720 + {
721 + "type": "string",
722 + "enum": [
723 + "all"
724 + ]
725 + }
726 + ],
727 + "description": "Explicit preloaded tool slugs, or \"all\" when the session dynamically exposes all app tools allowed by its filters."
728 + }
729 + },
730 + "required": [
731 + "tools"
732 + ],
733 + "additionalProperties": false,
734 + "description": "Preload configuration. Explicit slugs are returned as an array; dynamic preload is returned as \"all\"."
735 + },
736 + "connected_accounts": {
737 + "type": "object",
738 + "additionalProperties": {
739 + "type": "array",
740 + "items": {
741 + "type": "string",
742 + "format": "connectedAccountId"
743 + },
744 + "minItems": 1
745 + },
746 + "description": "Per-toolkit connected account overrides (array of nano-IDs). Multi-account sessions can pin more than one account per toolkit; otherwise length is 1."
747 + },
748 + "search": {
749 + "type": "object",
750 + "properties": {
751 + "enable": {
752 + "type": "boolean",
753 + "default": true
754 + }
755 + },
756 + "description": "Search helper configuration"
757 + },
758 + "execute": {
759 + "type": "object",
760 + "properties": {
761 + "enable_multi_execute": {
762 + "type": "boolean",
763 + "default": true
764 + }
765 + },
766 + "description": "Execute helper configuration"
767 + }
768 + },
769 + "required": [
770 + "user_id",
771 + "preload",
772 + "search",
773 + "execute"
774 + ],
775 + "description": "The session configuration at this version"
776 + },
777 + "is_current": {
778 + "type": "boolean",
779 + "description": "True only for the live (current) session config, present on the first page. False for archived history rows."
780 + }
781 + },
782 + "required": [
783 + "version",
784 + "created_at",
785 + "config",
786 + "is_current"
787 + ]
788 + }
789 + },
790 + "next_cursor": {
791 + "type": "string",
792 + "nullable": true
793 + },
794 + "total_pages": {
795 + "type": "number"
796 + },
797 + "current_page": {
798 + "type": "number"
799 + },
800 + "total_items": {
801 + "type": "number"
802 + }
803 + },
804 + "required": [
805 + "items",
806 + "total_pages",
807 + "current_page",
808 + "total_items"
809 + ]
810 + },
811 "PatchConnectedAccountBody": {
812 "type": "object",
813 "properties": {
@@ -786,14 +1143,14 @@
1143 "parameters": {}
1144 },
1145 "paths": {
789 - "/api/v3.1/logs/tool_execution": {
790 - "post": {
791 - "summary": "Search and retrieve tool execution logs",
792 - "description": "Search and retrieve tool execution logs with filtering, pagination, and time range support.",
1146 + "/api/v3.1/consumer/connected_accounts/{nanoid}/permissions": {
1147 + "get": {
1148 + "summary": "Get consumer tool permissions for a connected account",
1149 + "description": "Returns durable Enhanced Control per-tool permission rows for a connected account.",
1150 "tags": [
794 - "Logs"
1151 + "Consumer"
1152 ],
796 - "operationId": "postLogsToolExecution",
1153 + "operationId": "getConsumerConnectedAccountsByNanoidPermissions",
1154 "security": [
1155 {
1156 "ApiKeyAuth": []
@@ -802,94 +1159,28 @@
1159 "UserApiKeyAuth": []
1160 }
1161 ],
805 - "requestBody": {
806 - "content": {
807 - "application/json": {
808 - "schema": {
809 - "type": "object",
810 - "properties": {
811 - "limit": {
812 - "type": "number",
813 - "minimum": 1,
814 - "maximum": 100,
815 - "default": 20
816 - },
817 - "cursor": {
818 - "type": "string",
819 - "nullable": true
820 - },
821 - "filters": {
822 - "type": "array",
823 - "items": {
824 - "type": "object",
825 - "properties": {
826 - "field": {
827 - "type": "string",
828 - "enum": [
829 - "tool_slug",
830 - "toolkit_slug",
831 - "connected_account_id",
832 - "auth_config_id",
833 - "status",
834 - "user_id",
835 - "session_id",
836 - "sandbox_id",
837 - "request_id",
838 - "log_id"
839 - ]
840 - },
841 - "operator": {
842 - "type": "string",
843 - "enum": [
844 - "==",
845 - "!=",
846 - "contains",
847 - "not_contains"
848 - ]
849 - },
850 - "value": {
851 - "type": "string"
852 - }
853 - },
854 - "required": [
855 - "field",
856 - "operator",
857 - "value"
858 - ]
859 - },
860 - "default": []
861 - },
862 - "time_range": {
863 - "type": "object",
864 - "properties": {
865 - "from": {
866 - "type": "number",
867 - "description": "Start time in epoch milliseconds"
868 - },
869 - "to": {
870 - "type": "number",
871 - "description": "End time in epoch milliseconds"
872 - }
873 - },
874 - "required": [
875 - "from",
876 - "to"
877 - ]
878 - }
879 - }
880 - }
881 - }
1162 + "parameters": [
1163 + {
1164 + "schema": {
1165 + "type": "string",
1166 + "format": "connectedAccountId"
1167 + },
1168 + "required": true,
1169 + "description": "Connected account nano ID.",
1170 + "example": "ca_1a2b3c4d5e6f",
1171 + "name": "nanoid",
1172 + "in": "path"
1173 }
883 - },
1174 + ],
1175 "responses": {
1176 "200": {
886 - "description": "Successfully retrieved tool logs",
1177 + "description": "Connected account tool permissions retrieved successfully.",
1178 "content": {
1179 "application/json": {
1180 "schema": {
1181 "type": "object",
1182 "properties": {
892 - "logs": {
1183 + "permissions": {
1184 "type": "array",
1185 "items": {
1186 "type": "object",
@@ -897,85 +1188,79 @@
1188 "id": {
1189 "type": "string"
1190 },
900 - "timestamp": {
901 - "type": "string",
902 - "format": "date-time",
903 - "description": "ISO 8601 timestamp"
1191 + "connected_account_id": {
1192 + "type": "string"
1193 },
905 - "type": {
1194 + "tool_slug": {
1195 + "type": "string"
1196 + },
1197 + "toolkit_slug": {
1198 "type": "string",
907 - "description": "Log event type, e.g. tool.execution, trigger.message, connected_account.created"
1199 + "description": "Normalized toolkit slug that owns this tool permission. Use this to group permissions by app/toolkit, for example `gmail` or `slack`."
1200 },
909 - "status": {
1201 + "risk_group": {
1202 "type": "string",
1203 "enum": [
912 - "success",
913 - "failed"
1204 + "read",
1205 + "write",
1206 + "destructive"
1207 ]
1208 },
916 - "level": {
1209 + "state": {
1210 "type": "string",
1211 "enum": [
919 - "info",
920 - "error",
921 - "warn"
1212 + "always_allow",
1213 + "always_deny",
1214 + "ask_once",
1215 + "ask_always"
1216 ]
1217 },
924 - "message": {
925 - "type": "string"
1218 + "source": {
1219 + "type": "string",
1220 + "enum": [
1221 + "initial_connect",
1222 + "settings",
1223 + "elicitation",
1224 + "migration"
1225 + ]
1226 },
927 - "metadata": {
928 - "type": "object",
929 - "additionalProperties": {}
1227 + "permission_config_version": {
1228 + "type": "string",
1229 + "nullable": true
1230 },
931 - "metrics": {
932 - "type": "object",
933 - "additionalProperties": {}
1231 + "created_at": {
1232 + "type": "string",
1233 + "format": "date-time"
1234 },
935 - "parent": {
936 - "type": "object",
937 - "nullable": true,
938 - "properties": {
939 - "log_id": {
940 - "type": "string"
941 - },
942 - "tool_slug": {
943 - "type": "string"
944 - }
945 - },
946 - "required": [
947 - "log_id",
948 - "tool_slug"
949 - ]
1235 + "updated_at": {
1236 + "type": "string",
1237 + "format": "date-time"
1238 }
1239 },
1240 "required": [
1241 "id",
954 - "timestamp",
955 - "type",
956 - "status",
957 - "level",
958 - "metadata",
959 - "metrics",
960 - "parent"
1242 + "connected_account_id",
1243 + "tool_slug",
1244 + "toolkit_slug",
1245 + "risk_group",
1246 + "state",
1247 + "source",
1248 + "permission_config_version",
1249 + "created_at",
1250 + "updated_at"
1251 ]
1252 }
963 - },
964 - "next_cursor": {
965 - "type": "string",
966 - "nullable": true
1253 }
1254 },
1255 "required": [
970 - "logs",
971 - "next_cursor"
1256 + "permissions"
1257 ]
1258 }
1259 }
1260 }
1261 },
1262 "400": {
978 - "description": "Bad request",
1263 + "description": "Bad request.",
1264 "content": {
1265 "application/json": {
1266 "schema": {
@@ -985,7 +1270,27 @@
1270 }
1271 },
1272 "401": {
988 - "description": "Unauthorized",
1273 + "description": "Unauthorized.",
1274 + "content": {
1275 + "application/json": {
1276 + "schema": {
1277 + "$ref": "#/components/schemas/Error"
1278 + }
1279 + }
1280 + }
1281 + },
1282 + "403": {
1283 + "description": "Forbidden.",
1284 + "content": {
1285 + "application/json": {
1286 + "schema": {
1287 + "$ref": "#/components/schemas/Error"
1288 + }
1289 + }
1290 + }
1291 + },
1292 + "404": {
1293 + "description": "Connected account not found.",
1294 "content": {
1295 "application/json": {
1296 "schema": {
@@ -995,7 +1300,7 @@
1300 }
1301 },
1302 "500": {
998 - "description": "Internal server error",
1303 + "description": "Internal server error.",
1304 "content": {
1305 "application/json": {
1306 "schema": {
@@ -1006,16 +1311,14 @@
1311 }
1312 },
1313 "x-api-version": "3.1"
1009 - }
1010 - },
1011 - "/api/v3.1/logs/tool_execution/{id}": {
1012 - "get": {
1013 - "summary": "Get log details by ID",
1014 - "description": "Retrieve detailed log information by log ID.",
1314 + },
1315 + "patch": {
1316 + "summary": "Upsert consumer tool permissions for a connected account",
1317 + "description": "Upserts durable Enhanced Control per-tool permission rows for a connected account. This is a scaffolded write path for initial connect/settings flows.",
1318 "tags": [
1016 - "Logs"
1319 + "Consumer"
1320 ],
1018 - "operationId": "getLogsToolExecutionById",
1321 + "operationId": "patchConsumerConnectedAccountsByNanoidPermissions",
1322 "security": [
1323 {
1324 "ApiKeyAuth": []
@@ -1028,145 +1331,174 @@
1331 {
1332 "schema": {
1333 "type": "string",
1031 - "description": "The log ID"
1334 + "format": "connectedAccountId"
1335 },
1336 "required": true,
1034 - "description": "The log ID",
1035 - "name": "id",
1337 + "description": "Connected account nano ID.",
1338 + "example": "ca_1a2b3c4d5e6f",
1339 + "name": "nanoid",
1340 "in": "path"
1341 }
1342 ],
1343 + "requestBody": {
1344 + "content": {
1345 + "application/json": {
1346 + "schema": {
1347 + "type": "object",
1348 + "properties": {
1349 + "permissions": {
1350 + "type": "array",
1351 + "items": {
1352 + "type": "object",
1353 + "properties": {
1354 + "tool_slug": {
1355 + "type": "string",
1356 + "minLength": 1
1357 + },
1358 + "toolkit_slug": {
1359 + "type": "string",
1360 + "minLength": 1,
1361 + "description": "Toolkit slug that owns this tool permission. Use this to group and query connected-account permissions by app/toolkit, for example `gmail` or `slack`."
1362 + },
1363 + "risk_group": {
1364 + "type": "string",
1365 + "enum": [
1366 + "read",
1367 + "write",
1368 + "destructive"
1369 + ]
1370 + },
1371 + "state": {
1372 + "type": "string",
1373 + "enum": [
1374 + "always_allow",
1375 + "always_deny",
1376 + "ask_once",
1377 + "ask_always"
1378 + ]
1379 + },
1380 + "source": {
1381 + "type": "string",
1382 + "enum": [
1383 + "initial_connect",
1384 + "settings",
1385 + "elicitation",
1386 + "migration"
1387 + ],
1388 + "default": "settings"
1389 + },
1390 + "permission_config_version": {
1391 + "type": "string",
1392 + "minLength": 1
1393 + }
1394 + },
1395 + "required": [
1396 + "tool_slug",
1397 + "toolkit_slug",
1398 + "risk_group",
1399 + "state"
1400 + ]
1401 + },
1402 + "minItems": 1,
1403 + "description": "Tool permission rows to upsert for this connected account."
1404 + }
1405 + },
1406 + "required": [
1407 + "permissions"
1408 + ]
1409 + }
1410 + }
1411 + }
1412 + },
1413 "responses": {
1414 "200": {
1041 - "description": "Successfully retrieved log details",
1415 + "description": "Connected account tool permissions updated successfully.",
1416 "content": {
1417 "application/json": {
1418 "schema": {
1419 "type": "object",
1420 "properties": {
1047 - "id": {
1048 - "type": "string"
1049 - },
1050 - "timestamp": {
1051 - "type": "string",
1052 - "format": "date-time",
1053 - "description": "ISO 8601 timestamp"
1054 - },
1055 - "type": {
1056 - "type": "string",
1057 - "description": "Log event type, e.g. tool.execution, trigger.message, connected_account.created"
1058 - },
1059 - "status": {
1060 - "type": "string",
1061 - "enum": [
1062 - "success",
1063 - "failed"
1064 - ]
1065 - },
1066 - "level": {
1067 - "type": "string",
1068 - "enum": [
1069 - "info",
1070 - "error",
1071 - "warn"
1072 - ]
1073 - },
1074 - "message": {
1075 - "type": "string"
1076 - },
1077 - "metadata": {
1078 - "type": "object",
1079 - "additionalProperties": {}
1080 - },
1081 - "metrics": {
1082 - "type": "object",
1083 - "additionalProperties": {}
1084 - },
1085 - "parent": {
1086 - "type": "object",
1087 - "nullable": true,
1088 - "properties": {
1089 - "log_id": {
1090 - "type": "string"
1091 - },
1092 - "tool_slug": {
1093 - "type": "string"
1094 - }
1095 - },
1096 - "required": [
1097 - "log_id",
1098 - "tool_slug"
1099 - ]
1100 - },
1101 - "timings": {
1102 - "type": "object",
1103 - "properties": {
1104 - "start_time": {
1105 - "type": "number",
1106 - "description": "Epoch milliseconds"
1107 - },
1108 - "end_time": {
1109 - "type": "number",
1110 - "description": "Epoch milliseconds"
1111 - }
1112 - },
1113 - "required": [
1114 - "start_time",
1115 - "end_time"
1116 - ]
1117 - },
1118 - "context": {
1119 - "type": "object",
1120 - "properties": {
1121 - "session_id": {
1122 - "type": "string"
1123 - },
1124 - "trace_id": {
1125 - "type": "string"
1126 - },
1127 - "request_id": {
1128 - "type": "string"
1129 - }
1130 - }
1131 - },
1132 - "source": {
1133 - "type": "object",
1134 - "properties": {
1135 - "host": {
1136 - "type": "string"
1137 - },
1138 - "framework": {
1139 - "type": "string"
1421 + "permissions": {
1422 + "type": "array",
1423 + "items": {
1424 + "type": "object",
1425 + "properties": {
1426 + "id": {
1427 + "type": "string"
1428 + },
1429 + "connected_account_id": {
1430 + "type": "string"
1431 + },
1432 + "tool_slug": {
1433 + "type": "string"
1434 + },
1435 + "toolkit_slug": {
1436 + "type": "string",
1437 + "description": "Normalized toolkit slug that owns this tool permission. Use this to group permissions by app/toolkit, for example `gmail` or `slack`."
1438 + },
1439 + "risk_group": {
1440 + "type": "string",
1441 + "enum": [
1442 + "read",
1443 + "write",
1444 + "destructive"
1445 + ]
1446 + },
1447 + "state": {
1448 + "type": "string",
1449 + "enum": [
1450 + "always_allow",
1451 + "always_deny",
1452 + "ask_once",
1453 + "ask_always"
1454 + ]
1455 + },
1456 + "source": {
1457 + "type": "string",
1458 + "enum": [
1459 + "initial_connect",
1460 + "settings",
1461 + "elicitation",
1462 + "migration"
1463 + ]
1464 + },
1465 + "permission_config_version": {
1466 + "type": "string",
1467 + "nullable": true
1468 + },
1469 + "created_at": {
1470 + "type": "string",
1471 + "format": "date-time"
1472 + },
1473 + "updated_at": {
1474 + "type": "string",
1475 + "format": "date-time"
1476 + }
1477 },
1141 - "language": {
1142 - "type": "string"
1143 - }
1478 + "required": [
1479 + "id",
1480 + "connected_account_id",
1481 + "tool_slug",
1482 + "toolkit_slug",
1483 + "risk_group",
1484 + "state",
1485 + "source",
1486 + "permission_config_version",
1487 + "created_at",
1488 + "updated_at"
1489 + ]
1490 }
1145 - },
1146 - "data": {
1147 - "type": "object",
1148 - "additionalProperties": {}
1491 }
1492 },
1493 "required": [
1152 - "id",
1153 - "timestamp",
1154 - "type",
1155 - "status",
1156 - "level",
1157 - "metadata",
1158 - "metrics",
1159 - "parent",
1160 - "context",
1161 - "source",
1162 - "data"
1494 + "permissions"
1495 ]
1496 }
1497 }
1498 }
1499 },
1500 "400": {
1169 - "description": "Bad request",
1501 + "description": "Bad request.",
1502 "content": {
1503 "application/json": {
1504 "schema": {
@@ -1176,7 +1508,17 @@
1508 }
1509 },
1510 "401": {
1179 - "description": "Unauthorized",
1511 + "description": "Unauthorized.",
1512 + "content": {
1513 + "application/json": {
1514 + "schema": {
1515 + "$ref": "#/components/schemas/Error"
1516 + }
1517 + }
1518 + }
1519 + },
1520 + "403": {
1521 + "description": "Forbidden.",
1522 "content": {
1523 "application/json": {
1524 "schema": {
@@ -1186,7 +1528,7 @@
1528 }
1529 },
1530 "404": {
1189 - "description": "Log not found",
1531 + "description": "Connected account not found.",
1532 "content": {
1533 "application/json": {
1534 "schema": {
@@ -1196,7 +1538,7 @@
1538 }
1539 },
1540 "500": {
1199 - "description": "Internal server error",
1541 + "description": "Internal server error.",
1542 "content": {
1543 "application/json": {
1544 "schema": {
@@ -1209,14 +1551,14 @@
1551 "x-api-version": "3.1"
1552 }
1553 },
1212 - "/api/v3.1/tools": {
1213 - "get": {
1214 - "summary": "List available tools",
1215 - "description": "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.",
1554 + "/api/v3.1/consumer/connected_accounts/{nanoid}/permissions/tools/{tool_slug}": {
1555 + "patch": {
1556 + "summary": "Upsert one consumer tool permission for a connected account",
1557 + "description": "Upserts a single durable Enhanced Control permission row for a connected account/tool pair.",
1558 "tags": [
1217 - "Tools"
1559 + "Consumer"
1560 ],
1219 - "operationId": "getTools",
1561 + "operationId": "patchConsumerConnectedAccountsByNanoidPermissionsToolsByToolSlug",
1562 "security": [
1563 {
1564 "ApiKeyAuth": []
@@ -1228,179 +1570,165 @@
1570 "parameters": [
1571 {
1572 "schema": {
1231 - "type": "string"
1232 - },
1233 - "required": false,
1234 - "description": "The slug of the toolkit to filter by",
1235 - "in": "query",
1236 - "name": "toolkit_slug"
1237 - },
1238 - {
1239 - "schema": {
1240 - "type": "string"
1241 - },
1242 - "required": false,
1243 - "description": "Comma-separated list of specific tool slugs to retrieve (overrides other filters)",
1244 - "in": "query",
1245 - "name": "tool_slugs"
1246 - },
1247 - {
1248 - "schema": {
1249 - "oneOf": [
1250 - {
1251 - "type": "string"
1252 - },
1253 - {
1254 - "type": "array",
1255 - "items": {
1256 - "type": "string"
1257 - }
1258 - }
1259 - ]
1573 + "type": "string",
1574 + "format": "connectedAccountId"
1575 },
1261 - "required": false,
1262 - "description": "Comma-separated list of auth config IDs to filter tools by",
1263 - "in": "query",
1264 - "name": "auth_config_ids"
1576 + "required": true,
1577 + "description": "Connected account nano ID.",
1578 + "example": "ca_1a2b3c4d5e6f",
1579 + "name": "nanoid",
1580 + "in": "path"
1581 },
1582 {
1583 "schema": {
1584 "type": "string",
1269 - "enum": [
1270 - "true",
1271 - "false"
1272 - ]
1585 + "minLength": 1
1586 },
1274 - "required": false,
1275 - "description": "Filter to only show important/featured tools (set to \"true\" to enable)",
1276 - "in": "query",
1277 - "name": "important"
1278 - },
1279 - {
1280 - "schema": {
1281 - "type": "array",
1282 - "items": {
1283 - "type": "string"
1284 - }
1285 - },
1286 - "required": false,
1287 - "description": "Filter tools by one or more tags (can be specified multiple times)",
1288 - "in": "query",
1289 - "name": "tags"
1290 - },
1291 - {
1292 - "schema": {
1293 - "type": "array",
1294 - "nullable": true,
1295 - "items": {
1296 - "type": "string"
1297 - },
1298 - "description": "Filter tools by one or more scopes (can be specified multiple times)"
1299 - },
1300 - "required": false,
1301 - "description": "Array of scopes to filter tools by)",
1302 - "name": "scopes",
1303 - "in": "query"
1304 - },
1305 - {
1306 - "schema": {
1307 - "type": "string"
1308 - },
1309 - "required": false,
1310 - "description": "Full-text search query to filter tools by name, slug, or description. Applied as a soft filter on top of other filters.",
1311 - "in": "query",
1312 - "name": "query"
1313 - },
1314 - {
1315 - "schema": {
1316 - "type": "string"
1317 - },
1318 - "required": false,
1319 - "description": "Deprecated: use \"query\" instead. Free-text search query to find tools by name, description, or functionality.",
1320 - "in": "query",
1321 - "name": "search",
1322 - "deprecated": true
1323 - },
1324 - {
1325 - "schema": {
1326 - "type": "boolean",
1327 - "default": true
1328 - },
1329 - "required": false,
1330 - "description": "Include deprecated tools in the response",
1331 - "in": "query",
1332 - "name": "include_deprecated"
1333 - },
1334 - {
1335 - "schema": {
1336 - "oneOf": [
1337 - {
1338 - "type": "null"
1339 - },
1340 - {
1341 - "type": "string"
1342 - },
1343 - {
1344 - "type": "object",
1345 - "additionalProperties": {
1346 - "type": "string"
1347 - },
1348 - "description": "Object representation of parsed bracket notation"
1349 - }
1350 - ]
1351 - },
1352 - "required": false,
1353 - "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",
1354 - "in": "query",
1355 - "name": "toolkit_versions",
1356 - "examples": {
1357 - "latest_version": {
1358 - "summary": "Latest version for all toolkits",
1359 - "value": "latest"
1360 - },
1361 - "bracket_notation": {
1362 - "summary": "Specific versions using bracket notation",
1363 - "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"
1364 - },
1365 - "null_value": {
1366 - "summary": "No version specified (uses 00000000_00)",
1367 - "value": null
1587 + "required": true,
1588 + "description": "Tool slug to update.",
1589 + "example": "GMAIL_SEND_EMAIL",
1590 + "name": "tool_slug",
1591 + "in": "path"
1592 + }
1593 + ],
1594 + "requestBody": {
1595 + "content": {
1596 + "application/json": {
1597 + "schema": {
1598 + "type": "object",
1599 + "properties": {
1600 + "toolkit_slug": {
1601 + "type": "string",
1602 + "minLength": 1,
1603 + "description": "Toolkit slug that owns this tool permission. Use this to group and query connected-account permissions by app/toolkit, for example `gmail` or `slack`."
1604 + },
1605 + "risk_group": {
1606 + "type": "string",
1607 + "enum": [
1608 + "read",
1609 + "write",
1610 + "destructive"
1611 + ]
1612 + },
1613 + "state": {
1614 + "type": "string",
1615 + "enum": [
1616 + "always_allow",
1617 + "always_deny",
1618 + "ask_once",
1619 + "ask_always"
1620 + ]
1621 + },
1622 + "source": {
1623 + "type": "string",
1624 + "enum": [
1625 + "initial_connect",
1626 + "settings",
1627 + "elicitation",
1628 + "migration"
1629 + ],
1630 + "default": "settings"
1631 + },
1632 + "permission_config_version": {
1633 + "type": "string",
1634 + "minLength": 1
1635 + }
1636 + },
1637 + "required": [
1638 + "toolkit_slug",
1639 + "risk_group",
1640 + "state"
1641 + ]
1642 }
1643 }
1370 - },
1371 - {
1372 - "schema": {
1373 - "type": "number",
1374 - "nullable": true
1375 - },
1376 - "required": false,
1377 - "description": "Number of items per page, max allowed is 1000",
1378 - "name": "limit",
1379 - "in": "query"
1380 - },
1381 - {
1382 - "schema": {
1383 - "type": "string"
1384 - },
1385 - "required": false,
1386 - "description": "Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.",
1387 - "name": "cursor",
1388 - "in": "query"
1644 }
1390 - ],
1645 + },
1646 "responses": {
1647 "200": {
1393 - "description": "Successfully retrieved tools list with pagination information",
1648 + "description": "Connected account tool permission updated successfully.",
1649 "content": {
1650 "application/json": {
1651 "schema": {
1397 - "$ref": "#/components/schemas/ToolsPaginated"
1652 + "type": "object",
1653 + "properties": {
1654 + "permission": {
1655 + "type": "object",
1656 + "properties": {
1657 + "id": {
1658 + "type": "string"
1659 + },
1660 + "connected_account_id": {
1661 + "type": "string"
1662 + },
1663 + "tool_slug": {
1664 + "type": "string"
1665 + },
1666 + "toolkit_slug": {
1667 + "type": "string",
1668 + "description": "Normalized toolkit slug that owns this tool permission. Use this to group permissions by app/toolkit, for example `gmail` or `slack`."
1669 + },
1670 + "risk_group": {
1671 + "type": "string",
1672 + "enum": [
1673 + "read",
1674 + "write",
1675 + "destructive"
1676 + ]
1677 + },
1678 + "state": {
1679 + "type": "string",
1680 + "enum": [
1681 + "always_allow",
1682 + "always_deny",
1683 + "ask_once",
1684 + "ask_always"
1685 + ]
1686 + },
1687 + "source": {
1688 + "type": "string",
1689 + "enum": [
1690 + "initial_connect",
1691 + "settings",
1692 + "elicitation",
1693 + "migration"
1694 + ]
1695 + },
1696 + "permission_config_version": {
1697 + "type": "string",
1698 + "nullable": true
1699 + },
1700 + "created_at": {
1701 + "type": "string",
1702 + "format": "date-time"
1703 + },
1704 + "updated_at": {
1705 + "type": "string",
1706 + "format": "date-time"
1707 + }
1708 + },
1709 + "required": [
1710 + "id",
1711 + "connected_account_id",
1712 + "tool_slug",
1713 + "toolkit_slug",
1714 + "risk_group",
1715 + "state",
1716 + "source",
1717 + "permission_config_version",
1718 + "created_at",
1719 + "updated_at"
1720 + ]
1721 + }
1722 + },
1723 + "required": [
1724 + "permission"
1725 + ]
1726 }
1727 }
1728 }
1729 },
1730 "400": {
1403 - "description": "Bad request - Invalid query parameters",
1731 + "description": "Bad request.",
1732 "content": {
1733 "application/json": {
1734 "schema": {
@@ -1410,7 +1738,7 @@
1738 }
1739 },
1740 "401": {
1413 - "description": "Unauthorized - Authentication credentials are missing or invalid",
1741 + "description": "Unauthorized.",
1742 "content": {
1743 "application/json": {
1744 "schema": {
@@ -1420,7 +1748,7 @@
1748 }
1749 },
1750 "403": {
1423 - "description": "Forbidden - User does not have permission to access tools",
1751 + "description": "Forbidden.",
1752 "content": {
1753 "application/json": {
1754 "schema": {
@@ -1430,17 +1758,7 @@
1758 }
1759 },
1760 "404": {
1433 - "description": "Not found - The requested resource was not found",
1434 - "content": {
1435 - "application/json": {
1436 - "schema": {
1437 - "$ref": "#/components/schemas/Error"
1438 - }
1439 - }
1440 - }
1441 - },
1442 - "429": {
1443 - "description": "Too many requests - Rate limit exceeded",
1761 + "description": "Connected account not found.",
1762 "content": {
1763 "application/json": {
1764 "schema": {
@@ -1450,7 +1768,7 @@
1768 }
1769 },
1770 "500": {
1453 - "description": "Internal server error - Something went wrong on the server",
1771 + "description": "Internal server error.",
1772 "content": {
1773 "application/json": {
1774 "schema": {
@@ -1463,39 +1781,157 @@
1781 "x-api-version": "3.1"
1782 }
1783 },
1466 - "/api/v3.1/tools/enum": {
1467 - "get": {
1468 - "summary": "Get tool enum list",
1469 - "description": "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.",
1784 + "/api/v3.1/consumer/permissions/resolve": {
1785 + "post": {
1786 + "summary": "Resolve consumer tool-router permissions",
1787 + "description": "Resolves durable connected-account tool permissions into the landed tool-router experimental.permissions config so consumer flows can pass it directly when creating a tool-router session. In addition to existing auth methods, server-side callers may use admin auth with org_member_id/project_id/org_id query params to derive the project user context.",
1788 "tags": [
1471 - "Tools"
1789 + "Consumer"
1790 ],
1473 - "operationId": "getToolsEnum",
1791 + "operationId": "postConsumerPermissionsResolve",
1792 "security": [
1793 {
1794 "ApiKeyAuth": []
1795 },
1796 {
1797 "UserApiKeyAuth": []
1798 + },
1799 + {
1800 + "admin": []
1801 + }
1802 + ],
1803 + "parameters": [
1804 + {
1805 + "schema": {
1806 + "type": "string",
1807 + "format": "uuid",
1808 + "description": "Org member/user UUID used with admin auth."
1809 + },
1810 + "required": false,
1811 + "description": "Org member/user UUID used with admin auth.",
1812 + "name": "org_member_id",
1813 + "in": "query"
1814 + },
1815 + {
1816 + "schema": {
1817 + "type": "string",
1818 + "format": "projectId",
1819 + "description": "Project nano ID used with admin auth."
1820 + },
1821 + "required": false,
1822 + "description": "Project nano ID used with admin auth.",
1823 + "name": "project_id",
1824 + "in": "query"
1825 + },
1826 + {
1827 + "schema": {
1828 + "type": "string",
1829 + "format": "orgId",
1830 + "description": "Org nano ID used with admin auth."
1831 + },
1832 + "required": false,
1833 + "description": "Org nano ID used with admin auth.",
1834 + "name": "org_id",
1835 + "in": "query"
1836 }
1837 ],
1838 + "requestBody": {
1839 + "content": {
1840 + "application/json": {
1841 + "schema": {
1842 + "type": "object",
1843 + "properties": {
1844 + "connected_account_ids": {
1845 + "type": "array",
1846 + "items": {
1847 + "type": "string",
1848 + "format": "connectedAccountId"
1849 + },
1850 + "description": "Connected account nano IDs to include in resolution."
1851 + },
1852 + "connected_accounts": {
1853 + "type": "object",
1854 + "additionalProperties": {
1855 + "type": "array",
1856 + "items": {
1857 + "type": "string",
1858 + "format": "connectedAccountId"
1859 + },
1860 + "minItems": 1
1861 + },
1862 + "description": "Optional toolkit_slug -> connected account nano ID array map. Values are flattened and merged with connected_account_ids."
1863 + },
1864 + "default": {
1865 + "type": "string",
1866 + "enum": [
1867 + "allow_all",
1868 + "ask_every_call",
1869 + "ask_once_per_session"
1870 + ],
1871 + "description": "Optional default mode to include in the resolved tool-router permissions config.",
1872 + "x-experimental": true
1873 + }
1874 + }
1875 + }
1876 + }
1877 + }
1878 + },
1879 "responses": {
1880 "200": {
1484 - "description": "Successfully retrieved tool enum list",
1881 + "description": "Consumer permissions resolved successfully.",
1882 "content": {
1883 "application/json": {
1884 "schema": {
1488 - "type": "array",
1489 - "items": {
1490 - "type": "string"
1885 + "type": "object",
1886 + "properties": {
1887 + "experimental": {
1888 + "type": "object",
1889 + "properties": {
1890 + "permissions": {
1891 + "type": "object",
1892 + "properties": {
1893 + "default": {
1894 + "type": "string",
1895 + "enum": [
1896 + "allow_all",
1897 + "ask_every_call",
1898 + "ask_once_per_session"
1899 + ],
1900 + "description": "Default elicitation behavior when no override matches. `allow_all` runs every tool without prompting; `ask_every_call` prompts on each invocation; `ask_once_per_session` prompts once and remembers the answer for the rest of the session."
1901 + },
1902 + "overrides": {
1903 + "type": "object",
1904 + "additionalProperties": {
1905 + "type": "string",
1906 + "enum": [
1907 + "always_allow",
1908 + "always_deny",
1909 + "ask_once",
1910 + "ask_always"
1911 + ]
1912 + },
1913 + "description": "Per-tool overrides keyed by `${toolSlug}:${connectedAccountId ?? \"__none__\"}`, plus account-wide overrides keyed by `*:${connectedAccountId ?? \"__none__\"}`. Exact tool overrides take precedence over account-wide overrides. `always_allow` skips the prompt and runs the tool; `always_deny` blocks the tool; `ask_once` prompts once per session (allow/deny) and remembers; `ask_always` prompts on every call with allow-once/allow-session/deny, ignoring any cached session allow. Overrides take precedence over `default`."
1914 + }
1915 + },
1916 + "required": [
1917 + "default"
1918 + ]
1919 + }
1920 + },
1921 + "required": [
1922 + "permissions"
1923 + ]
1924 + }
1925 },
1492 - "description": "JSON string containing all tool enum values from latest version of each toolkit"
1926 + "required": [
1927 + "experimental"
1928 + ]
1929 }
1930 }
1931 }
1932 },
1933 "400": {
1498 - "description": "Bad request - Invalid request parameters",
1934 + "description": "Bad request.",
1935 "content": {
1936 "application/json": {
1937 "schema": {
@@ -1505,7 +1941,7 @@
1941 }
1942 },
1943 "401": {
1508 - "description": "Unauthorized - Authentication credentials are missing or invalid",
1944 + "description": "Unauthorized.",
1945 "content": {
1946 "application/json": {
1947 "schema": {
@@ -1515,7 +1951,7 @@
1951 }
1952 },
1953 "403": {
1518 - "description": "Forbidden - User does not have permission to access tool enums",
1954 + "description": "Forbidden.",
1955 "content": {
1956 "application/json": {
1957 "schema": {
@@ -1525,7 +1961,7 @@
1961 }
1962 },
1963 "404": {
1528 - "description": "Not found - Tool enum list not found",
1964 + "description": "Connected account not found.",
1965 "content": {
1966 "application/json": {
1967 "schema": {
@@ -1535,7 +1971,7 @@
1971 }
1972 },
1973 "500": {
1538 - "description": "Internal server error - Something went wrong on the server",
1974 + "description": "Internal server error.",
1975 "content": {
1976 "application/json": {
1977 "schema": {
@@ -1548,14 +1984,14 @@
1984 "x-api-version": "3.1"
1985 }
1986 },
1551 - "/api/v3.1/tools/{tool_slug}": {
1552 - "get": {
1553 - "summary": "Get tool by slug",
1554 - "description": "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.",
1987 + "/api/v3.1/logs/tool_execution": {
1988 + "post": {
1989 + "summary": "Search and retrieve tool execution logs",
1990 + "description": "Search and retrieve tool execution logs with filtering, pagination, and time range support.",
1991 "tags": [
1556 - "Tools"
1992 + "Logs"
1993 ],
1558 - "operationId": "getToolsByToolSlug",
1994 + "operationId": "postLogsToolExecution",
1995 "security": [
1996 {
1997 "ApiKeyAuth": []
@@ -1564,76 +2000,180 @@
2000 "UserApiKeyAuth": []
2001 }
2002 ],
1567 - "parameters": [
1568 - {
1569 - "schema": {
1570 - "type": "string"
1571 - },
1572 - "required": true,
1573 - "description": "The unique slug identifier of the tool",
1574 - "name": "tool_slug",
1575 - "in": "path"
1576 - },
1577 - {
1578 - "schema": {
1579 - "type": "string"
1580 - },
1581 - "required": false,
1582 - "description": "Optional version of the tool to retrieve",
1583 - "name": "version",
1584 - "in": "query"
1585 - },
1586 - {
1587 - "schema": {
1588 - "oneOf": [
1589 - {
1590 - "type": "null"
1591 - },
1592 - {
1593 - "type": "string"
1594 - },
1595 - {
1596 - "type": "object",
1597 - "additionalProperties": {
1598 - "type": "string"
2003 + "requestBody": {
2004 + "content": {
2005 + "application/json": {
2006 + "schema": {
2007 + "type": "object",
2008 + "properties": {
2009 + "limit": {
2010 + "type": "number",
2011 + "minimum": 1,
2012 + "maximum": 100,
2013 + "default": 20
2014 },
1600 - "description": "Object representation of parsed bracket notation"
2015 + "cursor": {
2016 + "type": "string",
2017 + "nullable": true
2018 + },
2019 + "filters": {
2020 + "type": "array",
2021 + "items": {
2022 + "type": "object",
2023 + "properties": {
2024 + "field": {
2025 + "type": "string",
2026 + "enum": [
2027 + "tool_slug",
2028 + "toolkit_slug",
2029 + "connected_account_id",
2030 + "auth_config_id",
2031 + "status",
2032 + "user_id",
2033 + "session_id",
2034 + "sandbox_id",
2035 + "request_id",
2036 + "log_id"
2037 + ]
2038 + },
2039 + "operator": {
2040 + "type": "string",
2041 + "enum": [
2042 + "==",
2043 + "!=",
2044 + "contains",
2045 + "not_contains"
2046 + ]
2047 + },
2048 + "value": {
2049 + "type": "string"
2050 + }
2051 + },
2052 + "required": [
2053 + "field",
2054 + "operator",
2055 + "value"
2056 + ]
2057 + },
2058 + "default": []
2059 + },
2060 + "time_range": {
2061 + "type": "object",
2062 + "properties": {
2063 + "from": {
2064 + "type": "number",
2065 + "description": "Start time in epoch milliseconds"
2066 + },
2067 + "to": {
2068 + "type": "number",
2069 + "description": "End time in epoch milliseconds"
2070 + }
2071 + },
2072 + "required": [
2073 + "from",
2074 + "to"
2075 + ]
2076 + }
2077 }
1602 - ]
1603 - },
1604 - "required": false,
1605 - "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",
1606 - "in": "query",
1607 - "name": "toolkit_versions",
1608 - "examples": {
1609 - "latest_version": {
1610 - "summary": "Latest version for all toolkits",
1611 - "value": "latest"
1612 - },
1613 - "bracket_notation": {
1614 - "summary": "Specific versions using bracket notation",
1615 - "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"
1616 - },
1617 - "null_value": {
1618 - "summary": "No version specified (uses 00000000_00)",
1619 - "value": null
2078 }
2079 }
2080 }
1623 - ],
2081 + },
2082 "responses": {
2083 "200": {
1626 - "description": "Successfully retrieved tool details",
2084 + "description": "Successfully retrieved tool logs",
2085 "content": {
2086 "application/json": {
2087 "schema": {
1630 - "$ref": "#/components/schemas/Tool"
2088 + "type": "object",
2089 + "properties": {
2090 + "logs": {
2091 + "type": "array",
2092 + "items": {
2093 + "type": "object",
2094 + "properties": {
2095 + "id": {
2096 + "type": "string"
2097 + },
2098 + "timestamp": {
2099 + "type": "string",
2100 + "format": "date-time",
2101 + "description": "ISO 8601 timestamp"
2102 + },
2103 + "type": {
2104 + "type": "string",
2105 + "description": "Log event type, e.g. tool.execution, trigger.message, connected_account.created"
2106 + },
2107 + "status": {
2108 + "type": "string",
2109 + "enum": [
2110 + "success",
2111 + "failed"
2112 + ]
2113 + },
2114 + "level": {
2115 + "type": "string",
2116 + "enum": [
2117 + "info",
2118 + "error",
2119 + "warn"
2120 + ]
2121 + },
2122 + "message": {
2123 + "type": "string"
2124 + },
2125 + "metadata": {
2126 + "type": "object",
2127 + "additionalProperties": {}
2128 + },
2129 + "metrics": {
2130 + "type": "object",
2131 + "additionalProperties": {}
2132 + },
2133 + "parent": {
2134 + "type": "object",
2135 + "nullable": true,
2136 + "properties": {
2137 + "log_id": {
2138 + "type": "string"
2139 + },
2140 + "tool_slug": {
2141 + "type": "string"
2142 + }
2143 + },
2144 + "required": [
2145 + "log_id",
2146 + "tool_slug"
2147 + ]
2148 + }
2149 + },
2150 + "required": [
2151 + "id",
2152 + "timestamp",
2153 + "type",
2154 + "status",
2155 + "level",
2156 + "metadata",
2157 + "metrics",
2158 + "parent"
2159 + ]
2160 + }
2161 + },
2162 + "next_cursor": {
2163 + "type": "string",
2164 + "nullable": true
2165 + }
2166 + },
2167 + "required": [
2168 + "logs",
2169 + "next_cursor"
2170 + ]
2171 }
2172 }
2173 }
2174 },
2175 "400": {
1636 - "description": "Bad request - Invalid tool slug format",
2176 + "description": "Bad request",
2177 "content": {
2178 "application/json": {
2179 "schema": {
@@ -1643,17 +2183,7 @@
2183 }
2184 },
2185 "401": {
1646 - "description": "Unauthorized - Authentication credentials are missing or invalid",
1647 - "content": {
1648 - "application/json": {
1649 - "schema": {
1650 - "$ref": "#/components/schemas/Error"
1651 - }
1652 - }
1653 - }
1654 - },
1655 - "404": {
1656 - "description": "Not found - Tool with the specified slug does not exist",
2186 + "description": "Unauthorized",
2187 "content": {
2188 "application/json": {
2189 "schema": {
@@ -1663,7 +2193,7 @@
2193 }
2194 },
2195 "500": {
1666 - "description": "Internal server error - Something went wrong on the server",
2196 + "description": "Internal server error",
2197 "content": {
2198 "application/json": {
2199 "schema": {
@@ -1676,14 +2206,14 @@
2206 "x-api-version": "3.1"
2207 }
2208 },
1679 - "/api/v3.1/tools/execute/{tool_slug}": {
1680 - "post": {
1681 - "summary": "Execute tool",
1682 - "description": "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.",
2209 + "/api/v3.1/logs/tool_execution/{id}": {
2210 + "get": {
2211 + "summary": "Get log details by ID",
2212 + "description": "Retrieve detailed log information by log ID.",
2213 "tags": [
1684 - "Tools"
2214 + "Logs"
2215 ],
1686 - "operationId": "postToolsExecuteByToolSlug",
2216 + "operationId": "getLogsToolExecutionById",
2217 "security": [
2218 {
2219 "ApiKeyAuth": []
@@ -1695,446 +2225,156 @@
2225 "parameters": [
2226 {
2227 "schema": {
1698 - "type": "string"
2228 + "type": "string",
2229 + "description": "The log ID"
2230 },
2231 "required": true,
1701 - "description": "The tool slug to execute",
1702 - "name": "tool_slug",
2232 + "description": "The log ID",
2233 + "name": "id",
2234 "in": "path"
1704 - },
1705 - {
1706 - "schema": {
1707 - "type": "string",
1708 - "description": "JSON object containing custom headers to pass to LLM providers (OpenAI, Bedrock, etc.)",
1709 - "example": "{\"x-custom-header\": \"value\", \"authorization\": \"Bearer token\"}"
1710 - },
1711 - "required": false,
1712 - "name": "x-llm-gateway-headers",
1713 - "in": "header"
2235 }
2236 ],
1716 - "requestBody": {
1717 - "content": {
1718 - "application/json": {
1719 - "schema": {
1720 - "type": "object",
1721 - "properties": {
1722 - "connected_account_id": {
1723 - "type": "string",
1724 - "description": "Unique identifier for the connected account to use for authentication",
1725 - "example": "ca_1a2b3c4d5e6f"
1726 - },
1727 - "entity_id": {
1728 - "type": "string",
1729 - "description": "Deprecated: please use user_id instead. Entity identifier for multi-entity connected accounts (e.g. multiple repositories, organizations)",
1730 - "example": "repo-123",
1731 - "deprecated": true
1732 - },
1733 - "user_id": {
1734 - "type": "string",
1735 - "description": "User id for multi-user connected accounts (e.g. multiple users, organizations)",
1736 - "example": "user-123"
1737 - },
1738 - "version": {
1739 - "type": "string",
1740 - "description": "Tool version to execute (defaults to \"00000000_00\" if not specified)",
1741 - "example": "latest"
1742 - },
1743 - "custom_auth_params": {
1744 - "type": "object",
1745 - "properties": {
1746 - "base_url": {
1747 - "type": "string",
1748 - "description": "The base URL (root address) what you should use while making http requests to the connected account. For example, for gmail, it would be 'https://gmail.googleapis.com'"
2237 + "responses": {
2238 + "200": {
2239 + "description": "Successfully retrieved log details",
2240 + "content": {
2241 + "application/json": {
2242 + "schema": {
2243 + "type": "object",
2244 + "properties": {
2245 + "id": {
2246 + "type": "string"
2247 + },
2248 + "timestamp": {
2249 + "type": "string",
2250 + "format": "date-time",
2251 + "description": "ISO 8601 timestamp"
2252 + },
2253 + "type": {
2254 + "type": "string",
2255 + "description": "Log event type, e.g. tool.execution, trigger.message, connected_account.created"
2256 + },
2257 + "status": {
2258 + "type": "string",
2259 + "enum": [
2260 + "success",
2261 + "failed"
2262 + ]
2263 + },
2264 + "level": {
2265 + "type": "string",
2266 + "enum": [
2267 + "info",
2268 + "error",
2269 + "warn"
2270 + ]
2271 + },
2272 + "message": {
2273 + "type": "string"
2274 + },
2275 + "metadata": {
2276 + "type": "object",
2277 + "additionalProperties": {}
2278 + },
2279 + "metrics": {
2280 + "type": "object",
2281 + "additionalProperties": {}
2282 + },
2283 + "parent": {
2284 + "type": "object",
2285 + "nullable": true,
2286 + "properties": {
2287 + "log_id": {
2288 + "type": "string"
2289 + },
2290 + "tool_slug": {
2291 + "type": "string"
2292 + }
2293 },
1750 - "parameters": {
1751 - "type": "array",
1752 - "items": {
1753 - "type": "object",
1754 - "properties": {
1755 - "name": {
1756 - "type": "string",
1757 - "description": "The name of the parameter. For example, 'x-api-key', 'Content-Type', etc."
1758 - },
1759 - "in": {
1760 - "type": "string",
1761 - "enum": [
1762 - "query",
1763 - "header"
1764 - ],
1765 - "description": "The location of the parameter. Can be 'query' or 'header'."
1766 - },
1767 - "value": {
1768 - "anyOf": [
1769 - {
1770 - "type": "string"
1771 - },
1772 - {
1773 - "type": "number"
1774 - }
1775 - ],
1776 - "description": "The value of the parameter. For example, '1234567890', 'application/json', etc."
1777 - }
1778 - },
1779 - "required": [
1780 - "name",
1781 - "in",
1782 - "value"
1783 - ]
2294 + "required": [
2295 + "log_id",
2296 + "tool_slug"
2297 + ]
2298 + },
2299 + "timings": {
2300 + "type": "object",
2301 + "properties": {
2302 + "start_time": {
2303 + "type": "number",
2304 + "description": "Epoch milliseconds"
2305 + },
2306 + "end_time": {
2307 + "type": "number",
2308 + "description": "Epoch milliseconds"
2309 }
2310 },
1786 - "body": {
1787 - "type": "object",
1788 - "additionalProperties": {},
1789 - "description": "The body to be sent to the endpoint for authentication. This is a JSON object. Note: This is very rarely needed and is only required by very few apps."
2311 + "required": [
2312 + "start_time",
2313 + "end_time"
2314 + ]
2315 + },
2316 + "context": {
2317 + "type": "object",
2318 + "properties": {
2319 + "session_id": {
2320 + "type": "string"
2321 + },
2322 + "trace_id": {
2323 + "type": "string"
2324 + },
2325 + "request_id": {
2326 + "type": "string"
2327 + }
2328 }
2329 },
1792 - "description": "Custom authentication parameters for tools that support parameterized authentication",
1793 - "example": {
1794 - "base_url": "https://api.example.com",
1795 - "parameters": [
1796 - {
1797 - "name": "x-api-key",
1798 - "value": "secret-key",
1799 - "in": "header"
2330 + "source": {
2331 + "type": "object",
2332 + "properties": {
2333 + "host": {
2334 + "type": "string"
2335 + },
2336 + "framework": {
2337 + "type": "string"
2338 + },
2339 + "language": {
2340 + "type": "string"
2341 }
1801 - ]
1802 - }
1803 - },
1804 - "custom_connection_data": {
1805 - "description": "Custom connection data for tools that support custom connection data",
1806 - "example": {
1807 - "authScheme": "OAUTH2",
1808 - "toolkitSlug": "github",
1809 - "val": {
1810 - "access_token": "secret-token"
2342 }
2343 },
1813 - "type": "object",
1814 - "properties": {
1815 - "authScheme": {
1816 - "type": "string",
1817 - "enum": [
1818 - "OAUTH2",
1819 - "DCR_OAUTH",
1820 - "API_KEY",
1821 - "BASIC_WITH_JWT",
1822 - "BASIC",
1823 - "BEARER_TOKEN",
1824 - "OAUTH1",
1825 - "NO_AUTH",
1826 - "SERVICE_ACCOUNT",
1827 - "GOOGLE_SERVICE_ACCOUNT",
1828 - "S2S_OAUTH2"
1829 - ]
1830 - },
1831 - "toolkitSlug": {
1832 - "type": "string"
1833 - },
1834 - "val": {
1835 - "type": "object",
1836 - "properties": {
1837 - "subdomain": {
1838 - "type": "string"
1839 - },
1840 - "your-domain": {
1841 - "type": "string"
1842 - },
1843 - "region": {
1844 - "type": "string"
1845 - },
1846 - "shop": {
1847 - "type": "string"
1848 - },
1849 - "account_url": {
1850 - "type": "string"
1851 - },
1852 - "COMPANYDOMAIN": {
1853 - "type": "string"
1854 - },
1855 - "extension": {
1856 - "type": "string"
1857 - },
1858 - "form_api_base_url": {
1859 - "type": "string"
1860 - },
1861 - "instanceEndpoint": {
1862 - "type": "string"
1863 - },
1864 - "api_url": {
1865 - "type": "string"
1866 - },
1867 - "borneo_dashboard_url": {
1868 - "type": "string"
1869 - },
1870 - "proxy_username": {
1871 - "type": "string"
1872 - },
1873 - "proxy_password": {
1874 - "type": "string"
1875 - },
1876 - "domain": {
1877 - "type": "string"
1878 - },
1879 - "version": {
1880 - "type": "string"
1881 - },
1882 - "dc": {
1883 - "type": "string"
1884 - },
1885 - "site_name": {
1886 - "type": "string"
1887 - },
1888 - "instanceName": {
1889 - "type": "string"
1890 - },
1891 - "account_id": {
1892 - "type": "string"
1893 - },
1894 - "your_server": {
1895 - "type": "string"
1896 - },
1897 - "server_location": {
1898 - "type": "string"
1899 - },
1900 - "base_url": {
1901 - "type": "string"
1902 - },
1903 - "state_prefix": {
1904 - "type": "string",
1905 - "maxLength": 40,
1906 - "description": "The oauth2 state prefix for the connection"
1907 - },
1908 - "long_redirect_url": {
1909 - "type": "boolean",
1910 - "description": "Whether to return the redirect url without shortening"
1911 - },
1912 - "access_token": {
1913 - "type": "string"
1914 - },
1915 - "id_token": {
1916 - "type": "string"
1917 - },
1918 - "token_type": {
1919 - "type": "string"
1920 - },
1921 - "refresh_token": {
1922 - "type": "string",
1923 - "nullable": true
1924 - },
1925 - "expires_in": {
1926 - "anyOf": [
1927 - {
1928 - "type": "number"
1929 - },
1930 - {
1931 - "type": "string"
1932 - },
1933 - {
1934 - "nullable": true,
1935 - "type": "object"
1936 - }
1937 - ]
1938 - },
1939 - "scope": {
1940 - "anyOf": [
1941 - {
1942 - "type": "string"
1943 - },
1944 - {
1945 - "type": "array",
1946 - "items": {
1947 - "type": "string"
1948 - }
1949 - },
1950 - {
1951 - "nullable": true,
1952 - "type": "object"
1953 - }
1954 - ]
1955 - },
1956 - "webhook_signature": {
1957 - "type": "string"
1958 - },
1959 - "authed_user": {
1960 - "type": "object",
1961 - "properties": {
1962 - "access_token": {
1963 - "type": "string"
1964 - },
1965 - "scope": {
1966 - "type": "string"
1967 - }
1968 - },
1969 - "description": "for slack user scopes"
1970 - },
1971 - "client_id": {
1972 - "type": "string",
1973 - "description": "Dynamically registered client ID"
1974 - },
1975 - "client_secret": {
1976 - "type": "string",
1977 - "description": "Dynamically registered client secret"
1978 - },
1979 - "client_id_issued_at": {
1980 - "type": "number"
1981 - },
1982 - "client_secret_expires_at": {
1983 - "type": "number"
1984 - },
1985 - "generic_api_key": {
1986 - "type": "string"
1987 - },
1988 - "api_key": {
1989 - "type": "string"
1990 - },
1991 - "bearer_token": {
1992 - "type": "string"
1993 - },
1994 - "basic_encoded": {
1995 - "type": "string"
1996 - },
1997 - "username": {
1998 - "type": "string"
1999 - },
2000 - "password": {
2001 - "type": "string"
2002 - },
2003 - "token": {
2004 - "type": "string"
2005 - },
2006 - "oauth_token": {
2007 - "type": "string"
2008 - },
2009 - "oauth_token_secret": {
2010 - "type": "string"
2011 - },
2012 - "oauth_verifier": {
2013 - "type": "string"
2014 - },
2015 - "consumer_key": {
2016 - "type": "string"
2017 - },
2018 - "redirectUrl": {
2019 - "type": "string"
2020 - },
2021 - "callback_url": {
2022 - "type": "string"
2023 - },
2024 - "application_id": {
2025 - "type": "string"
2026 - },
2027 - "installation_id": {
2028 - "type": "string"
2029 - },
2030 - "private_key": {
2031 - "type": "string"
2032 - },
2033 - "credentials_json": {
2034 - "type": "string"
2035 - },
2036 - "expires_at": {
2037 - "type": "string"
2038 - }
2039 - },
2040 - "required": [
2041 - "access_token"
2042 - ],
2043 - "additionalProperties": {}
2044 - }
2045 - },
2046 - "required": [
2047 - "authScheme",
2048 - "toolkitSlug",
2049 - "val"
2050 - ],
2051 - "additionalProperties": true
2052 - },
2053 - "arguments": {
2054 - "type": "object",
2055 - "additionalProperties": {},
2056 - "description": "Key-value pairs of arguments required by the tool (mutually exclusive with text)",
2057 - "example": {
2058 - "repository": "octocat/Hello-World",
2059 - "workflow_id": "main.yml",
2060 - "ref": "main",
2061 - "inputs": {
2062 - "environment": "production"
2063 - }
2344 + "data": {
2345 + "type": "object",
2346 + "additionalProperties": {}
2347 }
2348 },
2066 - "text": {
2067 - "type": "string",
2068 - "description": "Natural language description of the task to perform (mutually exclusive with arguments)",
2069 - "example": "Trigger the main workflow in the octocat/Hello-World repository on the main branch for the production environment"
2070 - },
2071 - "allow_tracing": {
2072 - "type": "boolean",
2073 - "nullable": true,
2074 - "description": "Deprecated. Enable debug tracing for tool execution (useful for debugging)",
2075 - "deprecated": true,
2076 - "example": false
2077 - }
2349 + "required": [
2350 + "id",
2351 + "timestamp",
2352 + "type",
2353 + "status",
2354 + "level",
2355 + "metadata",
2356 + "metrics",
2357 + "parent",
2358 + "context",
2359 + "source",
2360 + "data"
2361 + ]
2362 }
2363 }
2364 }
2081 - }
2082 - },
2083 - "responses": {
2084 - "200": {
2085 - "description": "Successfully executed action and received response",
2365 + },
2366 + "400": {
2367 + "description": "Bad request",
2368 "content": {
2369 "application/json": {
2370 "schema": {
2089 - "type": "object",
2090 - "properties": {
2091 - "data": {
2092 - "type": "object",
2093 - "additionalProperties": {},
2094 - "description": "Tool execution output data that varies based on the specific tool",
2095 - "example": {
2096 - "run_id": 12345678,
2097 - "status": "queued",
2098 - "created_at": "2023-01-01T12:00:00Z",
2099 - "html_url": "https://github.com/octocat/Hello-World/actions/runs/12345678"
2100 - }
2101 - },
2102 - "error": {
2103 - "type": "string",
2104 - "nullable": true,
2105 - "description": "Error message if the tool execution was not successful (null if successful)"
2106 - },
2107 - "successful": {
2108 - "type": "boolean",
2109 - "description": "Indicates if the tool execution was successful",
2110 - "example": true
2111 - },
2112 - "session_info": {
2113 - "nullable": true,
2114 - "description": "Optional session information for tools that return session context",
2115 - "example": {
2116 - "session_id": "session-12345",
2117 - "expires_at": "2023-01-01T13:00:00Z"
2118 - },
2119 - "type": "object"
2120 - },
2121 - "log_id": {
2122 - "type": "string",
2123 - "description": "Unique identifier for the execution log (useful for debugging and support)",
2124 - "example": "log_abc123def456"
2125 - }
2126 - },
2127 - "required": [
2128 - "data",
2129 - "error",
2130 - "successful"
2131 - ]
2371 + "$ref": "#/components/schemas/Error"
2372 }
2373 }
2374 }
2375 },
2136 - "400": {
2137 - "description": "Bad request - Invalid request parameters, missing required arguments, or conflicting parameters",
2376 + "401": {
2377 + "description": "Unauthorized",
2378 "content": {
2379 "application/json": {
2380 "schema": {
@@ -2143,8 +2383,8 @@
2383 }
2384 }
2385 },
2146 - "401": {
2147 - "description": "Unauthorized - Authentication credentials are missing or invalid",
2386 + "404": {
2387 + "description": "Log not found",
2388 "content": {
2389 "application/json": {
2390 "schema": {
@@ -2153,8 +2393,8 @@
2393 }
2394 }
2395 },
2156 - "403": {
2157 - "description": "Forbidden - Connected account does not have permission to execute this tool or access the requested resource",
2396 + "500": {
2397 + "description": "Internal server error",
2398 "content": {
2399 "application/json": {
2400 "schema": {
@@ -2162,29 +2402,203 @@
2402 }
2403 }
2404 }
2405 + }
2406 + },
2407 + "x-api-version": "3.1"
2408 + }
2409 + },
2410 + "/api/v3.1/tools": {
2411 + "get": {
2412 + "summary": "List available tools",
2413 + "description": "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.",
2414 + "tags": [
2415 + "Tools"
2416 + ],
2417 + "operationId": "getTools",
2418 + "security": [
2419 + {
2420 + "ApiKeyAuth": []
2421 },
2166 - "404": {
2167 - "description": "Not found - Tool or connected account not found",
2168 - "content": {
2169 - "application/json": {
2170 - "schema": {
2171 - "$ref": "#/components/schemas/Error"
2422 + {
2423 + "UserApiKeyAuth": []
2424 + }
2425 + ],
2426 + "parameters": [
2427 + {
2428 + "schema": {
2429 + "type": "string"
2430 + },
2431 + "required": false,
2432 + "description": "The slug of the toolkit to filter by",
2433 + "in": "query",
2434 + "name": "toolkit_slug"
2435 + },
2436 + {
2437 + "schema": {
2438 + "type": "string"
2439 + },
2440 + "required": false,
2441 + "description": "Comma-separated list of specific tool slugs to retrieve (overrides other filters)",
2442 + "in": "query",
2443 + "name": "tool_slugs"
2444 + },
2445 + {
2446 + "schema": {
2447 + "oneOf": [
2448 + {
2449 + "type": "string"
2450 + },
2451 + {
2452 + "type": "array",
2453 + "items": {
2454 + "type": "string"
2455 + }
2456 + }
2457 + ]
2458 + },
2459 + "required": false,
2460 + "description": "Comma-separated list of auth config IDs to filter tools by",
2461 + "in": "query",
2462 + "name": "auth_config_ids"
2463 + },
2464 + {
2465 + "schema": {
2466 + "type": "string",
2467 + "enum": [
2468 + "true",
2469 + "false"
2470 + ]
2471 + },
2472 + "required": false,
2473 + "description": "Filter to only show important/featured tools (set to \"true\" to enable)",
2474 + "in": "query",
2475 + "name": "important"
2476 + },
2477 + {
2478 + "schema": {
2479 + "type": "array",
2480 + "items": {
2481 + "type": "string"
2482 + }
2483 + },
2484 + "required": false,
2485 + "description": "Filter tools by one or more tags (can be specified multiple times)",
2486 + "in": "query",
2487 + "name": "tags"
2488 + },
2489 + {
2490 + "schema": {
2491 + "type": "array",
2492 + "nullable": true,
2493 + "items": {
2494 + "type": "string"
2495 + },
2496 + "description": "Filter tools by one or more scopes (can be specified multiple times)"
2497 + },
2498 + "required": false,
2499 + "description": "Array of scopes to filter tools by)",
2500 + "name": "scopes",
2501 + "in": "query"
2502 + },
2503 + {
2504 + "schema": {
2505 + "type": "string"
2506 + },
2507 + "required": false,
2508 + "description": "Full-text search query to filter tools by name, slug, or description. Applied as a soft filter on top of other filters.",
2509 + "in": "query",
2510 + "name": "query"
2511 + },
2512 + {
2513 + "schema": {
2514 + "type": "string"
2515 + },
2516 + "required": false,
2517 + "description": "Deprecated: use \"query\" instead. Free-text search query to find tools by name, description, or functionality.",
2518 + "in": "query",
2519 + "name": "search",
2520 + "deprecated": true
2521 + },
2522 + {
2523 + "schema": {
2524 + "type": "boolean",
2525 + "default": true
2526 + },
2527 + "required": false,
2528 + "description": "Include deprecated tools in the response",
2529 + "in": "query",
2530 + "name": "include_deprecated"
2531 + },
2532 + {
2533 + "schema": {
2534 + "oneOf": [
2535 + {
2536 + "type": "null"
2537 + },
2538 + {
2539 + "type": "string"
2540 + },
2541 + {
2542 + "type": "object",
2543 + "additionalProperties": {
2544 + "type": "string"
2545 + },
2546 + "description": "Object representation of parsed bracket notation"
2547 }
2548 + ]
2549 + },
2550 + "required": false,
2551 + "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",
2552 + "in": "query",
2553 + "name": "toolkit_versions",
2554 + "examples": {
2555 + "latest_version": {
2556 + "summary": "Latest version for all toolkits",
2557 + "value": "latest"
2558 + },
2559 + "bracket_notation": {
2560 + "summary": "Specific versions using bracket notation",
2561 + "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"
2562 + },
2563 + "null_value": {
2564 + "summary": "No version specified (uses 00000000_00)",
2565 + "value": null
2566 }
2567 }
2568 },
2176 - "408": {
2177 - "description": "Request timeout - Tool execution exceeded the maximum allowed time",
2569 + {
2570 + "schema": {
2571 + "type": "number",
2572 + "nullable": true
2573 + },
2574 + "required": false,
2575 + "description": "Number of items per page, max allowed is 1000",
2576 + "name": "limit",
2577 + "in": "query"
2578 + },
2579 + {
2580 + "schema": {
2581 + "type": "string"
2582 + },
2583 + "required": false,
2584 + "description": "Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.",
2585 + "name": "cursor",
2586 + "in": "query"
2587 + }
2588 + ],
2589 + "responses": {
2590 + "200": {
2591 + "description": "Successfully retrieved tools list with pagination information",
2592 "content": {
2593 "application/json": {
2594 "schema": {
2181 - "$ref": "#/components/schemas/Error"
2595 + "$ref": "#/components/schemas/ToolsPaginated"
2596 }
2597 }
2598 }
2599 },
2186 - "410": {
2187 - "description": "Gone - Tool has been deprecated and is no longer available",
2600 + "400": {
2601 + "description": "Bad request - Invalid query parameters",
2602 "content": {
2603 "application/json": {
2604 "schema": {
@@ -2193,8 +2607,8 @@
2607 }
2608 }
2609 },
2196 - "413": {
2197 - "description": "Payload too large - Request or response payload exceeds size limits",
2610 + "401": {
2611 + "description": "Unauthorized - Authentication credentials are missing or invalid",
2612 "content": {
2613 "application/json": {
2614 "schema": {
@@ -2203,8 +2617,8 @@
2617 }
2618 }
2619 },
2206 - "422": {
2207 - "description": "Unprocessable entity - Invalid state of the connected account",
2620 + "403": {
2621 + "description": "Forbidden - User does not have permission to access tools",
2622 "content": {
2623 "application/json": {
2624 "schema": {
@@ -2213,8 +2627,8 @@
2627 }
2628 }
2629 },
2216 - "429": {
2217 - "description": "Rate limit exceeded - Too many requests to the tool or underlying API",
2630 + "404": {
2631 + "description": "Not found - The requested resource was not found",
2632 "content": {
2633 "application/json": {
2634 "schema": {
@@ -2223,8 +2637,8 @@
2637 }
2638 }
2639 },
2226 - "500": {
2227 - "description": "Internal server error - Something went wrong on the server",
2640 + "429": {
2641 + "description": "Too many requests - Rate limit exceeded",
2642 "content": {
2643 "application/json": {
2644 "schema": {
@@ -2233,8 +2647,8 @@
2647 }
2648 }
2649 },
2236 - "501": {
2237 - "description": "Not implemented",
2650 + "500": {
2651 + "description": "Internal server error - Something went wrong on the server",
2652 "content": {
2653 "application/json": {
2654 "schema": {
@@ -2242,9 +2656,44 @@
2656 }
2657 }
2658 }
2245 - },
2246 - "502": {
2247 - "description": "Bad gateway - Error communicating with the tool provider API",
2659 + }
2660 + },
2661 + "x-api-version": "3.1"
2662 + }
2663 + },
2664 + "/api/v3.1/tools/enum": {
2665 + "get": {
2666 + "summary": "Get tool enum list",
2667 + "description": "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.",
2668 + "tags": [
2669 + "Tools"
2670 + ],
2671 + "operationId": "getToolsEnum",
2672 + "security": [
2673 + {
2674 + "ApiKeyAuth": []
2675 + },
2676 + {
2677 + "UserApiKeyAuth": []
2678 + }
2679 + ],
2680 + "responses": {
2681 + "200": {
2682 + "description": "Successfully retrieved tool enum list",
2683 + "content": {
2684 + "application/json": {
2685 + "schema": {
2686 + "type": "array",
2687 + "items": {
2688 + "type": "string"
2689 + },
2690 + "description": "JSON string containing all tool enum values from latest version of each toolkit"
2691 + }
2692 + }
2693 + }
2694 + },
2695 + "400": {
2696 + "description": "Bad request - Invalid request parameters",
2697 "content": {
2698 "application/json": {
2699 "schema": {
@@ -2253,8 +2702,38 @@
2702 }
2703 }
2704 },
2256 - "503": {
2257 - "description": "Upstream service unavailable - Tool provider API is currently down or unavailable",
2705 + "401": {
2706 + "description": "Unauthorized - Authentication credentials are missing or invalid",
2707 + "content": {
2708 + "application/json": {
2709 + "schema": {
2710 + "$ref": "#/components/schemas/Error"
2711 + }
2712 + }
2713 + }
2714 + },
2715 + "403": {
2716 + "description": "Forbidden - User does not have permission to access tool enums",
2717 + "content": {
2718 + "application/json": {
2719 + "schema": {
2720 + "$ref": "#/components/schemas/Error"
2721 + }
2722 + }
2723 + }
2724 + },
2725 + "404": {
2726 + "description": "Not found - Tool enum list not found",
2727 + "content": {
2728 + "application/json": {
2729 + "schema": {
2730 + "$ref": "#/components/schemas/Error"
2731 + }
2732 + }
2733 + }
2734 + },
2735 + "500": {
2736 + "description": "Internal server error - Something went wrong on the server",
2737 "content": {
2738 "application/json": {
2739 "schema": {
@@ -2267,14 +2746,14 @@
2746 "x-api-version": "3.1"
2747 }
2748 },
2270 - "/api/v3.1/tools/execute/{tool_slug}/input": {
2271 - "post": {
2272 - "summary": "Generate tool inputs from natural language",
2273 - "description": "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.",
2749 + "/api/v3.1/tools/{tool_slug}": {
2750 + "get": {
2751 + "summary": "Get tool by slug",
2752 + "description": "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.",
2753 "tags": [
2754 "Tools"
2755 ],
2277 - "operationId": "postToolsExecuteByToolSlugInput",
2756 + "operationId": "getToolsByToolSlug",
2757 "security": [
2758 {
2759 "ApiKeyAuth": []
@@ -2289,78 +2768,70 @@
2768 "type": "string"
2769 },
2770 "required": true,
2292 - "description": "The tool slug to generate inputs for",
2771 + "description": "The unique slug identifier of the tool",
2772 "name": "tool_slug",
2773 "in": "path"
2295 - }
2296 - ],
2297 - "requestBody": {
2298 - "content": {
2299 - "application/json": {
2300 - "schema": {
2301 - "type": "object",
2302 - "properties": {
2303 - "text": {
2304 - "type": "string",
2305 - "description": "Natural language description of what you want to accomplish with this tool",
2306 - "example": "I need to trigger the main workflow in the octocat/Hello-World repository to deploy to production"
2307 - },
2308 - "custom_description": {
2309 - "type": "string",
2310 - "description": "Custom description of the tool to help guide the LLM in generating more accurate inputs",
2311 - "example": "This tool triggers GitHub Actions workflows in a repository. It requires the repository name, workflow ID, and optional input parameters."
2312 - },
2313 - "system_prompt": {
2314 - "type": "string",
2315 - "description": "System prompt to control and guide the behavior of the LLM when generating inputs",
2316 - "example": "You are an expert assistant that generates precise GitHub Actions workflow parameters. Extract exact repository names, workflow IDs, and input values from user descriptions."
2317 - },
2318 - "version": {
2319 - "type": "string",
2320 - "description": "Tool version to use when generating inputs (defaults to \"latest\" if not specified)",
2321 - "example": "latest"
2322 - }
2774 + },
2775 + {
2776 + "schema": {
2777 + "type": "string"
2778 + },
2779 + "required": false,
2780 + "description": "Optional version of the tool to retrieve",
2781 + "name": "version",
2782 + "in": "query"
2783 + },
2784 + {
2785 + "schema": {
2786 + "oneOf": [
2787 + {
2788 + "type": "null"
2789 },
2324 - "required": [
2325 - "text"
2326 - ]
2790 + {
2791 + "type": "string"
2792 + },
2793 + {
2794 + "type": "object",
2795 + "additionalProperties": {
2796 + "type": "string"
2797 + },
2798 + "description": "Object representation of parsed bracket notation"
2799 + }
2800 + ]
2801 + },
2802 + "required": false,
2803 + "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",
2804 + "in": "query",
2805 + "name": "toolkit_versions",
2806 + "examples": {
2807 + "latest_version": {
2808 + "summary": "Latest version for all toolkits",
2809 + "value": "latest"
2810 + },
2811 + "bracket_notation": {
2812 + "summary": "Specific versions using bracket notation",
2813 + "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"
2814 + },
2815 + "null_value": {
2816 + "summary": "No version specified (uses 00000000_00)",
2817 + "value": null
2818 }
2819 }
2820 }
2330 - },
2821 + ],
2822 "responses": {
2823 "200": {
2333 - "description": "Successfully generated structured inputs for the action based on natural language description",
2824 + "description": "Successfully retrieved tool details",
2825 "content": {
2826 "application/json": {
2827 "schema": {
2337 - "type": "object",
2338 - "properties": {
2339 - "arguments": {
2340 - "type": "object",
2341 - "additionalProperties": {},
2342 - "description": "Key-value pairs of arguments required by the tool to accomplish the described task",
2343 - "example": {
2344 - "repository": "octocat/Hello-World",
2345 - "workflow_id": "main.yml",
2346 - "ref": "main",
2347 - "inputs": {
2348 - "environment": "production"
2349 - }
2350 - }
2351 - },
2352 - "error": {
2353 - "type": "string",
2354 - "description": "Error message if the arguments could not be generated (null if successful)",
2355 - "example": "Unable to determine the repository name from the provided description"
2356 - }
2357 - }
2828 + "$ref": "#/components/schemas/Tool"
2829 }
2830 }
2831 }
2832 },
2833 "400": {
2363 - "description": "Bad request - Invalid input parameters or insufficient description to generate tool arguments",
2834 + "description": "Bad request - Invalid tool slug format",
2835 "content": {
2836 "application/json": {
2837 "schema": {
@@ -2380,27 +2851,7 @@
2851 }
2852 },
2853 "404": {
2383 - "description": "Not found - The specified tool does not exist",
2384 - "content": {
2385 - "application/json": {
2386 - "schema": {
2387 - "$ref": "#/components/schemas/Error"
2388 - }
2389 - }
2390 - }
2391 - },
2392 - "422": {
2393 - "description": "Unprocessable entity - Invalid state of the connected account",
2394 - "content": {
2395 - "application/json": {
2396 - "schema": {
2397 - "$ref": "#/components/schemas/Error"
2398 - }
2399 - }
2400 - }
2401 - },
2402 - "429": {
2403 - "description": "Too many requests - Rate limit exceeded for natural language processing",
2854 + "description": "Not found - Tool with the specified slug does not exist",
2855 "content": {
2856 "application/json": {
2857 "schema": {
@@ -2410,7 +2861,7 @@
2861 }
2862 },
2863 "500": {
2413 - "description": "Internal server error - AI processing failed or other server error occurred",
2864 + "description": "Internal server error - Something went wrong on the server",
2865 "content": {
2866 "application/json": {
2867 "schema": {
@@ -2423,14 +2874,14 @@
2874 "x-api-version": "3.1"
2875 }
2876 },
2426 - "/api/v3.1/tools/execute/proxy": {
2877 + "/api/v3.1/tools/execute/{tool_slug}": {
2878 "post": {
2428 - "summary": "Execute proxy request",
2429 - "description": "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.",
2879 + "summary": "Execute tool",
2880 + "description": "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.",
2881 "tags": [
2882 "Tools"
2883 ],
2433 - "operationId": "postToolsExecuteProxy",
2884 + "operationId": "postToolsExecuteByToolSlug",
2885 "security": [
2886 {
2887 "ApiKeyAuth": []
@@ -2439,6 +2890,27 @@
2890 "UserApiKeyAuth": []
2891 }
2892 ],
2893 + "parameters": [
2894 + {
2895 + "schema": {
2896 + "type": "string"
2897 + },
2898 + "required": true,
2899 + "description": "The tool slug to execute",
2900 + "name": "tool_slug",
2901 + "in": "path"
2902 + },
2903 + {
2904 + "schema": {
2905 + "type": "string",
2906 + "description": "JSON object containing custom headers to pass to LLM providers (OpenAI, Bedrock, etc.)",
2907 + "example": "{\"x-custom-header\": \"value\", \"authorization\": \"Bearer token\"}"
2908 + },
2909 + "required": false,
2910 + "name": "x-llm-gateway-headers",
2911 + "in": "header"
2912 + }
2913 + ],
2914 "requestBody": {
2915 "content": {
2916 "application/json": {
@@ -2447,123 +2919,95 @@
2919 "properties": {
2920 "connected_account_id": {
2921 "type": "string",
2450 - "format": "connectedAccountId",
2451 - "description": "The ID of the connected account to use for authentication (if not provided, will use the default account for the project)",
2922 + "description": "Unique identifier for the connected account to use for authentication",
2923 "example": "ca_1a2b3c4d5e6f"
2924 },
2454 - "endpoint": {
2925 + "entity_id": {
2926 "type": "string",
2456 - "description": "The API endpoint to call (absolute URL or path relative to base URL of the connected account)",
2457 - "example": "/api/v1/resources"
2927 + "description": "Deprecated: please use user_id instead. Entity identifier for multi-entity connected accounts (e.g. multiple repositories, organizations)",
2928 + "example": "repo-123",
2929 + "deprecated": true
2930 },
2459 - "method": {
2931 + "user_id": {
2932 "type": "string",
2461 - "enum": [
2462 - "GET",
2463 - "POST",
2464 - "PUT",
2465 - "DELETE",
2466 - "PATCH",
2467 - "HEAD"
2468 - ],
2469 - "description": "The HTTP method to use for the request",
2470 - "example": "GET"
2933 + "description": "User id for multi-user connected accounts (e.g. multiple users, organizations)",
2934 + "example": "user-123"
2935 },
2472 - "body": {
2473 - "nullable": true,
2474 - "description": "The request body (for POST, PUT, and PATCH requests)",
2475 - "example": {
2476 - "name": "New Resource",
2477 - "description": "This is a new resource"
2478 - },
2479 - "type": "object"
2936 + "version": {
2937 + "type": "string",
2938 + "description": "Tool version to execute (defaults to \"00000000_00\" if not specified)",
2939 + "example": "latest"
2940 },
2481 - "binary_body": {
2482 - "anyOf": [
2483 - {
2484 - "type": "object",
2485 - "properties": {
2486 - "url": {
2487 - "type": "string",
2488 - "format": "uri",
2489 - "description": "URL to fetch binary content from"
2941 + "custom_auth_params": {
2942 + "type": "object",
2943 + "properties": {
2944 + "base_url": {
2945 + "type": "string",
2946 + "description": "The base URL (root address) what you should use while making http requests to the connected account. For example, for gmail, it would be 'https://gmail.googleapis.com'"
2947 + },
2948 + "parameters": {
2949 + "type": "array",
2950 + "items": {
2951 + "type": "object",
2952 + "properties": {
2953 + "name": {
2954 + "type": "string",
2955 + "description": "The name of the parameter. For example, 'x-api-key', 'Content-Type', etc."
2956 + },
2957 + "in": {
2958 + "type": "string",
2959 + "enum": [
2960 + "query",
2961 + "header"
2962 + ],
2963 + "description": "The location of the parameter. Can be 'query' or 'header'."
2964 + },
2965 + "value": {
2966 + "anyOf": [
2967 + {
2968 + "type": "string"
2969 + },
2970 + {
2971 + "type": "number"
2972 + }
2973 + ],
2974 + "description": "The value of the parameter. For example, '1234567890', 'application/json', etc."
2975 + }
2976 },
2491 - "content_type": {
2492 - "type": "string",
2493 - "description": "Content-Type header to use for the request"
2494 - }
2495 - },
2496 - "required": [
2497 - "url"
2498 - ]
2977 + "required": [
2978 + "name",
2979 + "in",
2980 + "value"
2981 + ]
2982 + }
2983 },
2500 - {
2984 + "body": {
2985 "type": "object",
2502 - "properties": {
2503 - "base64": {
2504 - "type": "string",
2505 - "minLength": 1,
2506 - "description": "Base64-encoded binary data"
2507 - },
2508 - "content_type": {
2509 - "type": "string",
2510 - "description": "Content-Type header to use for the request"
2511 - }
2512 - },
2513 - "required": [
2514 - "base64"
2515 - ]
2986 + "additionalProperties": {},
2987 + "description": "The body to be sent to the endpoint for authentication. This is a JSON object. Note: This is very rarely needed and is only required by very few apps."
2988 }
2517 - ],
2518 - "description": "Binary body to send. For binary upload via URL: use {url: \"https://...\", content_type?: \"...\"}. For binary upload via base64: use {base64: \"...\", content_type?: \"...\"}."
2519 - },
2520 - "parameters": {
2521 - "type": "array",
2522 - "items": {
2523 - "type": "object",
2524 - "properties": {
2525 - "name": {
2526 - "type": "string",
2527 - "description": "Parameter name",
2528 - "example": "x-api-key"
2529 - },
2530 - "value": {
2531 - "type": "string",
2532 - "description": "Parameter value",
2533 - "example": "abc123def456"
2534 - },
2535 - "type": {
2536 - "type": "string",
2537 - "enum": [
2538 - "header",
2539 - "query"
2540 - ],
2541 - "description": "Parameter type (header or query)",
2542 - "example": "header"
2989 + },
2990 + "description": "Custom authentication parameters for tools that support parameterized authentication",
2991 + "example": {
2992 + "base_url": "https://api.example.com",
2993 + "parameters": [
2994 + {
2995 + "name": "x-api-key",
2996 + "value": "secret-key",
2997 + "in": "header"
2998 }
2544 - },
2545 - "required": [
2546 - "name",
2547 - "value",
2548 - "type"
2999 ]
2550 - },
2551 - "description": "Additional HTTP headers or query parameters to include in the request",
2552 - "example": [
2553 - {
2554 - "name": "x-api-key",
2555 - "value": "abc123def456",
2556 - "type": "header"
2557 - },
2558 - {
2559 - "name": "filter",
2560 - "value": "active",
2561 - "type": "query"
2562 - }
2563 - ]
3000 + }
3001 },
3002 "custom_connection_data": {
2566 - "deprecated": true,
3003 + "description": "Custom connection data for tools that support custom connection data",
3004 + "example": {
3005 + "authScheme": "OAUTH2",
3006 + "toolkitSlug": "github",
3007 + "val": {
3008 + "access_token": "secret-token"
3009 + }
3010 + },
3011 "type": "object",
3012 "properties": {
3013 "authScheme": {
@@ -2803,88 +3247,92 @@
3247 "val"
3248 ],
3249 "additionalProperties": true
3250 + },
3251 + "arguments": {
3252 + "type": "object",
3253 + "additionalProperties": {},
3254 + "description": "Key-value pairs of arguments required by the tool (mutually exclusive with text)",
3255 + "example": {
3256 + "repository": "octocat/Hello-World",
3257 + "workflow_id": "main.yml",
3258 + "ref": "main",
3259 + "inputs": {
3260 + "environment": "production"
3261 + }
3262 + }
3263 + },
3264 + "text": {
3265 + "type": "string",
3266 + "description": "Natural language description of the task to perform (mutually exclusive with arguments)",
3267 + "example": "Trigger the main workflow in the octocat/Hello-World repository on the main branch for the production environment"
3268 + },
3269 + "allow_tracing": {
3270 + "type": "boolean",
3271 + "nullable": true,
3272 + "description": "Deprecated. Enable debug tracing for tool execution (useful for debugging)",
3273 + "deprecated": true,
3274 + "example": false
3275 }
2807 - },
2808 - "required": [
2809 - "endpoint",
2810 - "method"
2811 - ]
3276 + }
3277 }
3278 }
3279 }
3280 },
3281 "responses": {
3282 "200": {
2818 - "description": "Successfully executed proxy request and received response",
3283 + "description": "Successfully executed action and received response",
3284 "content": {
3285 "application/json": {
3286 "schema": {
3287 "type": "object",
3288 "properties": {
3289 "data": {
2825 - "nullable": true,
2826 - "description": "The response data returned from the proxied API",
3290 + "type": "object",
3291 + "additionalProperties": {},
3292 + "description": "Tool execution output data that varies based on the specific tool",
3293 "example": {
2828 - "id": "123",
2829 - "name": "Resource Name",
2830 - "created_at": "2023-01-01T00:00:00Z"
2831 - },
2832 - "type": "object"
3294 + "run_id": 12345678,
3295 + "status": "queued",
3296 + "created_at": "2023-01-01T12:00:00Z",
3297 + "html_url": "https://github.com/octocat/Hello-World/actions/runs/12345678"
3298 + }
3299 },
2834 - "binary_data": {
2835 - "type": "object",
2836 - "properties": {
2837 - "url": {
2838 - "type": "string",
2839 - "description": "URL to download binary content"
2840 - },
2841 - "content_type": {
2842 - "type": "string",
2843 - "description": "Content-Type of the binary data"
2844 - },
2845 - "size": {
2846 - "type": "number",
2847 - "description": "File size in bytes"
2848 - },
2849 - "expires_at": {
2850 - "type": "string",
2851 - "description": "ISO 8601 timestamp when the URL expires"
2852 - }
2853 - },
2854 - "required": [
2855 - "url",
2856 - "content_type",
2857 - "size"
2858 - ],
2859 - "description": "Binary body response data. Present when the response is a binary file."
3300 + "error": {
3301 + "type": "string",
3302 + "nullable": true,
3303 + "description": "Error message if the tool execution was not successful (null if successful)"
3304 },
2861 - "status": {
2862 - "type": "number",
2863 - "description": "The HTTP status code returned from the proxied API",
2864 - "example": 200
3305 + "successful": {
3306 + "type": "boolean",
3307 + "description": "Indicates if the tool execution was successful",
3308 + "example": true
3309 },
2866 - "headers": {
2867 - "type": "object",
2868 - "additionalProperties": {
2869 - "type": "string"
2870 - },
2871 - "description": "The HTTP headers returned from the proxied API",
3310 + "session_info": {
3311 + "nullable": true,
3312 + "description": "Optional session information for tools that return session context",
3313 "example": {
2873 - "content-type": "application/json",
2874 - "cache-control": "no-cache",
2875 - "host": "api.example.com"
2876 - }
3314 + "session_id": "session-12345",
3315 + "expires_at": "2023-01-01T13:00:00Z"
3316 + },
3317 + "type": "object"
3318 + },
3319 + "log_id": {
3320 + "type": "string",
3321 + "description": "Unique identifier for the execution log (useful for debugging and support)",
3322 + "example": "log_abc123def456"
3323 }
3324 },
3325 "required": [
2880 - "status"
3326 + "data",
3327 + "error",
3328 + "successful"
3329 ]
3330 }
3331 }
3332 }
3333 },
3334 "400": {
2887 - "description": "Bad request - Invalid request parameters or body format",
3335 + "description": "Bad request - Invalid request parameters, missing required arguments, or conflicting parameters",
3336 "content": {
3337 "application/json": {
3338 "schema": {
@@ -2904,7 +3352,7 @@
3352 }
3353 },
3354 "403": {
2907 - "description": "Forbidden - Connected account does not have permission to access the requested resource",
3355 + "description": "Forbidden - Connected account does not have permission to execute this tool or access the requested resource",
3356 "content": {
3357 "application/json": {
3358 "schema": {
@@ -2914,7 +3362,37 @@
3362 }
3363 },
3364 "404": {
2917 - "description": "Not found - Resource not found or connected account not found",
3365 + "description": "Not found - Tool or connected account not found",
3366 + "content": {
3367 + "application/json": {
3368 + "schema": {
3369 + "$ref": "#/components/schemas/Error"
3370 + }
3371 + }
3372 + }
3373 + },
3374 + "408": {
3375 + "description": "Request timeout - Tool execution exceeded the maximum allowed time",
3376 + "content": {
3377 + "application/json": {
3378 + "schema": {
3379 + "$ref": "#/components/schemas/Error"
3380 + }
3381 + }
3382 + }
3383 + },
3384 + "410": {
3385 + "description": "Gone - Tool has been deprecated and is no longer available",
3386 + "content": {
3387 + "application/json": {
3388 + "schema": {
3389 + "$ref": "#/components/schemas/Error"
3390 + }
3391 + }
3392 + }
3393 + },
3394 + "413": {
3395 + "description": "Payload too large - Request or response payload exceeds size limits",
3396 "content": {
3397 "application/json": {
3398 "schema": {
@@ -2934,7 +3412,7 @@
3412 }
3413 },
3414 "429": {
2937 - "description": "Too many requests - Rate limit exceeded on the connected account or proxy service",
3415 + "description": "Rate limit exceeded - Too many requests to the tool or underlying API",
3416 "content": {
3417 "application/json": {
3418 "schema": {
@@ -2954,7 +3432,7 @@
3432 }
3433 },
3434 "501": {
2957 - "description": "Not implemented - This operation is not supported for the requested connected account or authentication scheme",
3435 + "description": "Not implemented",
3436 "content": {
3437 "application/json": {
3438 "schema": {
@@ -2964,7 +3442,7 @@
3442 }
3443 },
3444 "502": {
2967 - "description": "Bad gateway - Error communicating with the upstream API",
3445 + "description": "Bad gateway - Error communicating with the tool provider API",
3446 "content": {
3447 "application/json": {
3448 "schema": {
@@ -2973,8 +3451,8 @@
3451 }
3452 }
3453 },
2976 - "504": {
2977 - "description": "Gateway timeout - Upstream API timed out",
3454 + "503": {
3455 + "description": "Upstream service unavailable - Tool provider API is currently down or unavailable",
3456 "content": {
3457 "application/json": {
3458 "schema": {
@@ -2987,14 +3465,14 @@
3465 "x-api-version": "3.1"
3466 }
3467 },
2990 - "/api/v3.1/tools/scopes/required": {
3468 + "/api/v3.1/tools/execute/{tool_slug}/input": {
3469 "post": {
2992 - "summary": "Get required scopes for tools",
2993 - "description": "Resolves required scopes for the specified tools at a given toolkit version. All requested tools must belong to the same toolkit. Returns the flat scope union plus per-tool structured scope requirements when available.",
3470 + "summary": "Generate tool inputs from natural language",
3471 + "description": "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.",
3472 "tags": [
3473 "Tools"
3474 ],
2997 - "operationId": "postToolsScopesRequired",
3475 + "operationId": "postToolsExecuteByToolSlugInput",
3476 "security": [
3477 {
3478 "ApiKeyAuth": []
@@ -3003,32 +3481,46 @@
3481 "UserApiKeyAuth": []
3482 }
3483 ],
3484 + "parameters": [
3485 + {
3486 + "schema": {
3487 + "type": "string"
3488 + },
3489 + "required": true,
3490 + "description": "The tool slug to generate inputs for",
3491 + "name": "tool_slug",
3492 + "in": "path"
3493 + }
3494 + ],
3495 "requestBody": {
3496 "content": {
3497 "application/json": {
3498 "schema": {
3499 "type": "object",
3500 "properties": {
3012 - "tools": {
3013 - "type": "array",
3014 - "items": {
3015 - "type": "string"
3016 - },
3017 - "minItems": 1,
3018 - "description": "Tool slugs to resolve scopes for. All tools must belong to the same toolkit.",
3019 - "example": [
3020 - "GMAIL_FETCH_EMAILS",
3021 - "GMAIL_SEND_EMAIL"
3022 - ]
3501 + "text": {
3502 + "type": "string",
3503 + "description": "Natural language description of what you want to accomplish with this tool",
3504 + "example": "I need to trigger the main workflow in the octocat/Hello-World repository to deploy to production"
3505 + },
3506 + "custom_description": {
3507 + "type": "string",
3508 + "description": "Custom description of the tool to help guide the LLM in generating more accurate inputs",
3509 + "example": "This tool triggers GitHub Actions workflows in a repository. It requires the repository name, workflow ID, and optional input parameters."
3510 + },
3511 + "system_prompt": {
3512 + "type": "string",
3513 + "description": "System prompt to control and guide the behavior of the LLM when generating inputs",
3514 + "example": "You are an expert assistant that generates precise GitHub Actions workflow parameters. Extract exact repository names, workflow IDs, and input values from user descriptions."
3515 },
3516 "version": {
3517 "type": "string",
3026 - "description": "Toolkit version to resolve scopes against for the requested toolkit. Defaults to the pinned HTTP version when omitted.",
3518 + "description": "Tool version to use when generating inputs (defaults to \"latest\" if not specified)",
3519 "example": "latest"
3520 }
3521 },
3522 "required": [
3031 - "tools"
3523 + "text"
3524 ]
3525 }
3526 }
@@ -3036,87 +3528,37 @@
3528 },
3529 "responses": {
3530 "200": {
3039 - "description": "Successfully retrieved scopes for the specified tools",
3531 + "description": "Successfully generated structured inputs for the action based on natural language description",
3532 "content": {
3533 "application/json": {
3534 "schema": {
3535 "type": "object",
3536 "properties": {
3045 - "scopes_required": {
3046 - "type": "array",
3047 - "items": {
3048 - "type": "string"
3049 - },
3050 - "description": "A combined list of all unique scopes required by the specified tools",
3051 - "example": [
3052 - "channels:read",
3053 - "chat:write",
3054 - "https://www.googleapis.com/auth/gmail.modify",
3055 - "repo",
3056 - "user:email"
3057 - ]
3537 + "arguments": {
3538 + "type": "object",
3539 + "additionalProperties": {},
3540 + "description": "Key-value pairs of arguments required by the tool to accomplish the described task",
3541 + "example": {
3542 + "repository": "octocat/Hello-World",
3543 + "workflow_id": "main.yml",
3544 + "ref": "main",
3545 + "inputs": {
3546 + "environment": "production"
3547 + }
3548 + }
3549 },
3059 - "per_tool_requirements": {
3060 - "type": "array",
3061 - "items": {
3062 - "type": "object",
3063 - "properties": {
3064 - "tool": {
3065 - "type": "string"
3066 - },
3067 - "scope_requirements": {
3068 - "type": "object",
3069 - "nullable": true,
3070 - "properties": {
3071 - "all_of": {
3072 - "type": "array",
3073 - "items": {
3074 - "anyOf": [
3075 - {
3076 - "type": "string"
3077 - },
3078 - {
3079 - "type": "object",
3080 - "properties": {
3081 - "any_of": {
3082 - "type": "array",
3083 - "items": {
3084 - "type": "string"
3085 - },
3086 - "minItems": 1
3087 - }
3088 - },
3089 - "required": [
3090 - "any_of"
3091 - ]
3092 - }
3093 - ]
3094 - }
3095 - }
3096 - },
3097 - "required": [
3098 - "all_of"
3099 - ]
3100 - }
3101 - },
3102 - "required": [
3103 - "tool",
3104 - "scope_requirements"
3105 - ]
3106 - },
3107 - "description": "Per-tool structured scope requirements. Null scope_requirements marks unmigrated legacy tools."
3550 + "error": {
3551 + "type": "string",
3552 + "description": "Error message if the arguments could not be generated (null if successful)",
3553 + "example": "Unable to determine the repository name from the provided description"
3554 }
3109 - },
3110 - "required": [
3111 - "scopes_required",
3112 - "per_tool_requirements"
3113 - ]
3555 + }
3556 }
3557 }
3558 }
3559 },
3560 "400": {
3119 - "description": "Bad request - Invalid body parameters or tools from different toolkits",
3561 + "description": "Bad request - Invalid input parameters or insufficient description to generate tool arguments",
3562 "content": {
3563 "application/json": {
3564 "schema": {
@@ -3136,7 +3578,27 @@
3578 }
3579 },
3580 "404": {
3139 - "description": "Not found - One or more tools could not be resolved for the requested version",
3581 + "description": "Not found - The specified tool does not exist",
3582 + "content": {
3583 + "application/json": {
3584 + "schema": {
3585 + "$ref": "#/components/schemas/Error"
3586 + }
3587 + }
3588 + }
3589 + },
3590 + "422": {
3591 + "description": "Unprocessable entity - Invalid state of the connected account",
3592 + "content": {
3593 + "application/json": {
3594 + "schema": {
3595 + "$ref": "#/components/schemas/Error"
3596 + }
3597 + }
3598 + }
3599 + },
3600 + "429": {
3601 + "description": "Too many requests - Rate limit exceeded for natural language processing",
3602 "content": {
3603 "application/json": {
3604 "schema": {
@@ -3146,7 +3608,7 @@
3608 }
3609 },
3610 "500": {
3149 - "description": "Internal server error - Something went wrong on the server",
3611 + "description": "Internal server error - AI processing failed or other server error occurred",
3612 "content": {
3613 "application/json": {
3614 "schema": {
@@ -3159,14 +3621,14 @@
3621 "x-api-version": "3.1"
3622 }
3623 },
3162 - "/api/v3.1/tool_router/session": {
3624 + "/api/v3.1/tools/execute/proxy": {
3625 "post": {
3164 - "summary": "Create a new tool router session",
3165 - "description": "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.",
3626 + "summary": "Execute proxy request",
3627 + "description": "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.",
3628 "tags": [
3167 - "Tool Router"
3629 + "Tools"
3630 ],
3169 - "operationId": "postToolRouterSession",
3631 + "operationId": "postToolsExecuteProxy",
3632 "security": [
3633 {
3634 "ApiKeyAuth": []
@@ -3181,1164 +3643,678 @@
3643 "schema": {
3644 "type": "object",
3645 "properties": {
3184 - "user_id": {
3646 + "connected_account_id": {
3647 "type": "string",
3186 - "minLength": 1,
3187 - "description": "The identifier of the user who is initiating the session, ideally a unique identifier from your database like a user ID or email address",
3188 - "example": "user_123456789"
3648 + "format": "connectedAccountId",
3649 + "description": "The ID of the connected account to use for authentication (if not provided, will use the default account for the project)",
3650 + "example": "ca_1a2b3c4d5e6f"
3651 },
3190 - "toolkits": {
3191 - "anyOf": [
3192 - {
3193 - "type": "object",
3194 - "properties": {
3195 - "enable": {
3196 - "type": "array",
3197 - "items": {
3198 - "type": "string"
3199 - },
3200 - "description": "Only these specific toolkits will be enabled",
3201 - "example": [
3202 - "gmail",
3203 - "slack",
3204 - "github"
3205 - ]
3652 + "endpoint": {
3653 + "type": "string",
3654 + "description": "The API endpoint to call (absolute URL or path relative to base URL of the connected account)",
3655 + "example": "/api/v1/resources"
3656 + },
3657 + "method": {
3658 + "type": "string",
3659 + "enum": [
3660 + "GET",
3661 + "POST",
3662 + "PUT",
3663 + "DELETE",
3664 + "PATCH",
3665 + "HEAD"
3666 + ],
3667 + "description": "The HTTP method to use for the request",
3668 + "example": "GET"
3669 + },
3670 + "body": {
3671 + "nullable": true,
3672 + "description": "The request body (for POST, PUT, and PATCH requests)",
3673 + "example": {
3674 + "name": "New Resource",
3675 + "description": "This is a new resource"
3676 + },
3677 + "type": "object"
3678 + },
3679 + "binary_body": {
3680 + "anyOf": [
3681 + {
3682 + "type": "object",
3683 + "properties": {
3684 + "url": {
3685 + "type": "string",
3686 + "format": "uri",
3687 + "description": "URL to fetch binary content from"
3688 + },
3689 + "content_type": {
3690 + "type": "string",
3691 + "description": "Content-Type header to use for the request"
3692 }
3693 },
3694 "required": [
3209 - "enable"
3210 - ],
3211 - "additionalProperties": false,
3212 - "description": "Enable only specific toolkits (allowlist)"
3695 + "url"
3696 + ]
3697 },
3698 {
3699 "type": "object",
3700 "properties": {
3217 - "disable": {
3218 - "type": "array",
3219 - "items": {
3220 - "type": "string"
3221 - },
3222 - "description": "These specific toolkits will be disabled",
3223 - "example": [
3224 - "gmail",
3225 - "slack"
3226 - ]
3701 + "base64": {
3702 + "type": "string",
3703 + "minLength": 1,
3704 + "description": "Base64-encoded binary data"
3705 + },
3706 + "content_type": {
3707 + "type": "string",
3708 + "description": "Content-Type header to use for the request"
3709 }
3710 },
3711 "required": [
3230 - "disable"
3231 - ],
3232 - "additionalProperties": false,
3233 - "description": "Disable specific toolkits (denylist)"
3712 + "base64"
3713 + ]
3714 }
3715 ],
3236 - "description": "Toolkit configuration - specify either enable toolkits (allowlist) or disable toolkits (denylist). Mutually exclusive."
3237 - },
3238 - "auth_configs": {
3239 - "type": "object",
3240 - "additionalProperties": {
3241 - "type": "string",
3242 - "format": "authConfigId"
3243 - },
3244 - "description": "The auth configs to use for the session. This will override the default behavior and use the given auth config when specific toolkits are being executed",
3245 - "example": {
3246 - "gmail": "ac_1a2b3c4d5e6f",
3247 - "slack": "ac_7g8h9i0j1k2l"
3248 - }
3716 + "description": "Binary body to send. For binary upload via URL: use {url: \"https://...\", content_type?: \"...\"}. For binary upload via base64: use {base64: \"...\", content_type?: \"...\"}."
3717 },
3250 - "connected_accounts": {
3251 - "type": "object",
3252 - "additionalProperties": {
3253 - "type": "string",
3254 - "format": "connectedAccountId"
3718 + "parameters": {
3719 + "type": "array",
3720 + "items": {
3721 + "type": "object",
3722 + "properties": {
3723 + "name": {
3724 + "type": "string",
3725 + "description": "Parameter name",
3726 + "example": "x-api-key"
3727 + },
3728 + "value": {
3729 + "type": "string",
3730 + "description": "Parameter value",
3731 + "example": "abc123def456"
3732 + },
3733 + "type": {
3734 + "type": "string",
3735 + "enum": [
3736 + "header",
3737 + "query"
3738 + ],
3739 + "description": "Parameter type (header or query)",
3740 + "example": "header"
3741 + }
3742 + },
3743 + "required": [
3744 + "name",
3745 + "value",
3746 + "type"
3747 + ]
3748 },
3256 - "description": "The connected accounts to use for the session. This will override the default behaviour and use the given connected account when specific toolkits are being executed",
3257 - "example": {
3258 - "github": "ca_3m4n5o6p7q8r"
3259 - }
3749 + "description": "Additional HTTP headers or query parameters to include in the request",
3750 + "example": [
3751 + {
3752 + "name": "x-api-key",
3753 + "value": "abc123def456",
3754 + "type": "header"
3755 + },
3756 + {
3757 + "name": "filter",
3758 + "value": "active",
3759 + "type": "query"
3760 + }
3761 + ]
3762 },
3261 - "manage_connections": {
3763 + "custom_connection_data": {
3764 + "deprecated": true,
3765 "type": "object",
3766 "properties": {
3264 - "enable": {
3265 - "type": "boolean",
3266 - "nullable": true,
3267 - "default": true,
3268 - "description": "Whether to enable the connection manager for automatic connection handling. If true, we will provide a tool your agent can use to initiate connections to toolkits if it doesnt exist. If set to false, then you have to manage connections manually.",
3269 - "example": true
3270 - },
3271 - "callback_url": {
3767 + "authScheme": {
3768 "type": "string",
3273 - "format": "uri",
3274 - "description": "The URL to redirect to after a user completes authentication for a connected account. This allows you to handle the auth callback in your own application.",
3275 - "example": "https://your-app.com/auth/callback"
3769 + "enum": [
3770 + "OAUTH2",
3771 + "DCR_OAUTH",
3772 + "API_KEY",
3773 + "BASIC_WITH_JWT",
3774 + "BASIC",
3775 + "BEARER_TOKEN",
3776 + "OAUTH1",
3777 + "NO_AUTH",
3778 + "SERVICE_ACCOUNT",
3779 + "GOOGLE_SERVICE_ACCOUNT",
3780 + "S2S_OAUTH2"
3781 + ]
3782 },
3277 - "enable_wait_for_connections": {
3278 - "type": "boolean",
3279 - "nullable": true,
3280 - "default": false,
3281 - "description": "When true, the COMPOSIO_WAIT_FOR_CONNECTIONS tool is available for agents to poll connection status after sharing auth URLs. Default is false (disabled). May not work reliably with GPT models.",
3282 - "example": false
3783 + "toolkitSlug": {
3784 + "type": "string"
3785 },
3284 - "enable_connection_removal": {
3285 - "type": "boolean",
3286 - "nullable": true,
3287 - "default": true,
3288 - "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS to allow deleting connected accounts. Default true."
3289 - }
3290 - },
3291 - "default": {
3292 - "enable": true,
3293 - "enable_wait_for_connections": false,
3294 - "enable_connection_removal": true
3295 - },
3296 - "additionalProperties": false,
3297 - "description": "Configuration for connection management settings"
3298 - },
3299 - "tools": {
3300 - "type": "object",
3301 - "additionalProperties": {
3302 - "anyOf": [
3303 - {
3304 - "type": "object",
3305 - "properties": {
3306 - "enable": {
3307 - "type": "array",
3308 - "items": {
3309 - "type": "string"
3310 - },
3311 - "description": "Only these specific tools will be available for this toolkit",
3312 - "example": [
3313 - "GMAIL_SEND_EMAIL",
3314 - "GMAIL_FETCH_EMAILS"
3315 - ]
3316 - }
3786 + "val": {
3787 + "type": "object",
3788 + "properties": {
3789 + "subdomain": {
3790 + "type": "string"
3791 },
3318 - "required": [
3319 - "enable"
3320 - ],
3321 - "additionalProperties": false
3322 - },
3323 - {
3324 - "type": "object",
3325 - "properties": {
3326 - "disable": {
3327 - "type": "array",
3328 - "items": {
3329 - "type": "string"
3330 - },
3331 - "description": "These specific tools will be disabled for this toolkit",
3332 - "example": [
3333 - "SLACK_ADD_EMOJI"
3334 - ]
3335 - }
3792 + "your-domain": {
3793 + "type": "string"
3794 },
3337 - "required": [
3338 - "disable"
3339 - ],
3340 - "additionalProperties": false
3341 - },
3342 - {
3343 - "type": "object",
3344 - "properties": {
3345 - "tags": {
3346 - "anyOf": [
3347 - {
3348 - "type": "array",
3349 - "items": {
3350 - "type": "string",
3351 - "enum": [
3352 - "readOnlyHint",
3353 - "destructiveHint",
3354 - "idempotentHint",
3355 - "openWorldHint"
3356 - ]
3357 - }
3358 - },
3359 - {
3360 - "type": "object",
3361 - "properties": {
3362 - "enable": {
3363 - "type": "array",
3364 - "items": {
3365 - "type": "string",
3366 - "enum": [
3367 - "readOnlyHint",
3368 - "destructiveHint",
3369 - "idempotentHint",
3370 - "openWorldHint"
3371 - ]
3372 - },
3373 - "description": "Tags that the tool must have at least one of"
3374 - },
3375 - "disable": {
3376 - "type": "array",
3377 - "items": {
3378 - "type": "string",
3379 - "enum": [
3380 - "readOnlyHint",
3381 - "destructiveHint",
3382 - "idempotentHint",
3383 - "openWorldHint"
3384 - ]
3385 - },
3386 - "description": "Tags that the tool must NOT have any of"
3387 - }
3388 - }
3795 + "region": {
3796 + "type": "string"
3797 + },
3798 + "shop": {
3799 + "type": "string"
3800 + },
3801 + "account_url": {
3802 + "type": "string"
3803 + },
3804 + "COMPANYDOMAIN": {
3805 + "type": "string"
3806 + },
3807 + "extension": {
3808 + "type": "string"
3809 + },
3810 + "form_api_base_url": {
3811 + "type": "string"
3812 + },
3813 + "instanceEndpoint": {
3814 + "type": "string"
3815 + },
3816 + "api_url": {
3817 + "type": "string"
3818 + },
3819 + "borneo_dashboard_url": {
3820 + "type": "string"
3821 + },
3822 + "proxy_username": {
3823 + "type": "string"
3824 + },
3825 + "proxy_password": {
3826 + "type": "string"
3827 + },
3828 + "domain": {
3829 + "type": "string"
3830 + },
3831 + "version": {
3832 + "type": "string"
3833 + },
3834 + "dc": {
3835 + "type": "string"
3836 + },
3837 + "site_name": {
3838 + "type": "string"
3839 + },
3840 + "instanceName": {
3841 + "type": "string"
3842 + },
3843 + "account_id": {
3844 + "type": "string"
3845 + },
3846 + "your_server": {
3847 + "type": "string"
3848 + },
3849 + "server_location": {
3850 + "type": "string"
3851 + },
3852 + "base_url": {
3853 + "type": "string"
3854 + },
3855 + "state_prefix": {
3856 + "type": "string",
3857 + "maxLength": 40,
3858 + "description": "The oauth2 state prefix for the connection"
3859 + },
3860 + "long_redirect_url": {
3861 + "type": "boolean",
3862 + "description": "Whether to return the redirect url without shortening"
3863 + },
3864 + "access_token": {
3865 + "type": "string"
3866 + },
3867 + "id_token": {
3868 + "type": "string"
3869 + },
3870 + "token_type": {
3871 + "type": "string"
3872 + },
3873 + "refresh_token": {
3874 + "type": "string",
3875 + "nullable": true
3876 + },
3877 + "expires_in": {
3878 + "anyOf": [
3879 + {
3880 + "type": "number"
3881 + },
3882 + {
3883 + "type": "string"
3884 + },
3885 + {
3886 + "nullable": true,
3887 + "type": "object"
3888 + }
3889 + ]
3890 + },
3891 + "scope": {
3892 + "anyOf": [
3893 + {
3894 + "type": "string"
3895 + },
3896 + {
3897 + "type": "array",
3898 + "items": {
3899 + "type": "string"
3900 }
3390 - ],
3391 - "description": "MCP tags to filter tools. Array format is treated as enabled list. Object format supports both enabled and disabled lists.",
3392 - "example": {
3393 - "enable": [
3394 - "openWorldHint"
3395 - ],
3396 - "disable": [
3397 - "destructiveHint"
3398 - ]
3901 + },
3902 + {
3903 + "nullable": true,
3904 + "type": "object"
3905 }
3400 - }
3906 + ]
3907 },
3402 - "required": [
3403 - "tags"
3404 - ],
3405 - "additionalProperties": false
3406 - }
3407 - ]
3408 - },
3409 - "description": "Tool-level configuration per toolkit - either specify enable tools (whitelist), disable tools (blacklist), or filter by MCP tags for each toolkit",
3410 - "example": {
3411 - "gmail": {
3412 - "enable": [
3413 - "GMAIL_SEND_EMAIL",
3414 - "GMAIL_FETCH_EMAILS"
3415 - ]
3416 - },
3417 - "slack": {
3418 - "disable": [
3419 - "SLACK_ADD_EMOJI"
3420 - ]
3421 - },
3422 - "slack_bot": {
3423 - "tags": {
3424 - "enable": [
3425 - "destructiveHint"
3426 - ],
3427 - "disable": [
3428 - "openWorldHint"
3429 - ]
3430 - }
3431 - }
3432 - }
3433 - },
3434 - "tags": {
3435 - "anyOf": [
3436 - {
3437 - "type": "array",
3438 - "items": {
3439 - "type": "string",
3440 - "enum": [
3441 - "readOnlyHint",
3442 - "destructiveHint",
3443 - "idempotentHint",
3444 - "openWorldHint"
3445 - ]
3446 - }
3447 - },
3448 - {
3449 - "type": "object",
3450 - "properties": {
3451 - "enable": {
3452 - "type": "array",
3453 - "items": {
3454 - "type": "string",
3455 - "enum": [
3456 - "readOnlyHint",
3457 - "destructiveHint",
3458 - "idempotentHint",
3459 - "openWorldHint"
3460 - ]
3461 - },
3462 - "description": "Tags that the tool must have at least one of"
3908 + "webhook_signature": {
3909 + "type": "string"
3910 },
3464 - "disable": {
3465 - "type": "array",
3466 - "items": {
3467 - "type": "string",
3468 - "enum": [
3469 - "readOnlyHint",
3470 - "destructiveHint",
3471 - "idempotentHint",
3472 - "openWorldHint"
3473 - ]
3911 + "authed_user": {
3912 + "type": "object",
3913 + "properties": {
3914 + "access_token": {
3915 + "type": "string"
3916 + },
3917 + "scope": {
3918 + "type": "string"
3919 + }
3920 },
3475 - "description": "Tags that the tool must NOT have any of"
3476 - }
3477 - }
3478 - }
3479 - ],
3480 - "description": "Global MCP tool annotation hints for filtering. Array format is treated as enabled list. Object format supports both enabled (tool must have at least one) and disabled (tool must NOT have any) lists. Toolkit-level tags override this. Toolkit enabled/disabled lists take precedence over tag filtering.",
3481 - "example": {
3482 - "enable": [
3483 - "openWorldHint"
3484 - ],
3485 - "disable": [
3486 - "destructiveHint"
3487 - ]
3488 - }
3489 - },
3490 - "workbench": {
3491 - "type": "object",
3492 - "properties": {
3493 - "enable": {
3494 - "type": "boolean",
3495 - "default": true,
3496 - "description": "Set to false to disable the workbench entirely. When disabled, no code execution tools are available in the session.",
3497 - "example": true
3498 - },
3499 - "enable_proxy_execution": {
3500 - "type": "boolean",
3501 - "default": true,
3502 - "description": "Whether proxy execution is enabled. When enabled, workbench can call URLs and APIs directly.",
3503 - "example": true
3504 - },
3505 - "auto_offload_threshold": {
3506 - "type": "number",
3507 - "minimum": 0,
3508 - "exclusiveMinimum": true,
3509 - "description": "Character threshold for automatic offloading. When workbench response exceeds this threshold, it will be automatically offloaded. Default is picked automatically based on the response size.",
3510 - "example": 20000
3921 + "description": "for slack user scopes"
3922 + },
3923 + "client_id": {
3924 + "type": "string",
3925 + "description": "Dynamically registered client ID"
3926 + },
3927 + "client_secret": {
3928 + "type": "string",
3929 + "description": "Dynamically registered client secret"
3930 + },
3931 + "client_id_issued_at": {
3932 + "type": "number"
3933 + },
3934 + "client_secret_expires_at": {
3935 + "type": "number"
3936 + },
3937 + "generic_api_key": {
3938 + "type": "string"
3939 + },
3940 + "api_key": {
3941 + "type": "string"
3942 + },
3943 + "bearer_token": {
3944 + "type": "string"
3945 + },
3946 + "basic_encoded": {
3947 + "type": "string"
3948 + },
3949 + "username": {
3950 + "type": "string"
3951 + },
3952 + "password": {
3953 + "type": "string"
3954 + },
3955 + "token": {
3956 + "type": "string"
3957 + },
3958 + "oauth_token": {
3959 + "type": "string"
3960 + },
3961 + "oauth_token_secret": {
3962 + "type": "string"
3963 + },
3964 + "oauth_verifier": {
3965 + "type": "string"
3966 + },
3967 + "consumer_key": {
3968 + "type": "string"
3969 + },
3970 + "redirectUrl": {
3971 + "type": "string"
3972 + },
3973 + "callback_url": {
3974 + "type": "string"
3975 + },
3976 + "application_id": {
3977 + "type": "string"
3978 + },
3979 + "installation_id": {
3980 + "type": "string"
3981 + },
3982 + "private_key": {
3983 + "type": "string"
3984 + },
3985 + "credentials_json": {
3986 + "type": "string"
3987 + },
3988 + "expires_at": {
3989 + "type": "string"
3990 + }
3991 + },
3992 + "required": [
3993 + "access_token"
3994 + ],
3995 + "additionalProperties": {}
3996 }
3997 },
3513 - "default": {
3514 - "enable": true,
3515 - "enable_proxy_execution": true
3998 + "required": [
3999 + "authScheme",
4000 + "toolkitSlug",
4001 + "val"
4002 + ],
4003 + "additionalProperties": true
4004 + }
4005 + },
4006 + "required": [
4007 + "endpoint",
4008 + "method"
4009 + ]
4010 + }
4011 + }
4012 + }
4013 + },
4014 + "responses": {
4015 + "200": {
4016 + "description": "Successfully executed proxy request and received response",
4017 + "content": {
4018 + "application/json": {
4019 + "schema": {
4020 + "type": "object",
4021 + "properties": {
4022 + "data": {
4023 + "nullable": true,
4024 + "description": "The response data returned from the proxied API",
4025 + "example": {
4026 + "id": "123",
4027 + "name": "Resource Name",
4028 + "created_at": "2023-01-01T00:00:00Z"
4029 + },
4030 + "type": "object"
4031 },
3517 - "additionalProperties": false,
3518 - "description": "Configuration for workbench behavior"
3519 - },
3520 - "multi_account": {
3521 - "type": "object",
3522 - "properties": {
3523 - "enable": {
3524 - "type": "boolean",
3525 - "description": "When true, enables multi-account mode for this session. When not set, falls back to org/project-level configuration.",
3526 - "example": true
4032 + "binary_data": {
4033 + "type": "object",
4034 + "properties": {
4035 + "url": {
4036 + "type": "string",
4037 + "description": "URL to download binary content"
4038 + },
4039 + "content_type": {
4040 + "type": "string",
4041 + "description": "Content-Type of the binary data"
4042 + },
4043 + "size": {
4044 + "type": "number",
4045 + "description": "File size in bytes"
4046 + },
4047 + "expires_at": {
4048 + "type": "string",
4049 + "description": "ISO 8601 timestamp when the URL expires"
4050 + }
4051 },
3528 - "max_accounts_per_toolkit": {
3529 - "type": "integer",
3530 - "minimum": 2,
3531 - "maximum": 10,
3532 - "description": "Maximum number of connected accounts allowed per toolkit. Must be between 2 and 10.",
3533 - "example": 5
4052 + "required": [
4053 + "url",
4054 + "content_type",
4055 + "size"
4056 + ],
4057 + "description": "Binary body response data. Present when the response is a binary file."
4058 + },
4059 + "status": {
4060 + "type": "number",
4061 + "description": "The HTTP status code returned from the proxied API",
4062 + "example": 200
4063 + },
4064 + "headers": {
4065 + "type": "object",
4066 + "additionalProperties": {
4067 + "type": "string"
4068 },
3535 - "require_explicit_selection": {
3536 - "type": "boolean",
3537 - "description": "When true, the agent must explicitly select which account to use. When false (default), the first/default account is used automatically.",
3538 - "example": false
4069 + "description": "The HTTP headers returned from the proxied API",
4070 + "example": {
4071 + "content-type": "application/json",
4072 + "cache-control": "no-cache",
4073 + "host": "api.example.com"
4074 }
3540 - },
3541 - "additionalProperties": false,
3542 - "description": "Configure multi-account behavior. When enabled, users can connect multiple accounts per toolkit."
4075 + }
4076 },
3544 - "experimental": {
3545 - "type": "object",
3546 - "properties": {
3547 - "assistive_prompt_config": {
3548 - "type": "object",
3549 - "properties": {
3550 - "user_timezone": {
3551 - "type": "string",
3552 - "description": "IANA timezone identifier (e.g., 'America/New_York', 'Europe/London'). Used to customize the system prompt with timezone-aware instructions.",
3553 - "example": "America/New_York"
3554 - }
3555 - },
3556 - "additionalProperties": false,
3557 - "description": "Customize assistive prompt generation (e.g., timezone)."
3558 - },
3559 - "custom_toolkits": {
3560 - "type": "array",
3561 - "items": {
3562 - "type": "object",
3563 - "properties": {
3564 - "slug": {
3565 - "type": "string",
3566 - "minLength": 1,
3567 - "pattern": "^[a-zA-Z0-9_-]+$",
3568 - "description": "Unique slug for the toolkit. Must not conflict with existing Composio toolkit slugs. Alphanumeric, underscores, and hyphens only.",
3569 - "example": "ecommerce"
3570 - },
3571 - "name": {
3572 - "type": "string",
3573 - "minLength": 1,
3574 - "maxLength": 128,
3575 - "description": "Display name shown to the LLM and in search results.",
3576 - "example": "E-Commerce API"
3577 - },
3578 - "description": {
3579 - "type": "string",
3580 - "minLength": 1,
3581 - "maxLength": 2048,
3582 - "description": "Used for BM25 search matching and shown in toolkit connection statuses.",
3583 - "example": "Internal e-commerce API for order management and fulfillment"
3584 - },
3585 - "tools": {
3586 - "type": "array",
3587 - "items": {
3588 - "type": "object",
3589 - "properties": {
3590 - "slug": {
3591 - "type": "string",
3592 - "minLength": 1,
3593 - "pattern": "^[a-zA-Z0-9_-]+$",
3594 - "description": "Tool slug. Combined with toolkit slug to form LOCAL_<TOOLKIT>_<TOOL> (max 60 chars total).",
3595 - "example": "GET_CUSTOMER_ORDERS"
3596 - },
3597 - "name": {
3598 - "type": "string",
3599 - "minLength": 1,
3600 - "maxLength": 128,
3601 - "description": "Human-readable display name",
3602 - "example": "Get Customer Orders"
3603 - },
3604 - "description": {
3605 - "type": "string",
3606 - "minLength": 1,
3607 - "maxLength": 5120,
3608 - "description": "Used for BM25 search matching and shown to the LLM.",
3609 - "example": "Fetch recent orders for a customer by their email address"
3610 - },
3611 - "input_schema": {
3612 - "type": "object",
3613 - "additionalProperties": {},
3614 - "description": "Must have type: \"object\" and a properties field.",
3615 - "example": {
3616 - "type": "object",
3617 - "properties": {
3618 - "email": {
3619 - "type": "string",
3620 - "description": "Customer email"
3621 - }
3622 - },
3623 - "required": [
3624 - "email"
3625 - ]
3626 - }
3627 - },
3628 - "output_schema": {
3629 - "type": "object",
3630 - "additionalProperties": {},
3631 - "description": "Optional output schema for the tool response."
3632 - }
3633 - },
3634 - "required": [
3635 - "slug",
3636 - "name",
3637 - "description",
3638 - "input_schema"
3639 - ]
3640 - },
3641 - "minItems": 1,
3642 - "maxItems": 100,
3643 - "description": "Tools in this custom toolkit"
3644 - }
3645 - },
3646 - "required": [
3647 - "slug",
3648 - "name",
3649 - "description",
3650 - "tools"
3651 - ]
3652 - },
3653 - "description": "Custom toolkits with grouped tools. Toolkit slugs must not conflict with existing Composio toolkits. All tools are no-auth."
3654 - },
3655 - "custom_tools": {
3656 - "type": "array",
3657 - "items": {
3658 - "type": "object",
3659 - "properties": {
3660 - "slug": {
3661 - "type": "string",
3662 - "minLength": 1,
3663 - "pattern": "^[a-zA-Z0-9_-]+$",
3664 - "description": "Tool slug. Forms LOCAL_<TOOL> (standalone) or LOCAL_<TOOLKIT>_<TOOL> (extending). Max 60 chars total.",
3665 - "example": "GET_IMPORTANT_EMAILS"
3666 - },
3667 - "name": {
3668 - "type": "string",
3669 - "minLength": 1,
3670 - "maxLength": 128,
3671 - "description": "Human-readable display name",
3672 - "example": "Get Important Emails"
3673 - },
3674 - "description": {
3675 - "type": "string",
3676 - "minLength": 1,
3677 - "maxLength": 5120,
3678 - "description": "Used for BM25 search matching and shown to the LLM.",
3679 - "example": "Fetch emails marked as important from the last 24 hours"
3680 - },
3681 - "input_schema": {
3682 - "type": "object",
3683 - "additionalProperties": {},
3684 - "description": "Must have type: \"object\" and a properties field.",
3685 - "example": {
3686 - "type": "object",
3687 - "properties": {
3688 - "limit": {
3689 - "type": "number",
3690 - "description": "Max results to return"
3691 - }
3692 - }
3693 - }
3694 - },
3695 - "output_schema": {
3696 - "type": "object",
3697 - "additionalProperties": {},
3698 - "description": "JSON Schema describing tool output (optional)"
3699 - },
3700 - "extends_toolkit": {
3701 - "type": "string",
3702 - "minLength": 1,
3703 - "description": "If set, must be a valid Composio toolkit slug. The tool inherits that toolkit's auth/connection status. If omitted, the tool is standalone (no-auth).",
3704 - "example": "gmail"
3705 - }
3706 - },
3707 - "required": [
3708 - "slug",
3709 - "name",
3710 - "description",
3711 - "input_schema"
3712 - ]
3713 - },
3714 - "description": "Custom tools to include in search. Standalone tools need no auth. Tools with extends_toolkit inherit the Composio toolkit's connection."
3715 - }
4077 + "required": [
4078 + "status"
4079 + ]
4080 + }
4081 + }
4082 + }
4083 + },
4084 + "400": {
4085 + "description": "Bad request - Invalid request parameters or body format",
4086 + "content": {
4087 + "application/json": {
4088 + "schema": {
4089 + "$ref": "#/components/schemas/Error"
4090 + }
4091 + }
4092 + }
4093 + },
4094 + "401": {
4095 + "description": "Unauthorized - Authentication credentials are missing or invalid",
4096 + "content": {
4097 + "application/json": {
4098 + "schema": {
4099 + "$ref": "#/components/schemas/Error"
4100 + }
4101 + }
4102 + }
4103 + },
4104 + "403": {
4105 + "description": "Forbidden - Connected account does not have permission to access the requested resource",
4106 + "content": {
4107 + "application/json": {
4108 + "schema": {
4109 + "$ref": "#/components/schemas/Error"
4110 + }
4111 + }
4112 + }
4113 + },
4114 + "404": {
4115 + "description": "Not found - Resource not found or connected account not found",
4116 + "content": {
4117 + "application/json": {
4118 + "schema": {
4119 + "$ref": "#/components/schemas/Error"
4120 + }
4121 + }
4122 + }
4123 + },
4124 + "422": {
4125 + "description": "Unprocessable entity - Invalid state of the connected account",
4126 + "content": {
4127 + "application/json": {
4128 + "schema": {
4129 + "$ref": "#/components/schemas/Error"
4130 + }
4131 + }
4132 + }
4133 + },
4134 + "429": {
4135 + "description": "Too many requests - Rate limit exceeded on the connected account or proxy service",
4136 + "content": {
4137 + "application/json": {
4138 + "schema": {
4139 + "$ref": "#/components/schemas/Error"
4140 + }
4141 + }
4142 + }
4143 + },
4144 + "500": {
4145 + "description": "Internal server error - Something went wrong on the server",
4146 + "content": {
4147 + "application/json": {
4148 + "schema": {
4149 + "$ref": "#/components/schemas/Error"
4150 + }
4151 + }
4152 + }
4153 + },
4154 + "501": {
4155 + "description": "Not implemented - This operation is not supported for the requested connected account or authentication scheme",
4156 + "content": {
4157 + "application/json": {
4158 + "schema": {
4159 + "$ref": "#/components/schemas/Error"
4160 + }
4161 + }
4162 + }
4163 + },
4164 + "502": {
4165 + "description": "Bad gateway - Error communicating with the upstream API",
4166 + "content": {
4167 + "application/json": {
4168 + "schema": {
4169 + "$ref": "#/components/schemas/Error"
4170 + }
4171 + }
4172 + }
4173 + },
4174 + "504": {
4175 + "description": "Gateway timeout - Upstream API timed out",
4176 + "content": {
4177 + "application/json": {
4178 + "schema": {
4179 + "$ref": "#/components/schemas/Error"
4180 + }
4181 + }
4182 + }
4183 + }
4184 + },
4185 + "x-api-version": "3.1"
4186 + }
4187 + },
4188 + "/api/v3.1/tools/scopes/required": {
4189 + "post": {
4190 + "summary": "Get required scopes for tools",
4191 + "description": "Resolves required scopes for the specified tools at a given toolkit version. All requested tools must belong to the same toolkit. Returns the flat scope union plus per-tool structured scope requirements when available.",
4192 + "tags": [
4193 + "Tools"
4194 + ],
4195 + "operationId": "postToolsScopesRequired",
4196 + "security": [
4197 + {
4198 + "ApiKeyAuth": []
4199 + },
4200 + {
4201 + "UserApiKeyAuth": []
4202 + }
4203 + ],
4204 + "requestBody": {
4205 + "content": {
4206 + "application/json": {
4207 + "schema": {
4208 + "type": "object",
4209 + "properties": {
4210 + "tools": {
4211 + "type": "array",
4212 + "items": {
4213 + "type": "string"
4214 },
3717 - "additionalProperties": false,
3718 - "description": "Experimental features - not stable, may be modified or removed in future versions.",
3719 - "x-experimental": true
4215 + "minItems": 1,
4216 + "description": "Tool slugs to resolve scopes for. All tools must belong to the same toolkit.",
4217 + "example": [
4218 + "GMAIL_FETCH_EMAILS",
4219 + "GMAIL_SEND_EMAIL"
4220 + ]
4221 + },
4222 + "version": {
4223 + "type": "string",
4224 + "description": "Toolkit version to resolve scopes against for the requested toolkit. Defaults to the pinned HTTP version when omitted.",
4225 + "example": "latest"
4226 }
4227 },
4228 "required": [
3723 - "user_id"
4229 + "tools"
4230 ]
3725 - },
3726 - "examples": {
3727 - "Session with all toolkits": {
3728 - "value": {
3729 - "user_id": "user_123456789"
3730 - }
3731 - },
3732 - "Session with only specific toolkits": {
3733 - "value": {
3734 - "user_id": "user_123456789",
3735 - "toolkits": {
3736 - "enable": [
3737 - "gmail",
3738 - "slack"
3739 - ]
3740 - }
3741 - }
3742 - },
3743 - "Session with only specific toolkits disabled": {
3744 - "value": {
3745 - "user_id": "user_123456789",
3746 - "toolkits": {
3747 - "disable": [
3748 - "gmail",
3749 - "slack"
3750 - ]
3751 - }
3752 - }
3753 - },
3754 - "Session with connection manager enabled": {
3755 - "value": {
3756 - "user_id": "user_123456789",
3757 - "manage_connections": {
3758 - "enable": true
3759 - }
3760 - }
3761 - },
3762 - "Session with connection manager and specific toolkits": {
3763 - "value": {
3764 - "user_id": "user_123456789",
3765 - "toolkits": {
3766 - "enable": [
3767 - "gmail",
3768 - "slack"
3769 - ]
3770 - },
3771 - "manage_connections": {
3772 - "enable": true
3773 - }
3774 - }
3775 - },
3776 - "Session with custom callback URL": {
3777 - "value": {
3778 - "user_id": "user_123456789",
3779 - "toolkits": {
3780 - "enable": [
3781 - "github",
3782 - "slack"
3783 - ]
3784 - },
3785 - "manage_connections": {
3786 - "enable": true,
3787 - "callback_url": "https://your-app.com/auth/callback"
3788 - }
3789 - }
3790 - },
3791 - "Session with workbench configuration": {
3792 - "value": {
3793 - "user_id": "user_123456789",
3794 - "toolkits": {
3795 - "enable": [
3796 - "gmail"
3797 - ]
3798 - },
3799 - "workbench": {
3800 - "enable_proxy_execution": true,
3801 - "auto_offload_threshold": 10000
3802 - }
3803 - }
3804 - },
3805 - "Session with global tags filter": {
3806 - "value": {
3807 - "user_id": "user_123456789",
3808 - "toolkits": {
3809 - "enable": [
3810 - "gmail",
3811 - "slack"
3812 - ]
3813 - },
3814 - "tags": [
3815 - "readOnlyHint",
3816 - "idempotentHint"
3817 - ]
3818 - }
3819 - },
3820 - "Session with auth config overrides": {
3821 - "value": {
3822 - "user_id": "user_123456789",
3823 - "toolkits": {
3824 - "enable": [
3825 - "gmail",
3826 - "slack"
3827 - ]
3828 - },
3829 - "auth_configs": {
3830 - "gmail": "ac_1a2b3c4d5e6f",
3831 - "slack": "ac_7g8h9i0j1k2l"
3832 - }
3833 - }
3834 - },
3835 - "Session with connected account overrides": {
3836 - "value": {
3837 - "user_id": "user_123456789",
3838 - "toolkits": {
3839 - "enable": [
3840 - "gmail",
3841 - "slack"
3842 - ]
3843 - },
3844 - "connected_accounts": {
3845 - "gmail": "ca_1a2b3c4d5e6f",
3846 - "slack": "ca_7g8h9i0j1k2l"
3847 - }
3848 - }
3849 - },
3850 - "Session with comprehensive configuration": {
3851 - "value": {
3852 - "user_id": "user_123456789",
3853 - "toolkits": {
3854 - "enable": [
3855 - "gmail",
3856 - "slack",
3857 - "github"
3858 - ]
3859 - },
3860 - "auth_configs": {
3861 - "gmail": "ac_1a2b3c4d5e6f",
3862 - "slack": "ac_7g8h9i0j1k2l"

This file is too large to show in full.