Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: update toolkits and API data
Sushmithamalleshafcf52e09004
diff --git a/docs/content/reference/api-reference/organization/index.mdx b/docs/content/reference/api-reference/organization/index.mdxnew file mode 100644index 000000000..f209db49e--- /dev/null+++ b/docs/content/reference/api-reference/organization/index.mdx@@ -0,0 +1,14 @@+---+title: Organization+description: "Organization management"+---++{/* Auto-generated from OpenAPI spec. Do not edit directly. */}++Organization management++## Endpoints++| Endpoint | Quick Link |+|----------|------------|+| `GET /api/v3/org/usage/summary` | [Org usage summary](/reference/api-reference/organization/getOrgUsageSummary) |diff --git a/docs/content/reference/api-reference/projects/index.mdx b/docs/content/reference/api-reference/projects/index.mdxindex d1fb7a105..1ada4df42 100644--- a/docs/content/reference/api-reference/projects/index.mdx+++ b/docs/content/reference/api-reference/projects/index.mdx@@ -13,6 +13,7 @@ Projects API endpoints|----------|------------|| `GET /api/v3/org/project/config` | [Get project configuration](/reference/api-reference/projects/getOrgProjectConfig) || `PATCH /api/v3/org/project/config` | [Update project configuration](/reference/api-reference/projects/patchOrgProjectConfig) |+| `GET /api/v3/org/project/usage/summary` | [Project usage summary](/reference/api-reference/projects/getOrgProjectUsageSummary) || `POST /api/v3/org/owner/project/new` | [Create a new project](/reference/api-reference/projects/postOrgOwnerProjectNew) || `GET /api/v3/org/owner/project/list` | [List all projects](/reference/api-reference/projects/getOrgOwnerProjectList) || `GET /api/v3/org/owner/project/{nano_id}` | [Get project details by ID With Org Api key](/reference/api-reference/projects/getOrgOwnerProjectByNanoId) |diff --git a/docs/content/reference/api-reference/tools/index.mdx b/docs/content/reference/api-reference/tools/index.mdxindex 8d2757ce0..5fa246f09 100644--- a/docs/content/reference/api-reference/tools/index.mdx+++ b/docs/content/reference/api-reference/tools/index.mdx@@ -11,10 +11,9 @@ Tool execution endpoints| Endpoint | Quick Link ||----------|------------|+| `GET /api/v3/tools` | [List available tools](/reference/api-reference/tools/getTools) |+| `GET /api/v3/tools/enum` | [Get tool enum list](/reference/api-reference/tools/getToolsEnum) |+| `GET /api/v3/tools/{tool_slug}` | [Get tool by slug](/reference/api-reference/tools/getToolsByToolSlug) |+| `POST /api/v3/tools/execute/{tool_slug}` | [Execute tool](/reference/api-reference/tools/postToolsExecuteByToolSlug) |+| `POST /api/v3/tools/execute/{tool_slug}/input` | [Generate tool inputs from natural language](/reference/api-reference/tools/postToolsExecuteByToolSlugInput) || `POST /api/v3/tools/execute/proxy` | [Execute proxy request](/reference/api-reference/tools/postToolsExecuteProxy) |-| `GET /api/v3.1/tools` | [List available tools](/reference/api-reference/tools/getV3_1Tools) |-| `GET /api/v3.1/tools/enum` | [Get tool enum list](/reference/api-reference/tools/getV3_1ToolsEnum) |-| `GET /api/v3.1/tools/{tool_slug}` | [Get tool by slug](/reference/api-reference/tools/getV3_1ToolsByToolSlug) |-| `POST /api/v3.1/tools/execute/{tool_slug}` | [Execute tool](/reference/api-reference/tools/postV3_1ToolsExecuteByToolSlug) |-| `POST /api/v3.1/tools/execute/{tool_slug}/input` | [Generate tool inputs from natural language](/reference/api-reference/tools/postV3_1ToolsExecuteByToolSlugInput) |-| `POST /api/v3.1/tools/scopes/required` | [Get required scopes for tools](/reference/api-reference/tools/postV3_1ToolsScopesRequired) |diff --git a/docs/public/data/meta-tools.json b/docs/public/data/meta-tools.jsonindex 178425f72..44ccac381 100644--- a/docs/public/data/meta-tools.json+++ b/docs/public/data/meta-tools.json@@ -439,7 +439,7 @@"examples": ["GMAIL_SEND_EMAIL","SLACK_SEND_MESSAGE",- "GITHUB_CREATE_ISSUE"+ "GITHUB_CREATE_AN_ISSUE"],"minLength": 1,"title": "Tool Slug",@@ -547,7 +547,7 @@"log_id": "log_XYZ789","successful": true},- "tool_slug": "GITHUB_CREATE_ISSUE"+ "tool_slug": "GITHUB_CREATE_AN_ISSUE"},{"error": "No active connected account found for toolkit: gmail",diff --git a/docs/public/data/toolkits-list.json b/docs/public/data/toolkits-list.jsonindex 6772d2ee0..dc394d85b 100644--- a/docs/public/data/toolkits-list.json+++ b/docs/public/data/toolkits-list.json@@ -4,7 +4,7 @@"name": "Gmail","logo": "https://logos.composio.dev/api/gmail","category": "email",- "toolCount": 60,+ "toolCount": 62,"triggerCount": 2},{@@ -68,7 +68,7 @@"name": "Outlook","logo": "https://logos.composio.dev/api/outlook","category": "email",- "toolCount": 299,+ "toolCount": 300,"triggerCount": 5},{@@ -764,7 +764,7 @@"name": "Google Super","logo": "https://logos.composio.dev/api/googlesuper","category": "file management & storage",- "toolCount": 429,+ "toolCount": 431,"triggerCount": 20},{@@ -828,7 +828,7 @@"name": "Zoom","logo": "https://logos.composio.dev/api/zoom","category": "video conferencing",- "toolCount": 74,+ "toolCount": 104,"triggerCount": 11},{@@ -4327,6 +4327,14 @@"toolCount": 14,"triggerCount": 0},+ {+ "slug": "google_chat",+ "name": "Google Chat",+ "logo": "https://logos.composio.dev/api/google_chat",+ "category": "productivity",+ "toolCount": 36,+ "triggerCount": 0+ },{"slug": "google_classroom","name": "Google Classroom",@@ -6767,6 +6775,14 @@"toolCount": 6,"triggerCount": 0},+ {+ "slug": "sanity",+ "name": "Sanity",+ "logo": "https://logos.composio.dev/api/sanity",+ "category": "developer tools",+ "toolCount": 16,+ "triggerCount": 0+ },{"slug": "sap_successfactors","name": "SAP SuccessFactors",@@ -7447,6 +7463,14 @@"toolCount": 44,"triggerCount": 0},+ {+ "slug": "swarmsyncai",+ "name": "Swarmsyncai",+ "logo": "https://logos.composio.dev/api/swarmsyncai",+ "category": "developer tools",+ "toolCount": 91,+ "triggerCount": 0+ },{"slug": "sympla","name": "Sympla",@@ -7974,29 +7998,5 @@"category": "project management","toolCount": 2,"triggerCount": 0- },- {- "slug": "whautomate",- "name": "Whautomate",- "logo": "https://logos.composio.dev/api/whautomate",- "category": "ai chatbots",- "toolCount": 17,- "triggerCount": 0- },- {- "slug": "whoisfreaks",- "name": "Whoisfreaks",- "logo": "https://logos.composio.dev/api/whoisfreaks",- "category": "developer tools",- "toolCount": 17,- "triggerCount": 0- },- {- "slug": "whop",- "name": "Whop",- "logo": "https://logos.composio.dev/api/whop",- "category": "ecommerce",- "toolCount": 19,- "triggerCount": 0}]\ No newline at end of filediff --git a/docs/public/data/toolkits.json b/docs/public/data/toolkits.jsonindex 2080fab35..fdb4fe57d 100644--- a/docs/public/data/toolkits.json+++ b/docs/public/data/toolkits.json@@ -11,9 +11,9 @@"composioManagedAuthSchemes": ["OAUTH2"],- "toolCount": 60,+ "toolCount": 62,"triggerCount": 2,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GMAIL_ADD_LABEL_TO_EMAIL",@@ -45,6 +45,11 @@"name": "Create label","description": "Creates a new label with a unique name in the specified user's Gmail account. Returns a labelId (e.g., 'Label_123') required for downstream tools like GMAIL_ADD_LABEL_TO_EMAIL, GMAIL_BATCH_MODIFY_MESSAGES, and GMAIL_MODIFY_THREAD_LABELS — those tools do not accept display names."},+ {+ "slug": "GMAIL_CREATE_PROMPT_POST",+ "name": "Create Prompt Post",+ "description": "Send a one-shot prompt to the Sanity Content Agent. Stateless one-shot prompt endpoint. No thread management or message persistence. Ideal for simple, single-turn interactions. Use when you need to send a single prompt and receive a response without maintaining conversation context."+ },{"slug": "GMAIL_DELETE_DRAFT","name": "Delete Draft",@@ -310,6 +315,11 @@"name": "Update send-as alias","description": "Tool to update a send-as alias for a Gmail user. Use when you need to modify display name, signature, reply-to address, or SMTP settings for a send-as email address. Gmail sanitizes HTML signatures before saving. Addresses other than the primary can only be updated by service accounts with domain-wide authority."},+ {+ "slug": "GMAIL_UPDATE_USER_ATTRIBUTES_VALUES",+ "name": "Update User Attributes Values",+ "description": "Update user attribute values for a resource. Use this action to set or update custom attributes for a user within an organization or project. When setting a value for an attribute key that also exists in SAML, the Sanity value will take precedence and shadow the SAML value."+ },{"slug": "GMAIL_UPDATE_VACATION_SETTINGS","name": "Update Vacation Settings",@@ -550,7 +560,7 @@],"toolCount": 867,"triggerCount": 20,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GITHUB_ABORT_REPOSITORY_MIGRATION",@@ -5055,7 +5065,7 @@],"toolCount": 46,"triggerCount": 7,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLECALENDAR_ACL_DELETE",@@ -5391,7 +5401,7 @@],"toolCount": 48,"triggerCount": 5,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NOTION_ADD_MULTIPLE_PAGE_CONTENT",@@ -5601,7 +5611,7 @@{"slug": "NOTION_SEARCH_NOTION_PAGE","name": "Search Notion pages and databases",- "description": "Searches Notion pages and databases by title. Use specific search terms to find items by title (primary approach). KNOWN LIMITATIONS: (1) Search indexing is not immediate - recently shared items may not appear. (2) Search is not exhaustive - results may be incomplete. FALLBACK STRATEGY: If a specific title search returns empty results despite knowing items exist, try an empty query to list all accessible items and filter client-side."+ "description": "Searches Notion pages and databases by title. Use specific search terms to find items by title (primary approach). KNOWN LIMITATIONS: (1) Search indexing is not immediate - recently shared items may not appear. (2) Search is not exhaustive - results may be incomplete. (3) Database pages return all custom properties with full nested structures, which can create large responses for databases with many properties - use filter_properties to reduce response size. FALLBACK STRATEGY: If a specific title search returns empty results despite knowing items exist, try an empty query to list all accessible items and filter client-side."},{"slug": "NOTION_SEND_FILE_UPLOAD",@@ -5749,7 +5759,7 @@],"toolCount": 48,"triggerCount": 16,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLESHEETS_ADD_SHEET",@@ -6139,7 +6149,7 @@],"toolCount": 151,"triggerCount": 5,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SLACK_ADD_CALL_PARTICIPANTS",@@ -6998,7 +7008,7 @@],"toolCount": 121,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SUPABASE_ALPHA_CREATE_API_KEY",@@ -7711,9 +7721,9 @@"composioManagedAuthSchemes": ["OAUTH2"],- "toolCount": 299,+ "toolCount": 300,"triggerCount": 5,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "OUTLOOK_ADD_EVENT_ATTACHMENT",@@ -8028,7 +8038,7 @@{"slug": "OUTLOOK_CREATE_USER_EVENT_ATTACHMENT_UPLOAD_SESSION","name": "Create user event attachment upload session",- "description": "Tool to create an upload session for large event attachments in a user's default calendar. Use when attaching files larger than 3 MB to Outlook calendar events."+ "description": "Deprecated: Use OUTLOOK_CREATE_ME_EVENT_ATTACHMENT_UPLOAD_SESSION instead, which supports both /me and /users/{user_id} endpoints."},{"slug": "OUTLOOK_CREATE_USER_EVENT_CALENDAR_PERMISSION",@@ -8088,7 +8098,7 @@{"slug": "OUTLOOK_DELETE_CALENDAR_EVENT_ATTACHMENT","name": "Delete user calendar event attachment",- "description": "Tool to delete an attachment from an event in a specific user's calendar. Use when you need to remove a file or item attachment from an event in a calendar."+ "description": "Delete user calendar event attachment"},{"slug": "OUTLOOK_DELETE_CALENDAR_EVENT_FROM_SPECIFIC_CALENDAR",@@ -8333,7 +8343,7 @@{"slug": "OUTLOOK_DELETE_USER_CONTACT_EXTENSION","name": "Delete user contact extension",- "description": "Tool to delete an extension from a contact in a user's child contact folder. Use when removing custom extension data from a contact."+ "description": "Deprecated: Use OUTLOOK_DELETE_CONTACTS_EXTENSIONS instead, which supports both /me and /users/{user_id} endpoints."},{"slug": "OUTLOOK_DELETE_USER_EVENT_PERMANENTLY",@@ -8348,7 +8358,7 @@{"slug": "OUTLOOK_DELETE_USER_MESSAGE_ATTACHMENT","name": "Delete user message attachment",- "description": "Tool to delete an attachment from an Outlook message. Use when removing file or item attachments from existing messages."+ "description": "Deprecated: Use OUTLOOK_DELETE_ME_MESSAGES_ATTACHMENTS instead, which supports both /me and /users/{user_id} endpoints."},{"slug": "OUTLOOK_DISMISS_CALENDAR_EVENT_REMINDER",@@ -8870,6 +8880,11 @@"name": "List Outlook attachments","description": "Lists metadata (name, size, contentType, isInline — but not `contentBytes`) for all attachments of a specified Outlook email message. Returns fileAttachment, itemAttachment, and referenceAttachment types; only fileAttachment entries support download via OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT. Results include inline images and signatures — filter by `isInline == false` and check `contentType` to identify real document attachments. Results are nested under `data.response_data.value`."},+ {+ "slug": "OUTLOOK_LIST_PLACES",+ "name": "List places",+ "description": "Retrieves a collection of place objects defined in a tenant by type. Places can include rooms, workspaces, buildings, floors, sections, desks, and room lists. When room_list_id is provided, returns only rooms or workspaces within that specific room list using the /places/{roomListId}/microsoft.graph.roomlist/rooms (or /workspaces) endpoint. Use this action when you need to discover available physical spaces or locations within an organization. Note: Before using this API, ensure that the Places settings are properly configured in the tenant."+ },{"slug": "OUTLOOK_LIST_PRIMARY_CALENDAR_PERMISSIONS","name": "List primary calendar permissions",@@ -9133,7 +9148,7 @@{"slug": "OUTLOOK_UPDATE_USER_CALENDAR_CALENDAR_EVENT","name": "Update user calendar event",- "description": "Tool to update an event in a specific user's calendar. Use when you need to modify calendar event properties in a specific calendar for any user."+ "description": "Deprecated: Use OUTLOOK_UPDATE_CALENDAR_EVENT_IN_CALENDAR instead, which supports both /me and /users/{user_id} endpoints and additional fields (is_all_day, importance, sensitivity, reminders)."},{"slug": "OUTLOOK_UPDATE_USER_CALENDAR_EVENT",@@ -9173,7 +9188,7 @@{"slug": "OUTLOOK_UPDATE_USER_EVENT_EXTENSION","name": "Update user event extension",- "description": "Tool to update an open extension on a calendar event for a specific user in a calendar group. Use when modifying custom properties stored in an event extension for user calendar events."+ "description": "Deprecated: Use OUTLOOK_UPDATE_EVENT_EXTENSION_IN_CALENDAR_GROUP instead, which supports both /me and /users/{user_id} endpoints and uses the correct @odata.type prefix."},{"slug": "OUTLOOK_UPDATE_USER_EVENTS_EXTENSIONS",@@ -9394,7 +9409,7 @@],"toolCount": 79,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "TWITTER_ADD_LIST_MEMBER",@@ -9866,7 +9881,7 @@],"toolCount": 89,"triggerCount": 7,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE",@@ -10416,7 +10431,7 @@],"toolCount": 35,"triggerCount": 10,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLEDOCS_COPY_DOCUMENT",@@ -10712,7 +10727,7 @@],"toolCount": 233,"triggerCount": 2,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "HUBSPOT_ADD_ASSET_ASSOCIATION",@@ -11989,7 +12004,7 @@],"toolCount": 33,"triggerCount": 3,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "LINEAR_CREATE_ATTACHMENT",@@ -12263,7 +12278,7 @@],"toolCount": 25,"triggerCount": 6,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "AIRTABLE_CREATE_BASE",@@ -12851,7 +12866,7 @@],"toolCount": 97,"triggerCount": 3,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "JIRA_ADD_ATTACHMENT",@@ -12911,7 +12926,7 @@{"slug": "JIRA_CREATE_ISSUE","name": "Create Issue",- "description": "Creates a new Jira issue (e.g., bug, task, story) in a specified project. IMPORTANT: Different Jira projects may have custom required fields beyond the standard ones (summary, project_key, issue_type). If issue creation fails with 'field X is required', use JIRA_GET_FIELDS to discover available fields for your project, or check your Jira project's configuration. Custom fields can be provided via the 'additional_properties' parameter as a JSON string (e.g., '{\"customfield_12345\": \"value\"}'). Rapid bulk creation may trigger HTTP 429 rate limiting; throttle calls and use exponential backoff on 429 responses."+ "description": "Creates a new Jira issue (e.g., bug, task, story) in a specified project. IMPORTANT: Different Jira projects may have custom required fields beyond the standard ones (summary, project_key, issue_type). If issue creation fails with 'field X is required', use JIRA_GET_CREATE_METADATA_ISSUE_TYPE_FIELDS (requires projectIdOrKey and issueTypeId parameters) to discover available fields for your project, or check your Jira project's configuration. Custom fields can be provided via the 'additional_properties' parameter as a JSON string (e.g., '{\"customfield_12345\": \"value\"}'). Rapid bulk creation may trigger HTTP 429 rate limiting; throttle calls and use exponential backoff on 429 responses."},{"slug": "JIRA_CREATE_ISSUE_LINK",@@ -13783,7 +13798,7 @@],"toolCount": 50,"triggerCount": 4,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "YOUTUBE_ADD_VIDEO_TO_PLAYLIST",@@ -14123,7 +14138,7 @@],"toolCount": 88,"triggerCount": 5,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SLACKBOT_ADD_CALL_PARTICIPANTS",@@ -14664,7 +14679,7 @@],"toolCount": 560,"triggerCount": 6,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CANVAS_ABORT_QUIZ_REPORT_GENERATION",@@ -17603,7 +17618,7 @@],"toolCount": 107,"triggerCount": 0,- "version": "20260407_01",+ "version": "20260410_00","tools": [{"slug": "BITBUCKET_APPROVE_PULL_REQUEST",@@ -18207,7 +18222,7 @@],"toolCount": 18,"triggerCount": 5,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLETASKS_BATCH_EXECUTE",@@ -18392,7 +18407,7 @@],"toolCount": 16,"triggerCount": 1,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DISCORD_GET_CURRENT_USER_APPLICATION_ENTITLEMENTS",@@ -18548,7 +18563,7 @@],"toolCount": 53,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FIGMA_ADD_A_COMMENT_TO_A_FILE",@@ -19068,7 +19083,7 @@],"toolCount": 23,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "REDDIT_CREATE_REDDIT_POST",@@ -20237,7 +20252,7 @@],"toolCount": 144,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "WRIKE_BULK_MODIFY_GROUPS",@@ -21165,7 +21180,7 @@],"toolCount": 207,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SENTRY_ACCESS_PROJECT_INFORMATION",@@ -22266,7 +22281,7 @@],"toolCount": 15,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "SNOWFLAKE_CANCEL_STATEMENT_EXECUTION",@@ -23338,7 +23353,7 @@],"toolCount": 164,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MICROSOFT_TEAMS_ADD_CHAT_MEMBER",@@ -24250,7 +24265,7 @@],"toolCount": 153,"triggerCount": 1,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "ASANA_ADD_FOLLOWERS_TO_PROJECT",@@ -25249,7 +25264,7 @@],"toolCount": 394,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SHOPIFY_ACTIVATE_ONE_TIME_CHARGE",@@ -27328,7 +27343,7 @@],"toolCount": 22,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "LINKEDIN_CREATE_ARTICLE_OR_URL_SHARE",@@ -27508,7 +27523,7 @@],"toolCount": 22,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLE_MAPS_AUTOCOMPLETE",@@ -27711,7 +27726,7 @@],"toolCount": 60,"triggerCount": 9,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ONE_DRIVE_CHECKIN_ITEM",@@ -28146,7 +28161,7 @@],"toolCount": 338,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DOCUSIGN_ADD_CONTACTS_TO_CONTACTS_LIST",@@ -30824,7 +30839,7 @@],"toolCount": 216,"triggerCount": 7,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SALESFORCE_ACCOUNT_CREATION_WITH_CONTENT_TYPE_OPTION",@@ -32074,7 +32089,7 @@],"toolCount": 55,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "CALENDLY_CANCEL_SCHEDULED_EVENT",@@ -34155,7 +34170,7 @@],"toolCount": 48,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "APOLLO_ADD_CONTACTS_TO_SEQUENCE",@@ -35571,7 +35586,7 @@],"toolCount": 506,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "POSTHOG_ADD_DASHBOARD_COLLABORATORS_WITH_ACCESS_LEVEL",@@ -38155,7 +38170,7 @@],"toolCount": 163,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CLICKUP_ADD_DEPENDENCY",@@ -39060,7 +39075,7 @@],"toolCount": 21,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BREVO_CREATE_A_COMPANY",@@ -39258,7 +39273,7 @@],"toolCount": 422,"triggerCount": 7,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "STRIPE_ACCEPT_QUOTE",@@ -41494,7 +41509,7 @@],"toolCount": 225,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "KLAVIYO_ADD_PROFILE_TO_LIST",@@ -42847,7 +42862,7 @@],"toolCount": 275,"triggerCount": 4,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MAILCHIMP_ADD_AUTOMATION",@@ -44321,7 +44336,7 @@],"toolCount": 108,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ATTIO_ASSERT_COMPANY",@@ -44930,7 +44945,7 @@],"toolCount": 15,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLEMEET_CREATE_MEET",@@ -45136,7 +45151,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "ZOHO_CONVERT_ZOHO_LEAD",@@ -45436,7 +45451,7 @@],"toolCount": 177,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DROPBOX_ACTIVATE_TEAM_FOLDER",@@ -47143,7 +47158,7 @@],"toolCount": 62,"triggerCount": 20,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CONFLUENCE_ADD_CONTENT_LABEL",@@ -49528,7 +49543,7 @@],"toolCount": 50,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "MIXPANEL_ADD_UNIQUE_TO_PROFILE_LIST_PROPERTY",@@ -49836,7 +49851,7 @@],"toolCount": 110,"triggerCount": 4,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "CODA_ADD_A_CATEGORY_FOR_PACK",@@ -50911,7 +50926,7 @@],"toolCount": 54,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "AMPLITUDE_ASSIGN_ANNOTATIONS_TO_CATEGORY",@@ -52206,7 +52221,7 @@],"toolCount": 63,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLEBIGQUERY_CANCEL_JOB",@@ -52656,7 +52671,7 @@],"toolCount": 28,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "COINBASE_GET_ASSET_DETAILS",@@ -52848,7 +52863,7 @@],"toolCount": 125,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MONDAY_ACCOUNT_TRIGGER_STATISTICS",@@ -53539,7 +53554,7 @@],"toolCount": 21,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SEMANTICSCHOLAR_DETAILS_ABOUT_AN_AUTHOR",@@ -55626,7 +55641,7 @@],"toolCount": 401,"triggerCount": 3,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "PIPEDRIVE_ADD_ACTIVITY_TYPE",@@ -57754,7 +57769,7 @@],"toolCount": 41,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "BAMBOOHR_ATS_CREATE_CANDIDATE",@@ -58069,7 +58084,7 @@],"toolCount": 17,"triggerCount": 1,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "WHATSAPP_CREATE_MESSAGE_TEMPLATE",@@ -58269,7 +58284,7 @@],"toolCount": 16,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DYNAMICS365_DYNAMICSCRM_CREATE_ACCOUNT",@@ -58427,7 +58442,7 @@],"toolCount": 20,"triggerCount": 2,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "ZENDESK_COUNT_ZENDESK_ORGANIZATIONS",@@ -58834,7 +58849,7 @@],"toolCount": 52,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "METAADS_CREATE_AD",@@ -59183,7 +59198,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ZENROWS_GET_API_USAGE",@@ -59296,9 +59311,9 @@"composioManagedAuthSchemes": ["OAUTH2"],- "toolCount": 429,+ "toolCount": 431,"triggerCount": 20,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLESUPER_ACL_DELETE",@@ -59705,6 +59720,11 @@"name": "Create Google Slides Presentation","description": "Tool to create a blank Google Slides presentation. Use when you need to initialize a new presentation with a specific title, locale, or page size."},+ {+ "slug": "GOOGLESUPER_CREATE_PROMPT_POST",+ "name": "Create Prompt Post",+ "description": "Send a one-shot prompt to the Sanity Content Agent. Stateless one-shot prompt endpoint. No thread management or message persistence. Ideal for simple, single-turn interactions. Use when you need to send a single prompt and receive a response without maintaining conversation context."+ },{"slug": "GOOGLESUPER_CREATE_RECURRING_AUDIENCE_LIST","name": "Create Recurring Audience List",@@ -60568,7 +60588,7 @@{"slug": "GOOGLESUPER_LIST_CALCULATED_METRICS","name": "List Calculated Metrics",- "description": "Tool to list CalculatedMetrics on a property. Use when you need to retrieve all calculated metrics configured for a given property."+ "description": "List Calculated Metrics"},{"slug": "GOOGLESUPER_LIST_CALENDARS",@@ -60618,7 +60638,7 @@{"slug": "GOOGLESUPER_LIST_CUSTOM_DIMENSIONS","name": "List Custom Dimensions",- "description": "Tool to list CustomDimensions on a property. Use when you need to retrieve custom dimensions configured for a given property."+ "description": "List Custom Dimensions"},{"slug": "GOOGLESUPER_LIST_CUSTOM_METRICS",@@ -61385,6 +61405,11 @@"name": "Update Team Drive (Deprecated)","description": "Tool to update a Team Drive's metadata. Deprecated: Use the drives.update endpoint instead. Use when you need to modify Team Drive properties."},+ {+ "slug": "GOOGLESUPER_UPDATE_USER_ATTRIBUTES_VALUES",+ "name": "Update User Attributes Values",+ "description": "Update user attribute values for a resource. Use this action to set or update custom attributes for a user within an organization or project. When setting a value for an attribute key that also exists in SAML, the Sanity value will take precedence and shadow the SAML value."+ },{"slug": "GOOGLESUPER_UPDATE_VACATION_SETTINGS","name": "Update Vacation Settings",@@ -61633,7 +61658,7 @@],"toolCount": 5,"triggerCount": 0,- "version": "20260319_00",+ "version": "20260408_00","tools": [{"slug": "BROWSER_TOOL_CREATE_TASK",@@ -61658,7 +61683,7 @@{"slug": "BROWSER_TOOL_WATCH_TASK","name": "Watch Browser Task",- "description": "Poll a browser task to check progress and get results. Call this after CreateTask to monitor the task: - status='started' means still running, poll again - status='finished' means done, check output and is_success - status='stopped' means aborted Returns what the agent is doing (current_goal, current_url), screenshots from each step, and any files generated. If the agent is going wrong, use StopTask to kill it and start fresh."+ "description": "Poll a browser task to check progress and get results. Call this after CreateTask to monitor the task: - status='started' means still running, poll again - status='finished' means done, check output and is_success - status='stopped' means aborted - status='failed' means an error occurred Returns what the agent is doing (current_goal, current_url), screenshots from each step, and any files generated. If the agent is going wrong, use StopTask to kill it and start fresh."}],"triggers": [],@@ -62632,9 +62657,9 @@"composioManagedAuthSchemes": ["OAUTH2"],- "toolCount": 74,+ "toolCount": 104,"triggerCount": 11,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ZOOM_ADD_A_MEETING_REGISTRANT",@@ -62646,6 +62671,21 @@"name": "Add a webinar registrant","description": "Registers a participant for a Zoom webinar that has registration enabled. **Prerequisites:** - The webinar host must have a **Pro or higher plan with Webinar add-on** - this will NOT work with basic/free accounts - The webinar must have registration enabled (approval_type = 0 for automatic or 1 for manual approval) - Registration type must be properly configured (1=once for all, 2=each occurrence, 3=choose occurrences) **Required fields:** webinarId, first_name, email **Optional fields:** last_name, address, city, state, zip, country, phone, comments, industry, job_title, org, language, occurrence_ids, source_id **Common errors:** - \"Webinar plan is missing\" - The host needs a Zoom webinar license/add-on - \"Registration has not been enabled\" - Enable registration via webinar settings with approval_type = 0 or 1 - \"Webinar not found\" (404) - Invalid webinar ID or webinar has ended - \"Host cannot register\" - The webinar host cannot register themselves as an attendee"},+ {+ "slug": "ZOOM_ADD_PROJECT_COLLABORATORS",+ "name": "Add project collaborators",+ "description": "Adds one or more collaborators to a whiteboard project. Use this action when you want to invite team members or external users to collaborate on a specific whiteboard project. Project owners or authorized users can add collaborators with different permission levels (owner, editor, or viewer). **Prerequisites:** - The user must be the project owner or have admin permissions - The target user must have a Zoom account - The whiteboard project must exist and be accessible **Required fields:** project_id, collaborators (list with at least one user) **Optional fields:** skip_notifications, invite_message **Common errors:** - \"Whiteboard plan is missing\" - Whiteboard add-on is required - \"User not found\" - The collaborator's email is not associated with a Zoom account - \"Project not found\" - Invalid project ID - \"Invalid collaborator role\" - Role value must be 1, 2, or 3"+ },+ {+ "slug": "ZOOM_ADD_WHITEBOARD_COLLABORATOR",+ "name": "Add whiteboard collaborator",+ "description": "Adds one or more collaborators to a whiteboard. Use this action when you need to invite users or team chat channels to collaborate on a specific whiteboard. Supports individual user invites (via email) and team chat channel invites (via channel_id). Collaborators are assigned a role that determines their permission level. On success, returns the list of collaborators that were added. Use this action when you want to share a whiteboard to new users or team chat channels and assign them specific permission levels (owner, co-owner, editor, commenter, or viewer)."+ },+ {+ "slug": "ZOOM_APPLY_CLASSIFICATION_TO_WHITEBOARD",+ "name": "Apply classification to whiteboard",+ "description": "Applies or updates a classification label on a whiteboard. Use this action when you need to assign or change a security classification label on an existing whiteboard. Each whiteboard can only have one classification label at a time — if the whiteboard already has a label, it will be replaced with the new one. Rate limit: Light. Required scopes: whiteboard:write:admin, whiteboard:write, whiteboard:update:whiteboard_classification, or whiteboard:update:whiteboard_classification:admin."+ },{"slug": "ZOOM_CREATE_A_MEETING","name": "Create a meeting",@@ -62666,6 +62706,21 @@"name": "Create IQ user conversation","description": "DEPRECATED: Use ZOOM_CREATE_ZRA_USER_CONVERSATION instead (Zoom rebranded IQ to ZRA). Tool to create a Zoom IQ conversation for a user. Use when you need to create a new conversation entry in Zoom Revenue Accelerator for a specific user."},+ {+ "slug": "ZOOM_CREATE_PROJECT",+ "name": "Create whiteboard project",+ "description": "Creates a new whiteboard project in Zoom. Use when you need to organize and group whiteboards together, optionally adding collaborators and initializing the project with existing whiteboards."+ },+ {+ "slug": "ZOOM_CREATE_WHITEBOARD",+ "name": "Create a whiteboard",+ "description": "Creates a new whiteboard for the authenticated user. Use when you need to create a blank whiteboard that can be shared and collaborated on with others. The whiteboard will be associated with the user making the API call. **Required scope:** whiteboard:write or whiteboard:write:whiteboard **Notes:** - If no name is provided, the whiteboard will be named \"Untitled\" - After creation, the whiteboard can be shared with collaborators using share settings"+ },+ {+ "slug": "ZOOM_CREATE_WHITEBOARD_EXPORT",+ "name": "Create whiteboard export",+ "description": "Creates an export task to generate PDF exports and audit logs for specified whiteboards. The exported content is bundled into a ZIP file containing the whiteboard PDFs and audit logs. Use when you need to export one or more whiteboards for archival, sharing, or compliance purposes. Use this action when you want to export whiteboard content as a downloadable ZIP file containing PDF exports and audit logs. After creating the export task, poll the GetWhiteboardExportStatus action using the returned task_id until the status changes to 'successed', then download the export using the DownloadWhiteboardExport action. Note: This action only initiates the export process. The export is processed asynchronously. You must poll GetWhiteboardExportStatus to check when the export is ready, then use DownloadWhiteboardExport to retrieve the actual ZIP file."+ },{"slug": "ZOOM_CREATE_ZRA_CONVERSATION","name": "Create ZRA conversation",@@ -62731,6 +62786,26 @@"name": "Delete meeting recordings","description": "Deletes all cloud recordings for a meeting or webinar. Requires the account to have Cloud Recording enabled. Rate limit: Light. Required scopes: cloud_recording:delete:meeting_recording or cloud_recording:delete:meeting_recording:admin."},+ {+ "slug": "ZOOM_DELETE_PROJECT",+ "name": "Delete whiteboard project",+ "description": "Deletes a whiteboard project by its ID. Deleting a project removes all associated whiteboards from the project. Use when you need to permanently remove a whiteboard project and all its contents from Zoom. This action is irreversible — once the project is deleted, it cannot be recovered, and all associated whiteboards will be removed."+ },+ {+ "slug": "ZOOM_DELETE_PROJECT_COLLABORATOR",+ "name": "Remove project collaborator",+ "description": "Removes a collaborator from a whiteboard project. Use this action when you need to revoke a user's access to a specific whiteboard project. This action is irreversible — once a collaborator is removed, they will no longer have access to the project's whiteboards unless re-added. **Note:** The authenticated user must be the project owner, co-owner, or have admin permissions to remove collaborators."+ },+ {+ "slug": "ZOOM_DELETE_WHITEBOARD",+ "name": "Delete whiteboard",+ "description": "Deletes a whiteboard by its unique identifier. Use when you need to permanently remove a specific whiteboard from Zoom. This action is irreversible — once deleted, the whiteboard cannot be recovered. Requires the user to have whiteboard delete permissions."+ },+ {+ "slug": "ZOOM_DELETE_WHITEBOARD_COLLABORATOR",+ "name": "Delete whiteboard collaborator",+ "description": "Removes a collaborator from a whiteboard. Use this action when you need to revoke a user's access to a specific whiteboard by removing them as a collaborator. This action is irreversible for the collaborator's access — the collaborator will no longer be able to view or edit the whiteboard unless added back. Requires the user to have whiteboard admin or owner permissions. **Prerequisites:** - The authenticated user must be the whiteboard owner, co-owner, or have admin permissions - The collaborator must currently have access to the whiteboard **Common errors:** - \"Whiteboard not found\" - Invalid whiteboard ID - \"Collaborator not found\" - The specified collaborator does not have access to the whiteboard - \"Insufficient permissions\" - User lacks permission to remove collaborators"+ },{"slug": "ZOOM_DELETE_ZRA_CONVERSATION","name": "Delete ZRA conversation",@@ -62751,6 +62826,21 @@"name": "Delete ZRA deal activities","description": "Tool to delete activities from a Zoom Revenue Accelerator (ZRA) deal. Use when you need to remove one or more activities associated with a specific deal by providing the deal ID and comma-separated activity IDs."},+ {+ "slug": "ZOOM_DOWNLOAD_IMPORTED_WHITEBOARD_FILE",+ "name": "Download imported whiteboard file",+ "description": "Downloads a specific file that was imported into a whiteboard, including images, PDFs, DOCX, and other supported file formats. Use this action when you need to retrieve the actual file content of an imported whiteboard attachment. This action streams the file content directly from Zoom's servers."+ },+ {+ "slug": "ZOOM_DOWNLOAD_WHITEBOARD_EXPORT",+ "name": "Download whiteboard export",+ "description": "Downloads the exported whiteboard content for a completed whiteboard export task. The task must have completed successfully before calling this action. Use when you need to retrieve the actual whiteboard content (drawings, annotations, images) that was exported using the Create whiteboard export API. Returns a ZIP archive containing the whiteboard files. This action is read-only and does not modify any whiteboard data. Use this action when you have created a whiteboard export task and want to download the resulting ZIP file containing the exported content."+ },+ {+ "slug": "ZOOM_DOWNLOAD_WHITEBOARD_SESSION_ACTIVITY",+ "name": "Download whiteboard session activity",+ "description": "Downloads the activity archive file for a whiteboard archiving session. This action retrieves the PDF file containing whiteboard session activity data based on the provided file path. Use when you need to retrieve the archived activity file for a completed whiteboard session. Use this action when you have obtained a file path from the List whiteboard sessions activities endpoint and want to download the actual activity archive file. The file is returned as a PDF stream. This action is read-only and does not modify any data. Note: Files may expire and return 404 if the download URL has expired."+ },{"slug": "ZOOM_GET_A_MEETING","name": "Get a meeting",@@ -62826,11 +62916,31 @@"name": "Get past meeting participants","description": "Retrieves the list of participants who attended a past (ended) Zoom meeting. Requires a paid Zoom account (Pro or higher). Meeting must have ended with at least one participant (excluding solo meetings). Use meeting ID for the latest instance, or instance UUID for a specific occurrence."},+ {+ "slug": "ZOOM_GET_PROJECT",+ "name": "Get whiteboard project",+ "description": "Retrieves detailed information about a specific whiteboard project by its ID. Returns project metadata including name, description, owner, sharing settings, and timestamps. Use this action when you need to view details about a Zoom Whiteboard project or retrieve its configuration."+ },{"slug": "ZOOM_GET_USER","name": "Get a user","description": "Retrieves detailed information about a specific Zoom user by ID, email, or 'me'. Returns user type, role, license info, and account metadata. Use when you need to check user type/license or retrieve user profile details."},+ {+ "slug": "ZOOM_GET_WHITEBOARD",+ "name": "Get a whiteboard",+ "description": "Retrieves details about a specific whiteboard document. Returns comprehensive whiteboard information including name, creation/modification dates, share settings, and classification. Use this action when you need to fetch metadata for a specific whiteboard by its ID. Requires whiteboard:read or whiteboard:read:admin scope."+ },+ {+ "slug": "ZOOM_GET_WHITEBOARD_EXPORT_STATUS",+ "name": "Get whiteboard export status",+ "description": "Retrieves the status of a whiteboard export task by its task ID. This action queries the current state of an export request initiated via the create whiteboard export action. Use this action when you need to check whether a whiteboard export has completed processing, is still being generated, or has failed. Poll this endpoint until status changes from 'processing' to either 'successed' or 'failed'. The export is processed asynchronously, so you should poll this endpoint periodically to check for completion before attempting to download the exported file."+ },+ {+ "slug": "ZOOM_GET_WHITEBOARD_SESSION",+ "name": "Get a whiteboard session",+ "description": "Retrieves detailed information about a specific whiteboard session by its session ID. Returns session metadata including start/end times, whiteboard info, and a list of activities performed during the session. Use this action when you need to retrieve session details, activity logs, or participant information for a Zoom Whiteboard session. For large result sets, use pagination with next_page_token."+ },{"slug": "ZOOM_GET_ZRA_CONVERSATION_COMMENTS","name": "Get ZRA conversation comments",@@ -62851,6 +62961,11 @@"name": "Get ZRA deal activities","description": "Tool to retrieve activities associated with a Zoom Revenue Accelerator (ZRA) deal. Use when you need to list all activities for a specific deal in ZRA."},+ {+ "slug": "ZOOM_IMPORT_WHITEBOARD",+ "name": "Import whiteboard",+ "description": "Initiates an import of a whiteboard from an external source (Miro, Mural, or Visio files). The import is processed asynchronously and returns a task_id for tracking progress. Use this task_id to poll for import completion and retrieve the resulting whiteboard. Use this action when you need to convert an externally created whiteboard into a Zoom whiteboard. The file must already be uploaded to Zoom before initiating the import."+ },{"slug": "ZOOM_LIST_ALL_RECORDINGS","name": "List all recordings",@@ -62896,6 +63011,16 @@"name": "List past meeting instances","description": "Tool to retrieve all UUIDs for past instances of a given meeting. Use when you need to get the list of all occurrences (instances) of a recurring meeting that have already ended. Each instance has a unique UUID that can be used to query specific details about that occurrence."},+ {+ "slug": "ZOOM_LIST_PROJECT_COLLABORATORS",+ "name": "List project collaborators",+ "description": "Lists all collaborators for a whiteboard project, including their roles and permissions. Use this action when you need to view who has access to a whiteboard project and what permission level each collaborator has. This action is read-only and does not modify any data. **Note**: This action requires the whiteboard project to exist and the authenticated user to have appropriate permissions (project owner, co-owner, or admin)."+ },+ {+ "slug": "ZOOM_LIST_PROJECTS",+ "name": "List whiteboard projects",+ "description": "Lists all whiteboard projects accessible to the user. Returns project metadata including ID, name, owner, and timestamps. Use this action when you need to retrieve whiteboard projects with optional filtering by owner or name search. Supports pagination through the next_page_token parameter."+ },{"slug": "ZOOM_LIST_USERS_COLLABORATION_DEVICES","name": "List user collaboration devices",@@ -62921,6 +63046,11 @@"name": "List webinars","description": "The API lists all scheduled webinars for Zoom users with a webinar plan, using `me` for user-level apps. It only shows unexpired webinars for hosts broadcasting to up to 10,000 attendees. Requires Pro plan upwards and specific scopes. Rate limit: MEDIUM."},+ {+ "slug": "ZOOM_LIST_WHITEBOARDS",+ "name": "List whiteboards",+ "description": "Lists all whiteboards accessible to the user. Returns whiteboard metadata including ID, name, owner, and timestamps. Use this action when you need to retrieve whiteboards with optional filtering by owner, date range, project, or name search. Supports pagination through the next_page_token parameter."+ },{"slug": "ZOOM_LIST_ZRA_CONVERSATIONS","name": "List ZRA conversations",@@ -62971,6 +63101,21 @@"name": "List ZRA user conversation playlists","description": "Tool to list conversation playlists for a specific user in Zoom Revenue Accelerator. Use when you need to retrieve playlists containing conversation clips for coaching or sharing purposes."},+ {+ "slug": "ZOOM_MOVE_WHITEBOARDS_TO_PROJECT",+ "name": "Move whiteboards to project",+ "description": "Moves one or more whiteboards to a specified Zoom Whiteboard project. Use when you need to organize whiteboards by assigning them to a specific project for better management and access control. The maximum number of whiteboards that can be moved in a single request is 50."+ },+ {+ "slug": "ZOOM_REMOVE_WHITEBOARD_CLASSIFICATION",+ "name": "Remove whiteboard classification",+ "description": "Removes the classification label from a whiteboard. Use this action when you need to unassign or clear a security classification label from an existing whiteboard. Not supported in Gov cluster. Each whiteboard can only have one classification label at a time — calling this action removes the currently applied classification, if any. This action is reversible — you can apply a new classification label afterward using the ApplyClassificationToWhiteboard action."+ },+ {+ "slug": "ZOOM_REMOVE_WHITEBOARDS_FROM_PROJECT",+ "name": "Remove whiteboards from project",+ "description": "Removes one or more whiteboards from a specified Zoom Whiteboard project. This action is irreversible — once whiteboards are removed from a project, they cannot be automatically restored to that project. Use when you need to clean up whiteboards from a project or reassign them to a different project."+ },{"slug": "ZOOM_SEARCH_COMPANY_CONTACTS","name": "Search company contacts",@@ -62981,6 +63126,11 @@"name": "Update a meeting","description": "To update a meeting via API, ensure `start_time` is future-dated; `recurrence` is needed. Limit: 100 requests/day, 100 updates/meeting in 24 hrs. Requires `meeting:write` and `meeting:write:admin` scopes, with a `LIGHT` rate limit."},+ {+ "slug": "ZOOM_UPDATE_CLASSIFICATION_LABEL",+ "name": "Update classification label",+ "description": "Updates an existing classification label in Zoom Whiteboard. Use this action when you need to modify the name, color, sensitivity level, description, guideline URL, or default status of an existing classification label. Only the fields provided in the request body will be updated. Changes are saved as a draft and may need to be published separately. Use this action when you need to rename a classification label to better reflect its purpose, update the color coding for visibility, adjust sensitivity levels to match your organization's security policies, or change which label is set as the default for new whiteboards. Note: This action modifies existing data but is not destructive — the classification label and all associated whiteboards remain intact even after updates."+ },{"slug": "ZOOM_UPDATE_IQ_CONVERSATION_COMMENT","name": "Update IQ conversation comment",@@ -62991,6 +63141,26 @@"name": "Update IQ conversation host","description": "DEPRECATED: Use ZOOM_UPDATE_ZRA_CONVERSATION_HOST instead (Zoom rebranded IQ to ZRA). Tool to update the host of a Zoom IQ (Revenue Accelerator) conversation. Use when you need to transfer conversation ownership to a different user."},+ {+ "slug": "ZOOM_UPDATE_PROJECT",+ "name": "Update a whiteboard project",+ "description": "Updates the name of an existing whiteboard project in Zoom. This action allows you to rename a project to better reflect its content or purpose. The project_id is required to identify which project to update. This action is commonly used when reorganizing whiteboard content or updating project names to reflect new themes. Use this action when you need to rename a whiteboard project to better organize your Zoom whiteboards, update project names to reflect new topics or purposes, or batch-rename projects as part of a larger content management workflow. Note: This action modifies existing data but is not destructive — the project and all its associated whiteboards remain intact even after a name change."+ },+ {+ "slug": "ZOOM_UPDATE_PROJECT_COLLABORATORS",+ "name": "Update project collaborators",+ "description": "Updates collaborator permissions for a whiteboard project. Use this action when you need to change the permission level of one or more collaborators on a whiteboard project. This allows reassigning roles such as changing a viewer to an editor or promoting a collaborator to owner status. **Prerequisites:** - The user must be the project owner or have admin permissions - The whiteboard project must exist and be accessible **Required fields:** project_id, collaborators (list with collaborator_id and role for each) **Common errors:** - \"User not found\" - The collaborator ID does not match a Zoom user - \"Project not found\" - Invalid project ID - \"Invalid collaborator role\" - Role value must be 0, 1, 2, 3, or 4"+ },+ {+ "slug": "ZOOM_UPDATE_WHITEBOARD_COLLABORATOR",+ "name": "Update whiteboard collaborator",+ "description": "Updates collaborator settings for a whiteboard. Changes the permission role for one or more collaborators on the whiteboard. Use this action when you need to modify what access levels collaborators have, such as promoting a viewer to editor or demoting an owner to co-owner. Note: When assigning a new Owner or Co-owner, the user must belong to the same account as the original Owner. If ownership is transferred, the original owner automatically becomes a Co-owner. This action is irreversible once the role changes are saved."+ },+ {+ "slug": "ZOOM_UPDATE_WHITEBOARD_SHARE_SETTINGS",+ "name": "Update whiteboard share settings",+ "description": "Updates the sharing settings for a whiteboard, controlling who can access and edit the whiteboard. Use this action when you need to change the share permissions, visibility scope, or access role for a specific whiteboard. The API returns HTTP 204 No Content on success."+ },{"slug": "ZOOM_UPDATE_ZRA_CONVERSATION_COMMENT","name": "Update ZRA conversation comment",@@ -63001,6 +63171,11 @@"name": "Update ZRA conversation host","description": "Tool to update the host of a Zoom Revenue Accelerator (ZRA) conversation. Use when you need to transfer conversation ownership to a different user."},+ {+ "slug": "ZOOM_UPLOAD_WHITEBOARD_FILE",+ "name": "Upload Whiteboard File",+ "description": "Uploads a file to be used in Zoom Whiteboard. Supports PDF and Visio (.vsdx) file formats. Use when you need to import external documents into Zoom Whiteboard for collaboration and editing. The file upload uses a separate file API endpoint (fileapi.zoom.us)."+ },{"slug": "ZOOM_VALIDATE_MARKETPLACE_APP_MANIFEST","name": "Validate marketplace app manifest",@@ -63219,7 +63394,7 @@],"toolCount": 67,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "RETELLAI_ADD_COMMUNITY_VOICE",@@ -63596,7 +63771,7 @@],"toolCount": 172,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SERVICENOW_ATTACH_FILE_TO_RECORD",@@ -64556,7 +64731,7 @@],"toolCount": 5,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "GOOGLEADS_ADD_OR_REMOVE_TO_CUSTOMER_LIST",@@ -64663,9 +64838,12 @@"OAUTH2","API_KEY"],+ "composioManagedAuthSchemes": [+ "OAUTH2"+ ],"toolCount": 368,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "PAGERDUTY_ADD_SERVICE_TO_INCIDENT_WORKFLOW_TRIGGER",@@ -67404,7 +67582,7 @@],"toolCount": 77,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MIRO_ATTACH_TAG_TO_ITEM",@@ -67858,7 +68036,7 @@],"toolCount": 89,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SHARE_POINT_ADD_ATTACHMENT_TO_LIST_ITEM",@@ -68458,7 +68636,7 @@],"toolCount": 4,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FORMCARRY_CREATE_FORM",@@ -68519,7 +68697,7 @@],"toolCount": 11,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "APPDRAG_EXECUTE_FUNCTION_DELETE_DEFAULT",@@ -68721,7 +68899,7 @@],"toolCount": 248,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "LAUNCH_DARKLY_ADD_MEMBER_TO_TEAMS",@@ -70002,7 +70180,7 @@],"toolCount": 86,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MAILERLITE_ADD_PRODUCT_TO_CATEGORY",@@ -71312,7 +71490,7 @@],"toolCount": 25,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "ABLY_BATCH_PRESENCE",@@ -71547,7 +71725,7 @@],"toolCount": 86,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NETSUITE_ASYNC_GET_JOB_STATUS",@@ -72153,7 +72331,7 @@],"toolCount": 63,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "RECALLAI_CREATE_BOT",@@ -72732,7 +72910,7 @@],"toolCount": 22,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "SURVEY_MONKEY_CREATE_BULK_CONTACTS",@@ -72951,7 +73129,7 @@],"toolCount": 265,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ZOHO_BOOKS_ACCEPT_ESTIMATE",@@ -74731,7 +74909,7 @@],"toolCount": 43,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FACEBOOK_ASSIGN_PAGE_TASK",@@ -75305,7 +75483,7 @@],"toolCount": 26,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "WEBEX_CREATE_TEAM",@@ -75501,7 +75679,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "BRANDFETCH_GET_BRAND_INFO",@@ -75580,7 +75758,7 @@],"toolCount": 48,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST",@@ -75886,7 +76064,7 @@],"toolCount": 101,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DIGICERT_ADD_TAGS_TO_CERTIFICATE",@@ -76606,7 +76784,7 @@],"toolCount": 56,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DROPBOX_SIGN_ADD_USER_TO_TEAM",@@ -77261,7 +77439,7 @@],"toolCount": 286,"triggerCount": 20,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BOX_ADD_ALLOWED_COLLABORATION_DOMAIN",@@ -79707,7 +79885,7 @@],"toolCount": 52,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "WEBFLOW_CREATE_ASSET_FOLDER",@@ -80233,7 +80411,7 @@],"toolCount": 53,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FLUTTERWAVE_CANCEL_PAYMENT_PLAN",@@ -80598,7 +80776,7 @@],"toolCount": 10,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "FRESHBOOKS_CREATE_WEBHOOK",@@ -81340,7 +81518,7 @@],"toolCount": 6,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "DEMIO_CREATE_JOIN_LINK",@@ -81419,7 +81597,7 @@],"toolCount": 67,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "ALTOVIZ_CREATE_CONTACT",@@ -83749,7 +83927,7 @@],"toolCount": 64,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "LEVER_ADD_OPPORTUNITY_LINKS",@@ -84185,12 +84363,12 @@],"toolCount": 54,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ZOHO_BIGIN_ADD_RECORDS","name": "Add Records",- "description": "Tool to add new records to a module. Use when you need to programmatically insert one or more records into Bigin after confirming module name and field API names. Provide required fields per module (e.g., Contacts requires Last_Name)."+ "description": "Tool to add new records to a module. Use when you need to programmatically insert one or more records into Bigin after confirming module name and field API names. Module-specific mandatory fields: - Tasks: Subject (required) - Events: Event_Title, Start_DateTime, End_DateTime (all required) - Calls: Subject, Call_Type (Outbound/Inbound/Missed), Call_Start_Time, Call_Duration (all required) - Contacts: Last_Name (required) - Other modules: Use Get Fields action to discover mandatory fields"},{"slug": "ZOHO_BIGIN_ADD_TAGS_TO_RECORDS",@@ -84952,7 +85130,7 @@],"toolCount": 32,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "GORGIAS_ADD_TICKET_TAGS",@@ -85229,7 +85407,7 @@],"toolCount": 69,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLE_ANALYTICS_ARCHIVE_CUSTOM_DIMENSION",@@ -85409,7 +85587,7 @@{"slug": "GOOGLE_ANALYTICS_LIST_CALCULATED_METRICS","name": "List Calculated Metrics",- "description": "Tool to list CalculatedMetrics on a property. Use when you need to retrieve all calculated metrics configured for a given property."+ "description": "List Calculated Metrics"},{"slug": "GOOGLE_ANALYTICS_LIST_CHANNEL_GROUPS",@@ -85424,7 +85602,7 @@{"slug": "GOOGLE_ANALYTICS_LIST_CUSTOM_DIMENSIONS","name": "List Custom Dimensions",- "description": "Tool to list CustomDimensions on a property. Use when you need to retrieve custom dimensions configured for a given property."+ "description": "List Custom Dimensions"},{"slug": "GOOGLE_ANALYTICS_LIST_CUSTOM_METRICS",@@ -85643,7 +85821,7 @@],"toolCount": 84,"triggerCount": 1,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "TODOIST_ADD_WORKSPACE",@@ -86994,7 +87172,7 @@],"toolCount": 840,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DATAROBOT_ADD_USERS_TO_GROUP",@@ -91789,7 +91967,7 @@],"toolCount": 96,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SQUARE_ACCEPT_DISPUTE",@@ -92509,7 +92687,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BASEROW_CREATE_USER",@@ -93750,7 +93928,7 @@],"toolCount": 27,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "YNAB_CREATE_ACCOUNT",@@ -94549,7 +94727,7 @@],"toolCount": 30,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MAINTAINX_CREATE_CATEGORY",@@ -94902,7 +95080,7 @@],"toolCount": 28,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "EPIC_GAMES_DELETE_PRESET_METADATA_KEY",@@ -95489,7 +95667,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "GUMROAD_GET_RESOURCE_SUBSCRIPTIONS",@@ -95656,7 +95834,7 @@],"toolCount": 24,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "OPEN_SEA_BUILD_CRITERIA_OFFER",@@ -97662,7 +97840,7 @@],"toolCount": 17,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "WAKATIME_GET_AGGREGATE_STATS",@@ -97813,7 +97991,7 @@],"toolCount": 41,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "XERO_CREATE_BANK_TRANSACTION",@@ -98087,7 +98265,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BOLDSIGN_BRAND_GET",@@ -98223,7 +98401,7 @@],"toolCount": 298,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ACTIVE_CAMPAIGN_ADD_BROWSE_SESSION_CART",@@ -99765,7 +99943,7 @@],"toolCount": 15,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ZOHO_MAIL_ACCOUNTS_LIST_ACCOUNTS",@@ -99918,7 +100096,7 @@],"toolCount": 22,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MURAL_AUTHORIZATION_REQUEST",@@ -100095,7 +100273,7 @@],"toolCount": 84,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BREX_ADD_WEBHOOK_GROUP_MEMBERS",@@ -100632,7 +100810,7 @@],"toolCount": 133,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "INTERCOM_ADD_SUBSCRIPTION_TO_A_CONTACT",@@ -101007,7 +101185,7 @@{"slug": "INTERCOM_LIST_CONVERSATIONS","name": "List conversations",- "description": "Lists conversations from Intercom with filtering and pagination support. Paginate by reading pages.next.starting_after from each response and passing it as starting_after until pages.next is absent. Response fields including title, source.body, conversation_parts.body, and statistics may be null; guard before string operations. When combining results across multiple filtered calls, deduplicate by conversation_id."+ "description": "Lists all conversations from Intercom with pagination support. This endpoint does not support filtering by state, assignee, or other attributes - use INTERCOM_SEARCH_CONVERSATIONS for filtering. Paginate by reading pages.next.starting_after from each response and passing it as starting_after until pages.next is absent. Response fields including title, source.body, conversation_parts.body, and statistics may be null; guard before string operations."},{"slug": "INTERCOM_LIST_DATA_ATTRIBUTES",@@ -101374,7 +101552,7 @@],"toolCount": 95,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "EVENTBRITE_ADD_TICKET_TO_GROUP",@@ -103318,7 +103496,7 @@],"toolCount": 121,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "STACK_EXCHANGE_CREATE_FILTER",@@ -104241,7 +104419,7 @@],"toolCount": 43,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DATADOG_CREATE_DASHBOARD",@@ -105310,7 +105488,7 @@],"toolCount": 159,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ACTIVE_TRAIL_ADD_GROUP_MEMBER",@@ -106280,7 +106458,7 @@],"toolCount": 2,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ADDRESSZEN_KEY_AVAILABILITY",@@ -106522,7 +106700,7 @@],"toolCount": 119,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "AFFINDA_ADD_TAG_TO_DOCUMENTS",@@ -107166,7 +107344,7 @@],"toolCount": 5,"triggerCount": 1,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "AGENT_MAIL_CREATE_INBOX",@@ -107971,7 +108149,7 @@],"toolCount": 30,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "AI_ML_API_CANCEL_RUN",@@ -108265,7 +108443,7 @@],"toolCount": 133,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ALGOLIA_ADD_AB_TEST",@@ -109467,7 +109645,7 @@],"toolCount": 30,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "AMARA_ADD_SUBTITLE_NOTE",@@ -109888,7 +110066,7 @@],"toolCount": 64,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ANCHOR_BROWSER_CLICK_MOUSE",@@ -111494,7 +111672,7 @@],"toolCount": 19,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "API_BIBLE_GET_ALL_BOOKS",@@ -111787,7 +111965,7 @@],"toolCount": 113,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "APIFY_ACT_BUILDS_POST",@@ -112813,7 +112991,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "APPCIRCLE_BUILD_REPO_WEBHOOK_CALLBACK_STANDARD",@@ -113020,7 +113198,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "APPVEYOR_DELETE_BUILD",@@ -113131,7 +113309,7 @@],"toolCount": 9,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ARYN_CREATE_DOCSET",@@ -113733,7 +113911,7 @@],"toolCount": 30,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BACKENDLESS_COPY_FILE",@@ -114076,7 +114254,7 @@],"toolCount": 140,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "BASECAMP_COMPLETE_TODO",@@ -115558,7 +115736,7 @@],"toolCount": 37,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BEACONCHAIN_GET_CHART",@@ -115784,7 +115962,7 @@],"toolCount": 21,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BEACONSTAC_CREATE_PLACE",@@ -116068,7 +116246,7 @@],"toolCount": 298,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BENCHMARK_EMAIL_ADD_EMAIL_IN_AUTOMATION",@@ -117599,7 +117777,7 @@],"toolCount": 10,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "BENZINGA_GET_CALENDAR_EARNINGS_STREAM",@@ -117927,7 +118105,7 @@],"toolCount": 117,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BETTER_STACK_ACKNOWLEDGE_INCIDENT",@@ -118985,7 +119163,7 @@],"toolCount": 57,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BIGMAILER_CREATE_BRAND",@@ -119746,7 +119924,7 @@],"toolCount": 92,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BLAZEMETER_CONVERT_TRANSACTIONS",@@ -120479,7 +120657,7 @@],"toolCount": 3,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BONSAI_GET_CLUSTER_DETAILS",@@ -121588,7 +121766,7 @@],"toolCount": 53,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BOTPRESS_BREAK_DOWN_WORKSPACE_USAGE_BY_BOT",@@ -121894,7 +122072,7 @@],"toolCount": 12,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BOTSONIC_BULK_UPLOAD_URLS",@@ -121995,7 +122173,7 @@],"toolCount": 31,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BOTSTAR_CREATE_BOT",@@ -123259,7 +123437,7 @@],"toolCount": 16,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BTCPAY_SERVER_CREATE_PAYMENT_REQUEST",@@ -123621,7 +123799,7 @@],"toolCount": 60,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BUGSNAG_ADD_ORGANIZATION_COLLABORATOR_TEAM_MEMBERSHIPS",@@ -124133,7 +124311,7 @@],"toolCount": 129,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "BUNNYCDN_ADD_ALLOWED_REFERER",@@ -125212,7 +125390,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CALLERAPI_DISPATCH_REPORTS_MANUALLY",@@ -126722,7 +126900,7 @@],"toolCount": 29,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CARDLY_CREATE_CONTACT_LIST",@@ -127181,7 +127359,7 @@],"toolCount": 117,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CELIGO_ASSIGN_EXPORT_ERROR",@@ -127816,7 +127994,7 @@],"toolCount": 81,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CENSUS_BUREAU_GEOCODE_ADDRESS",@@ -128262,7 +128440,7 @@],"toolCount": 186,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CENTRALSTATIONCRM_CHECK_CONNECTION",@@ -129327,7 +129505,7 @@],"toolCount": 30,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CHASER_CREATE_CONTACT_PERSON",@@ -129526,7 +129704,7 @@],"toolCount": 284,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CHATBOTKIT_ATTACH_DATASET_FILE",@@ -131109,7 +131287,7 @@],"toolCount": 65,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CIRCLECI_CREATE_CONTEXT",@@ -131586,7 +131764,7 @@],"toolCount": 28,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CLASSMARKER_CREATE_ACCESS_LIST_ITEM",@@ -132253,7 +132431,7 @@],"toolCount": 166,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CLICKSEND_ACCOUNT_USEAGE_BY_SUBACCOUNT_GET",@@ -133467,7 +133645,7 @@],"toolCount": 75,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "CLOCKIFY_ADD_USER_TO_GROUP",@@ -133940,7 +134118,7 @@],"toolCount": 150,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CLOUDCART_ADD_CATEGORY_PROPERTIES",@@ -134991,7 +135169,7 @@],"toolCount": 4,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CLOUDFLARE_BROWSER_RENDERING_CAPTURE_SCREENSHOT",@@ -135060,7 +135238,7 @@],"toolCount": 109,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CLOUDINARY_ACTIVATE_LIVE_STREAM",@@ -135918,7 +136096,7 @@],"toolCount": 18,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CODACY_CREATE_API_TOKEN",@@ -136985,7 +137163,7 @@],"toolCount": 6,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "COMMCARE_CREATE_LOOKUP_TABLE",@@ -137513,7 +137691,7 @@],"toolCount": 54,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CONTROL_D_DELETE_DEVICES_DEVICE_ID",@@ -137824,7 +138002,7 @@],"toolCount": 11,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "CONVERSION_TOOLS_CONVERT_EXCEL_TO_HTML",@@ -137920,7 +138098,7 @@],"toolCount": 17,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "CONVERTAPI_ASYNC_CONVERT",@@ -138418,7 +138596,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CONVOLO_AI_CREATE_CHARACTER",@@ -138650,7 +138828,7 @@],"toolCount": 25,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "COUNTDOWN_API_CLEAR_ALL_REQUESTS",@@ -138816,7 +138994,7 @@],"toolCount": 384,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "COUPA_ABANDON_AN_INVOICE",@@ -140916,7 +141094,7 @@],"toolCount": 231,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CROWDIN_ADD_BRANCH",@@ -142161,7 +142339,7 @@],"toolCount": 27,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "CROWTERMINAL_ANALYZE_ENGAGEMENT",@@ -142569,7 +142747,7 @@],"toolCount": 5,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "CURRENTS_API_ACTIVITIES_LIST",@@ -142701,7 +142879,7 @@],"toolCount": 24,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CUSTOMERIO_ADD_PERSON_TO_GROUP",@@ -142871,7 +143049,7 @@],"toolCount": 40,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CUSTOMGPT_ACTIVATE_PERSONA_VERSION",@@ -143112,7 +143290,7 @@],"toolCount": 5,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "CUSTOMJS_AUTHENTICATE_API_KEY",@@ -144115,7 +144293,7 @@],"toolCount": 426,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DATABRICKS_ADD_MEMBER_TO_SECURITY_GROUP",@@ -146351,7 +146529,7 @@],"toolCount": 312,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DATAFORSEO_CREATE_APP_DATA_APPLE_APP_REVIEWS_TASK",@@ -148422,7 +148600,7 @@],"toolCount": 13,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "DELIGHTED_ADD_PERSON_TO_AUTOPILOT_EMAIL",@@ -148528,7 +148706,7 @@],"toolCount": 60,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DEPLOYHQ_DELETE_COMMAND",@@ -148885,7 +149063,7 @@],"toolCount": 11,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "DESKTIME_CREATE_PROJECT_WITH_TASK",@@ -148981,7 +149159,7 @@],"toolCount": 19,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "DETRACK_ADD_COLLECTION",@@ -149117,7 +149295,7 @@],"toolCount": 28,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DEVTO_CREATE_ARTICLE",@@ -149525,7 +149703,7 @@],"toolCount": 1,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "DICTIONARY_API_GET_WORD_DEFINITION_V2",@@ -149571,7 +149749,7 @@],"toolCount": 35,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DIFFBOT_COMBINE_ENTITY_PROFILES",@@ -149791,7 +149969,7 @@],"toolCount": 48,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "DIGITAL_OCEAN_CREATE_CUSTOM_IMAGE",@@ -150120,7 +150298,7 @@],"toolCount": 170,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DNSFILTER_ADD_ALLOWED_APPLICATION",@@ -151011,7 +151189,7 @@],"toolCount": 15,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DOCK_CERTS_CREATE_API_KEY",@@ -151127,7 +151305,7 @@],"toolCount": 24,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DOCKER_HUB_ADD_ORG_MEMBER",@@ -151632,7 +151810,7 @@],"toolCount": 38,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DOCSBOT_AI_CAPTURE_CONVERSATION_LEAD",@@ -151863,7 +152041,7 @@],"toolCount": 11,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DOCSUMO_ADD_TABLE_ROW",@@ -154211,7 +154389,7 @@],"toolCount": 18,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "DRIPCEL_CREATE_CONTACTS",@@ -154423,7 +154601,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "DROPCONTACT_CREATE_WEBHOOK_SUBSCRIPTION",@@ -154503,7 +154681,7 @@],"toolCount": 17,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "DUB_BULK_DELETE_LINKS",@@ -154919,7 +155097,7 @@],"toolCount": 27,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "E2B_CONNECT_SANDBOX",@@ -155194,7 +155372,7 @@],"toolCount": 5,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ECOLOGI_GET_USER_CARBON_OFFSET",@@ -155260,7 +155438,7 @@],"toolCount": 60,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "EGNYTE_CREATE_AUDIT_PERMISSIONS",@@ -155345,7 +155523,7 @@{"slug": "EGNYTE_DELETE_METADATA_NAMESPACE","name": "Delete Metadata Namespace",- "description": "Tool to delete a metadata namespace. Use when you need to remove an unused namespace after confirming its name. Returns 403 error if the namespace is currently in use and cannot be deleted."+ "description": "Tool to delete a metadata namespace. Use force_delete=true to remove namespaces that are currently in use. Returns 403 error if the namespace is in use and force_delete is false."},{"slug": "EGNYTE_DELETE_NOTE",@@ -155636,7 +155814,7 @@],"toolCount": 4,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ELASTICSEARCH_GET_INDEX_SCHEMA",@@ -155744,7 +155922,7 @@],"toolCount": 124,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ELEVENREADER_ADD_DOCUMENTATION_TO_KNOWLEDGE_BASE",@@ -156686,7 +156864,7 @@],"toolCount": 20,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "EMAILOCTOPUS_CREATE_CONTACT",@@ -156827,7 +157005,7 @@],"toolCount": 22,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "EMELIA_ADD_CONTACT_TO_BLACKLIST",@@ -157364,7 +157542,7 @@],"toolCount": 26,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ENDORSAL_ARCHIVE_CONTACT",@@ -157535,7 +157713,7 @@],"toolCount": 22,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ENGAGE_ADD_CUSTOMER_TO_ACCOUNTS",@@ -158061,7 +158239,7 @@],"toolCount": 11,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "EODHD_APIS_GET_EOD_YAHOO_STYLE",@@ -158157,7 +158335,7 @@],"toolCount": 50,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ERPNEXT_ADD_COMMENT",@@ -158464,7 +158642,7 @@],"toolCount": 17,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ESIGNATURES_IO_ADD_TEMPLATE_COLLABORATOR",@@ -159135,7 +159313,7 @@],"toolCount": 78,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "ETERMIN_ASSIGN_CALENDAR_SERVICE",@@ -159590,7 +159768,7 @@],"toolCount": 12,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "EVENIUM_CREATE_CONTACT",@@ -159928,7 +160106,7 @@],"toolCount": 38,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "EVERHOUR_CLIENT_CREATE",@@ -160262,7 +160440,7 @@],"toolCount": 54,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "EXCEL_ADD_CHART",@@ -160913,7 +161091,7 @@],"toolCount": 8,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FAL_AI_CANCEL_QUEUE_REQUEST",@@ -160994,7 +161172,7 @@],"toolCount": 117,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FARADAY_ARCHIVE_COHORT",@@ -161624,7 +161802,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FATHOM_CREATE_WEBHOOK",@@ -161748,7 +161926,7 @@],"toolCount": 19,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "FEATHERY_ACCOUNT_EDIT",@@ -162499,7 +162677,7 @@],"toolCount": 22,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FILLOUT_FORMS_AUTHORIZE_O_AUTH",@@ -162650,7 +162828,7 @@],"toolCount": 21,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FINDYMAIL_ADD_EXCLUDED_DOMAIN",@@ -164348,7 +164526,7 @@],"toolCount": 5,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FIXER_IO_CONVERT_CURRENCY",@@ -164654,7 +164832,7 @@],"toolCount": 13,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FLUXGUARD_ADD_PAGE",@@ -164761,7 +164939,7 @@],"toolCount": 45,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FLY_ADD_WIRE_GUARD_PEER",@@ -165084,7 +165262,7 @@],"toolCount": 23,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FOLK_CREATE_COMPANY",@@ -166006,7 +166184,7 @@],"toolCount": 45,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FORMBRICKS_CHECK_HEALTH",@@ -166272,7 +166450,7 @@],"toolCount": 21,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "FORMDESK_AUTOMATIC_LOGIN",@@ -167505,7 +167683,7 @@],"toolCount": 8,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GEMINI_COUNT_TOKENS",@@ -167775,7 +167953,7 @@],"toolCount": 25,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "GEOAPIFY_ADDRESS_AUTOCOMPLETE",@@ -168270,7 +168448,7 @@],"toolCount": 44,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GIFT_UP_ADD_ORDER_NOTE",@@ -168531,7 +168709,7 @@],"toolCount": 150,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GIGASHEET_APPEND_DATASET",@@ -169766,7 +169944,7 @@],"toolCount": 58,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "GITLAB_ARCHIVE_PROJECT",@@ -170560,7 +170738,7 @@],"toolCount": 179,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GLEAP_ARCHIVE_ALL_TICKETS",@@ -171731,7 +171909,7 @@],"toolCount": 5,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOODBITS_CREATE_LINK",@@ -171954,7 +172132,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLE_ADMIN_ADD_USER_ALIAS",@@ -172079,6 +172257,252 @@}]},+ {+ "slug": "google_chat",+ "name": "Google Chat",+ "logo": "https://logos.composio.dev/api/google_chat",+ "description": "Google Chat API integration for messaging and collaboration in Google Workspace",+ "category": "productivity",+ "authSchemes": [+ "OAUTH2"+ ],+ "toolCount": 36,+ "triggerCount": 0,+ "version": "00000000_00",+ "tools": [+ {+ "slug": "GOOGLE_CHAT_CREATE_CUSTOM_EMOJI",+ "name": "Create Custom Emoji",+ "description": "Creates a custom emoji in Google Chat for use within an organization. Use this action when you need to add a custom emoji that can be used by members of your Google Workspace organization. The emoji will be available in Google Chat after creation. Note: Custom emojis are only available for Google Workspace accounts and require the administrator to enable custom emojis for the organization. This is a Developer Preview feature."+ },+ {+ "slug": "GOOGLE_CHAT_CREATE_MESSAGE",+ "name": "Create Message",+ "description": "Creates a message in a Google Chat space. With user authentication, only text messages are supported. Maximum message size is 32,000 bytes. Use this action when you need to send a message to a Google Chat space or channel. You can reply to existing threads by providing a thread_key, or start a new conversation. Messages can mention users using '@username' syntax. Note: With user auth, only plain text messages are supported. Card-based messages require bot authentication."+ },+ {+ "slug": "GOOGLE_CHAT_CREATE_REACTION",+ "name": "Create Reaction",+ "description": "Creates an emoji reaction on a Google Chat message. Use this action when you need to add an emoji reaction (like 👍, ❤️, or 🎉) to an existing message in a Google Chat space. Either emoji_unicode or emoji_custom_id is required, but not both. This action is useful for acknowledging messages, voting on ideas, expressing emotions in response to messages, or building interactive message features in Google Chat bots."+ },+ {+ "slug": "GOOGLE_CHAT_CREATE_SECTION",+ "name": "Create section",+ "description": "Creates a custom section in Google Chat for organizing conversations in the navigation panel. Use when you need to create a new custom section to organize spaces and direct messages in the user's Chat sidebar."+ },+ {+ "slug": "GOOGLE_CHAT_CREATE_SPACE",+ "name": "Create Space",+ "description": "Creates a named space or group chat in Google Chat. The calling user is automatically added as a member and space manager. Use this action when you need to create a new Google Chat space for team collaboration, project discussions, or group conversations. This action creates a named space that users can discover and join. Note: If you receive the error ALREADY_EXISTS when creating a space, try a different displayName. The displayName must be unique within the organization."+ },+ {+ "slug": "GOOGLE_CHAT_DELETE_CUSTOM_EMOJI",+ "name": "Delete Custom Emoji",+ "description": "Deletes a custom emoji from Google Chat. By default, users can only delete custom emojis they created. Emoji managers assigned by the administrator can delete any custom emoji in the organization. Use this action when you need to permanently remove a custom emoji that is no longer needed. This action is irreversible — once deleted, the custom emoji cannot be recovered."+ },+ {+ "slug": "GOOGLE_CHAT_DELETE_MEMBER",+ "name": "Delete Member from Space",+ "description": "Removes a user, Google Group, or app from a space. This action is irreversible — once removed, the member cannot be recovered and will need to be re-added to the space. Use when you need to remove a specific member from a Google Chat space. Note: Deleted members will lose access to the space immediately and will need to be re-invited if they need access again."+ },+ {+ "slug": "GOOGLE_CHAT_DELETE_MESSAGE",+ "name": "Delete Message",+ "description": "Deletes a message from a Google Chat space. Use this action when you need to remove a message that is no longer needed, was posted in error, or is outdated. App authentication can only delete messages created by the calling Chat app. User authentication with proper permissions can delete any message in a space they manage. This action is irreversible — once deleted, the message cannot be recovered."+ },+ {+ "slug": "GOOGLE_CHAT_DELETE_REACTION",+ "name": "Delete Reaction",+ "description": "Deletes a reaction to a message. Use when you need to remove a reaction that was previously added to a message. Users can only delete their own reactions. This action is irreversible — once the reaction is deleted, it cannot be recovered."+ },+ {+ "slug": "GOOGLE_CHAT_DELETE_SECTION",+ "name": "Delete section",+ "description": "Deletes a custom section from Google Chat by its ID. This action is irreversible — once a section is deleted, it cannot be recovered. If the section contains items (such as spaces), they are moved to Google Chat's default sections and are not deleted. Use when you need to remove a custom section that is no longer needed."+ },+ {+ "slug": "GOOGLE_CHAT_DELETE_SPACE",+ "name": "Delete space",+ "description": "Deletes a named space from Google Chat. Always performs a cascading delete, which means that the space's child resources like messages and memberships are also deleted. Use this action when you need to permanently remove a Google Chat space and all associated data. This action is irreversible — the space and all its messages and memberships cannot be recovered once deleted."+ },+ {+ "slug": "GOOGLE_CHAT_FIND_DIRECT_MESSAGE",+ "name": "Find Direct Message",+ "description": "Returns the existing direct message space with the specified user. Use this action when you need to find an existing DM space with a particular user, such as when checking if a DM already exists before creating one or when you need the space resource name for subsequent operations. If no direct message space exists with the specified user, this action returns a NOT_FOUND (404) error. Note: This only finds existing DM spaces - it does not create a new one. To create a new DM, use the create DM action instead."+ },+ {+ "slug": "GOOGLE_CHAT_FIND_GROUP_CHATS",+ "name": "Find Group Chats",+ "description": "Finds all group chat spaces that contain exactly the calling user and the specified users. This action uses the Google Chat Developer Preview API to search for GROUP_CHAT spaces whose human memberships contain exactly the calling user and the specified users. Use this action when you need to find existing group chats that include specific participants."+ },+ {+ "slug": "GOOGLE_CHAT_GET_MEMBER",+ "name": "Get Chat Space Member",+ "description": "Returns details about a membership in a space. Use this action when you need to retrieve information about a specific member's relationship with a Google Chat space, including their role, state, and user details."+ },+ {+ "slug": "GOOGLE_CHAT_GET_MESSAGE",+ "name": "Get Message",+ "description": "Returns details about a specific message in a Google Chat space. Use this action when you need to retrieve the full content, sender information, thread details, and other metadata for a particular message. Requires user authentication with an appropriate Google Chat OAuth scope."+ },+ {+ "slug": "GOOGLE_CHAT_GET_SPACE",+ "name": "Get Space",+ "description": "Returns details about a specific Google Chat space including configuration, membership count, and access settings. Use this action when you need to retrieve information about a specific space in Google Chat, such as getting the space's display name, description, membership count, threading state, or access settings. Note: Some response fields are only populated based on the OAuth scopes used. The accessSettings, predefinedPermissionSettings, and permissionSettings fields are only populated when using the chat.app.spaces scope. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.admin.spaces - https://www.googleapis.com/auth/chat.admin.spaces.readonly - https://www.googleapis.com/auth/chat.app.spaces - https://www.googleapis.com/auth/chat.bot - https://www.googleapis.com/auth/chat.spaces - https://www.googleapis.com/auth/chat.spaces.readonly"+ },+ {+ "slug": "GOOGLE_CHAT_GET_SPACE_NOTIFICATION_SETTING",+ "name": "Get Space Notification Setting",+ "description": "Gets the notification settings for a user in a specific space. Use when you need to retrieve the caller's space notification setting, including whether notifications are muted and what type of notifications are enabled. Requires user authentication with the `https://www.googleapis.com/auth/chat.users.spacesettings` OAuth scope."+ },+ {+ "slug": "GOOGLE_CHAT_GET_SPACE_READ_STATE",+ "name": "Get space read state",+ "description": "Returns details about a user's read state within a space. Use this action when you need to identify which messages in a space have been read or unread by the user."+ },+ {+ "slug": "GOOGLE_CHAT_GET_THREAD_READ_STATE",+ "name": "Get thread read state",+ "description": "Returns details about a user's read state within a thread. Use this action when you need to identify which messages in a specific thread have been read or unread by the user."+ },+ {+ "slug": "GOOGLE_CHAT_LIST_CUSTOM_EMOJIS",+ "name": "List custom emojis",+ "description": "Lists custom emojis visible to the authenticated user in Google Chat. Use this action when you need to retrieve all custom emojis available in Google Chat for the authenticated user. This is useful for displaying available emojis, filtering by creator, or enumerating organization-specific custom emojis. Supports pagination via pageSize and pageToken parameters. By default, returns up to 25 emojis."+ },+ {+ "slug": "GOOGLE_CHAT_LIST_MEMBERS",+ "name": "List Space Members",+ "description": "Lists memberships in a space. Returns a list of all members including users, bots, and Google Groups. Use when you need to retrieve all members of a Google Chat space, such as to get a list of participants, check who has access, or find specific members by role or type. Supports pagination when there are many members in a space. Use the nextPageToken from a response to fetch subsequent pages."+ },+ {+ "slug": "GOOGLE_CHAT_LIST_MESSAGES",+ "name": "List Messages",+ "description": "Lists messages in a space that the authenticated user is a member of. Use this action when you need to retrieve messages from a Google Chat space, such as displaying message history, searching for specific messages, or monitoring space activity. Supports filtering and ordering of messages. Pagination is available via pageToken for retrieving large message sets. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.messages - https://www.googleapis.com/auth/chat.messages.readonly - https://www.googleapis.com/auth/chat.import"+ },+ {+ "slug": "GOOGLE_CHAT_LIST_REACTIONS",+ "name": "List reactions on a message",+ "description": "Lists all reactions on a specific message in a Google Chat space. Use when you need to retrieve all emoji reactions (likes, thumbs up, hearts, etc.) that users have added to a message. This action is read-only and does not modify any data. The results can be filtered by emoji type or user using the filter parameter."+ },+ {+ "slug": "GOOGLE_CHAT_LIST_SECTION_ITEMS",+ "name": "List Section Items",+ "description": "Lists all items (such as spaces) within a specified section of a user's Google Chat. Use when you need to retrieve all items grouped under a section in Google Chat, or when implementing pagination to fetch all items across multiple pages. Sections can be system sections like 'default-spaces' or custom sections created by the user. Requires user authentication with the `https://www.googleapis.com/auth/chat.users.sections.readonly` (read-only) or `https://www.googleapis.com/auth/chat.users.sections` (full access) OAuth scope."+ },+ {+ "slug": "GOOGLE_CHAT_LIST_SECTIONS",+ "name": "List Sections",+ "description": "Lists all sections available to the authenticated user in Google Chat. Use this action when you need to retrieve all sections for organizing conversations in the navigation panel. Sections include custom sections created by the user and system sections like default direct messages, default spaces, and default apps. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.users.sections - https://www.googleapis.com/auth/chat.users.sections.readonly"+ },+ {+ "slug": "GOOGLE_CHAT_LIST_SPACE_EVENTS",+ "name": "List Space Events",+ "description": "Lists events from a Google Chat space. Use when you need to retrieve historical events such as new messages, membership changes, or reactions from a specific Google Chat space. The filter parameter is required and must specify event type filters. Note: This action requires specifying event type filters in the filter parameter. Supported event types include message events (created, updated, deleted), membership events (created, updated, deleted), and reaction events."+ },+ {+ "slug": "GOOGLE_CHAT_LIST_SPACES",+ "name": "List Spaces",+ "description": "Lists spaces the authenticated user is a member of in Google Chat. Use this action when you need to retrieve all spaces that the user belongs to, such as displaying available spaces or finding a specific space. Note: Group chats and direct messages (DMs) are not listed until the first message is sent. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.spaces - https://www.googleapis.com/auth/chat.spaces.readonly - https://www.googleapis.com/auth/chat.bot"+ },+ {+ "slug": "GOOGLE_CHAT_MOVE_SECTION_ITEM",+ "name": "Move Section Item",+ "description": "Moves a space from one section to another in Google Chat. Use when organizing spaces into different sections, such as moving a space from the default-spaces section to a custom user-created section. The action updates the section membership of the specified space item."+ },+ {+ "slug": "GOOGLE_CHAT_POSITION_SECTION",+ "name": "Position Section in Sidebar",+ "description": "Changes the sort order of a section in the Google Chat sidebar. Use when you need to reorder sections in the sidebar. Either sortOrder (absolute position) or relativePosition (START/END) must be provided to specify the new position."+ },+ {+ "slug": "GOOGLE_CHAT_SET_UP_SPACE",+ "name": "Setup Space",+ "description": "Creates a space and adds specified users and groups to it. Use this action when you need to create a space in Google Chat and automatically add initial members in a single operation. The calling user is automatically added to the created space. Supports creating named spaces (SPACE), group chats (GROUP_CHAT), and direct messages (DIRECT_MESSAGE). For named spaces, displayName is required. For group chats and DMs, at least one membership is typically required. Note: Google groups can only be added to named spaces. If a DM already exists between users, the existing DM is returned instead of creating a new one. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.spaces - https://www.googleapis.com/auth/chat.spaces.create"+ },+ {+ "slug": "GOOGLE_CHAT_UPDATE_MEMBER",+ "name": "Update Member",+ "description": "Updates a membership in a Google Chat space, such as changing a member's role between member and manager. Use this action when you need to modify a user's role or permissions within a Google Chat space."+ },+ {+ "slug": "GOOGLE_CHAT_UPDATE_MESSAGE",+ "name": "Update Message",+ "description": "Updates a message in a Google Chat space, modifying its text, cards, or other properties. Use this action when you need to edit an existing message's content or properties. Supports partial updates via the updateMask parameter. App authentication can only update messages created by the calling Chat app. User authentication with appropriate permissions can update any message in spaces they manage."+ },+ {+ "slug": "GOOGLE_CHAT_UPDATE_SECTION",+ "name": "Update section",+ "description": "Updates a section's display name in Google Chat. This action uses patch semantics for partial updates. Use when you need to rename an existing custom section in Google Chat. Only sections of type 'CUSTOM_SECTION' can be updated. System sections (like 'default-direct-messages', 'default-spaces', 'default-apps') cannot have their display names modified. Requires user authentication with the 'https://www.googleapis.com/auth/chat.users.sections' scope."+ },+ {+ "slug": "GOOGLE_CHAT_UPDATE_SPACE",+ "name": "Update Space",+ "description": "Updates a Google Chat space's configuration including display name, description, guidelines, history settings, access settings, and permission settings. Use this action when you need to modify the settings of an existing Google Chat space that you have admin or manager permissions for."+ },+ {+ "slug": "GOOGLE_CHAT_UPDATE_SPACE_NOTIFICATION_SETTING",+ "name": "Update Space Notification Setting",+ "description": "Updates the notification settings for a user in a space. Use when you need to modify how a user receives notifications in a specific space, such as muting a noisy channel or changing the notification level to only important messages. Requires user authentication with the chat.users.spacesettings scope."+ },+ {+ "slug": "GOOGLE_CHAT_UPDATE_SPACE_READ_STATE",+ "name": "Update Space Read State",+ "description": "Updates a user's read state within a space, used to mark messages as read or unread. Use this action when you need to programmatically mark a Google Chat space as read or update the user's read position in a space. Note: To mark a space as unread, set lastReadTime to a value earlier than the latest message timestamp. To mark as read, set it to any value later than the latest message."+ }+ ],+ "triggers": [],+ "authConfigDetails": [+ {+ "mode": "OAUTH2",+ "name": "google_chat_oauth",+ "fields": {+ "auth_config_creation": {+ "required": [+ {+ "name": "client_id",+ "displayName": "Client id",+ "type": "string",+ "description": "Client id of the app",+ "required": true,+ "default": null+ },+ {+ "name": "client_secret",+ "displayName": "Client secret",+ "type": "string",+ "description": "Client secret of the app",+ "required": true,+ "default": null+ }+ ],+ "optional": [+ {+ "name": "oauth_redirect_uri",+ "displayName": "Redirect URI",+ "type": "string",+ "description": "Add this Redirect URL to your app's OAuth allow list.",+ "required": false,+ "default": "https://backend.composio.dev/api/v1/auth-apps/add"+ },+ {+ "name": "scopes",+ "displayName": "Scopes",+ "type": "string",+ "description": "Scopes to request from the user, comma separated",+ "required": false,+ "default": "https://www.googleapis.com/auth/chat.spaces.readonly,https://www.googleapis.com/auth/chat.spaces,https://www.googleapis.com/auth/chat.messages.readonly,https://www.googleapis.com/auth/chat.messages,https://www.googleapis.com/auth/chat.messages.create,https://www.googleapis.com/auth/chat.memberships.readonly,https://www.googleapis.com/auth/chat.memberships,https://www.googleapis.com/auth/chat.bot"+ }+ ]+ },+ "connected_account_initiation": {+ "required": [],+ "optional": []+ }+ }+ }+ ]+ },{"slug": "google_classroom","name": "Google Classroom",@@ -172093,7 +172517,7 @@],"toolCount": 62,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLE_CLASSROOM_COURSES_ALIASES_CREATE",@@ -172469,7 +172893,7 @@],"toolCount": 29,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLE_CLOUD_VISION_ANNOTATE_FILES",@@ -172772,7 +173196,7 @@],"toolCount": 8,"triggerCount": 1,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLESLIDES_CREATE_PRESENTATION",@@ -172884,7 +173308,7 @@],"toolCount": 24,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOOGLECONTACTS_BATCH_CREATE_CONTACTS",@@ -173186,7 +173610,7 @@],"toolCount": 90,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GOSQUARED_ACCOUNT_ADD_SHARED_USER",@@ -173797,7 +174221,7 @@],"toolCount": 28,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GRAFBASE_ADD_ZITADEL_REDIRECT",@@ -174177,7 +174601,7 @@],"toolCount": 143,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "GRIPTAPE_ASSISTANT_CREATION",@@ -174933,7 +175357,7 @@],"toolCount": 30,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GRIST_ADD_RECORDS",@@ -175349,7 +175773,7 @@],"toolCount": 192,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "GUSTO_ADD_EMPLOYEES_TO_HOLIDAY_PAY_POLICY",@@ -176391,7 +176815,7 @@],"toolCount": 70,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "HABITICA_ADD_CHALLENGE_TASK",@@ -178865,7 +179289,7 @@],"toolCount": 99,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "HERE_AUTOSUGGEST",@@ -179605,7 +180029,7 @@],"toolCount": 19,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "HEYREACH_ADD_LEADS_TO_LIST_V2",@@ -179741,7 +180165,7 @@],"toolCount": 13,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "HEYY_CREATE_ATTRIBUTE",@@ -180079,7 +180503,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "HONEYBADGER_REPORT_CHECK_IN",@@ -180406,7 +180830,7 @@],"toolCount": 105,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "HOOKDECK_ADD_CUSTOM_DOMAIN",@@ -180972,7 +181396,7 @@],"toolCount": 19,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "HOTSPOTSYSTEM_CUSTOMERS_LIST",@@ -181819,7 +182243,7 @@],"toolCount": 135,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "HUGGING_FACE_CHANGE_DISCUSSIONS_STATUS",@@ -183578,7 +184002,7 @@],"toolCount": 32,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "IGNISIGN_API_AUTHENTICATION",@@ -183779,7 +184203,7 @@],"toolCount": 26,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "IMAGEKIT_IO_BULK_JOB_STATUS",@@ -184970,7 +185394,7 @@],"toolCount": 65,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "INSIGHTO_AI_ADD_INTENT_TO_ASSISTANT",@@ -185439,7 +185863,7 @@],"toolCount": 36,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "INSTAGRAM_CREATE_CAROUSEL_CONTAINER",@@ -185549,7 +185973,7 @@{"slug": "INSTAGRAM_GET_USER_INFO","name": "Get User Info",- "description": "Get Instagram user info including profile details and statistics."+ "description": "Get Instagram Business Account info including profile details and statistics. IMPORTANT: Only works for Business/Creator accounts you manage through Facebook Business Manager. Cannot query arbitrary public Instagram accounts. Use \"me\" to query your own authenticated account."},{"slug": "INSTAGRAM_GET_USER_INSIGHTS",@@ -185685,7 +186109,7 @@],"toolCount": 117,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "INSTANTLY_ACCOUNTS_CTD_STATUS_GET",@@ -186701,7 +187125,7 @@],"toolCount": 28,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "IPDATA_CO_ADVANCED_ASN_LOOKUP",@@ -186882,7 +187306,7 @@],"toolCount": 27,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "IPINFO_IO_BATCH_LITE_LOOKUP",@@ -187305,7 +187729,7 @@],"toolCount": 21,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "JOBNIMBUS_ACCOUNT_CREATE_LOCATION",@@ -187451,7 +187875,7 @@],"toolCount": 18,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "JOTFORM_CLONE_FORM",@@ -187641,7 +188065,7 @@],"toolCount": 77,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "KADOA_APPROVE_BULK_VALIDATION_RULES",@@ -188067,7 +188491,7 @@],"toolCount": 35,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "KAGGLE_COMPETITION_DOWNLOAD_FILES",@@ -188469,7 +188893,7 @@],"toolCount": 24,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "KANBANIZE_ADD_CARD_COMMENT",@@ -188638,7 +189062,7 @@],"toolCount": 6,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "KEEN_IO_INSPECT_ALL_EVENT_COLLECTIONS",@@ -188733,7 +189157,7 @@],"toolCount": 20,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "KEYWORD_ADD_KEYWORDS",@@ -188875,7 +189299,7 @@],"toolCount": 47,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "KIBANA_DELETE_ALERTING_RULES",@@ -189198,7 +189622,7 @@],"toolCount": 2,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "KICKBOX_CHECK_DISPOSABLE",@@ -190003,7 +190427,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "KONTENT_AI_GET_CONTENT_ITEM",@@ -190087,7 +190511,7 @@],"toolCount": 3,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "KRAKEN_IO_CHECK_USER_STATUS",@@ -190475,7 +190899,7 @@],"toolCount": 20,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "LANGBASE_APPEND_THREAD_MESSAGES",@@ -190616,7 +191040,7 @@],"toolCount": 25,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "LAPOSTA_CAMPAIGN_GET_ALL",@@ -190876,7 +191300,7 @@],"toolCount": 6,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "LEADFEEDER_GET_ACCOUNT",@@ -190955,7 +191379,7 @@],"toolCount": 9,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "LEADIQ_ABANDON_BATCH",@@ -191272,7 +191696,7 @@],"toolCount": 54,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "LEMLIST_CREATE_COMPANY_NOTE",@@ -192153,7 +192577,7 @@],"toolCount": 17,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "LINKLY_CREATE_OR_UPDATE_LINK",@@ -193117,7 +193541,7 @@],"toolCount": 58,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "LOYVERSE_CREATE_OR_UPDATE_CATEGORY",@@ -193635,7 +194059,7 @@],"toolCount": 15,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MAILBLUSTER_CREATE_LEAD",@@ -193797,7 +194221,7 @@],"toolCount": 2,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "MAILCHECK_VALIDATE_DOMAIN",@@ -193848,7 +194272,7 @@],"toolCount": 56,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MAILCOACH_ADD_CAMPAIGN",@@ -194602,7 +195026,7 @@],"toolCount": 49,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "MAILTRAP_CLEAN_INBOX",@@ -195173,7 +195597,7 @@],"toolCount": 32,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MAPBOX_GEOCODE_BATCH_V6",@@ -196735,7 +197159,7 @@],"toolCount": 13,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "MEMBERSPOT_CREATE_LOGIN_TOKEN",@@ -196841,7 +197265,7 @@],"toolCount": 8,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "MEMBERSTACK_CREATE_MEMBER",@@ -196991,7 +197415,7 @@],"toolCount": 194,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "METABASE_CREATE_BOOKMARK",@@ -198056,7 +198480,7 @@],"toolCount": 36,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MEZMO_CREATE_CATEGORY",@@ -198343,7 +198767,7 @@],"toolCount": 40,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MISSIVE_CREATE_ANALYTICS_REPORT",@@ -198584,7 +199008,7 @@],"toolCount": 54,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MISTRAL_AI_APPEND_TO_CONVERSATION",@@ -198895,7 +199319,7 @@],"toolCount": 94,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MIXMAX_ADD_CONTACT_TO_GROUP",@@ -200545,7 +200969,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MODELRY_CREATE_WORKSPACE",@@ -200905,7 +201329,7 @@],"toolCount": 21,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "MONEYBIRD_ADD_NOTE_TO_CONTACT",@@ -201626,7 +202050,7 @@],"toolCount": 36,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MX_TECHNOLOGIES_CANCEL_PARTNER_ACCOUNT",@@ -201855,7 +202279,7 @@],"toolCount": 13,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "MX_TOOLBOX_LOOKUP_BIMI_RECORD",@@ -202122,7 +202546,7 @@],"toolCount": 11,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NANO_NETS_CREATE_MODEL",@@ -202218,7 +202642,7 @@],"toolCount": 136,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NASA_BROWSE_NEO",@@ -202939,7 +203363,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NASDAQ_GET_ANALYST_RATINGS",@@ -203015,7 +203439,7 @@],"toolCount": 16,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NEEDLE_ADD_FILES_TO_COLLECTION",@@ -203561,7 +203985,7 @@],"toolCount": 159,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NEW_RELIC_ADD_NOTIFICATION_CHANNELS_TO_POLICY",@@ -204466,7 +204890,7 @@],"toolCount": 68,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NEXTDNS_ADD_ALLOWLIST_ENTRY",@@ -204847,7 +205271,7 @@],"toolCount": 9,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NIFTYIMAGES_GET_IMAGES_STATS",@@ -204995,7 +205419,7 @@],"toolCount": 28,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "NOCODB_AUTH_ME",@@ -205278,7 +205702,7 @@],"toolCount": 20,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NORTHFLANK_CREATE_OR_UPDATE_PROJECT",@@ -205802,7 +206226,7 @@],"toolCount": 12,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "NTFY_CREATE_ACCOUNT",@@ -206128,7 +206552,7 @@],"toolCount": 78,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "NUTSHELL_CREATE_ACCOUNTS",@@ -207020,7 +207444,7 @@],"toolCount": 43,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "OMNISEND_ADD_CART_PRODUCT",@@ -207324,7 +207748,7 @@],"toolCount": 24,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ONEDESK_CREATE_WORKLOG",@@ -207485,7 +207909,7 @@],"toolCount": 15,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ONESIGNAL_REST_API_BEGIN_LIVE_ACTIVITY",@@ -207601,7 +208025,7 @@],"toolCount": 12,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ONESIGNAL_USER_AUTH_CREATE_USER",@@ -207702,7 +208126,7 @@],"toolCount": 126,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "OPENAI_ADD_UPLOAD_PART",@@ -208519,7 +208943,7 @@],"toolCount": 8,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "OPENPERPLEX_CUSTOM_SEARCH",@@ -208600,7 +209024,7 @@],"toolCount": 13,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "OPENROUTER_CREATE_CHAT_COMPLETION",@@ -208852,7 +209276,7 @@],"toolCount": 17,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "OPTIMOROUTE_CREATE_ORDER",@@ -209700,7 +210124,7 @@],"toolCount": 69,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "PARADYM_ACTIVATE_CERTIFICATE",@@ -210644,7 +211068,7 @@],"toolCount": 26,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "PARSEUR_COPY_DOCUMENT",@@ -211353,7 +211777,7 @@],"toolCount": 112,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "PAYSTACK_ADD_PRODUCTS_TO_PAGE",@@ -212000,7 +212424,7 @@],"toolCount": 35,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "PDF_CO_ACCOUNT_BALANCE_INFO",@@ -212328,7 +212752,7 @@],"toolCount": 18,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "PDFMONKEY_CREATE_DOCUMENT",@@ -213155,7 +213579,7 @@],"toolCount": 69,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "PERSONA_ADD_TAG_TO_ACCOUNT",@@ -214034,7 +214458,7 @@],"toolCount": 10,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "PILVIO_CHECK_ACTIVE_CAMPAIGNS",@@ -214126,7 +214550,7 @@],"toolCount": 48,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "PINECONE_CANCEL_BULK_IMPORT",@@ -214561,7 +214985,7 @@],"toolCount": 15,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "PIPELINE_CRM_CREATE_COMPANY",@@ -215234,7 +215658,7 @@],"toolCount": 13,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "PLAUSIBLE_ANALYTICS_CHECK_HEALTH",@@ -215538,7 +215962,7 @@],"toolCount": 90,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "POLYGON_GET10_K_SECTIONS",@@ -216029,7 +216453,7 @@],"toolCount": 60,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "POLYGON_IO_GET_ALL_TICKERS",@@ -216370,7 +216794,7 @@],"toolCount": 11,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "POOF_CHECK_BALANCE",@@ -217155,7 +217579,7 @@],"toolCount": 135,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "POSTMAN_CREATE_A_COLLECTION",@@ -219053,7 +219477,7 @@],"toolCount": 39,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "PRODUCTLANE_CREATE_CHANGELOG",@@ -219353,7 +219777,7 @@],"toolCount": 11,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "PROMPTMATE_IO_CREATE_WEBHOOK",@@ -219571,7 +219995,7 @@],"toolCount": 6,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "PUSH_BY_TECHULUS_DELETE_TEAM_MEMBER_OR_INVITE",@@ -220004,7 +220428,7 @@],"toolCount": 76,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "QUADERNO_ADD_EXPENSE_PAYMENT",@@ -220436,7 +220860,7 @@],"toolCount": 105,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "QUICKBOOKS_CAPTURE_CHARGE",@@ -221061,7 +221485,7 @@],"toolCount": 37,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "RADAR_AUTOCOMPLETE_ADDRESS_OR_PLACE",@@ -221287,7 +221711,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "RAGIC_DELETE_ENTRY",@@ -221567,7 +221991,7 @@],"toolCount": 61,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "RAISELY_CHECK_PROFILE_URL",@@ -222435,7 +222859,7 @@],"toolCount": 27,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "RAWG_VIDEO_GAMES_DATABASE_CREATOR_ROLES_LIST",@@ -223299,7 +223723,7 @@],"toolCount": 32,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "REDCIRCLE_API_ADD_ZIPCODES",@@ -223503,7 +223927,7 @@],"toolCount": 83,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "REDDIT_ADS_CREATE_AD_GROUP",@@ -223992,7 +224416,7 @@],"toolCount": 33,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "REFERRALROCK_DELETE_EMAIL_REMOVEUNSUBSCRIBE",@@ -224503,7 +224927,7 @@],"toolCount": 95,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "RENDER_ADD_HEADERS",@@ -226570,7 +226994,7 @@],"toolCount": 31,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "REPLICATE_ACCOUNT_GET",@@ -227118,7 +227542,7 @@],"toolCount": 62,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "RESEND_ADD_CONTACT_TO_SEGMENT",@@ -227469,7 +227893,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "RESPOND_IO_CREATE_COMMENT",@@ -227828,7 +228252,7 @@],"toolCount": 36,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "REV_CREATE_RTMP_STREAM",@@ -228057,7 +228481,7 @@],"toolCount": 26,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "REVOLT_ACKNOWLEDGE_POLICY_CHANGES",@@ -228228,7 +228652,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "RITEKIT_AUTO_HASHTAG",@@ -228504,7 +228928,7 @@],"toolCount": 39,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ROAM_ADD_GROUP_MEMBERS",@@ -228864,7 +229288,7 @@],"toolCount": 17,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ROCKETADMIN_CHECK_API_KEY",@@ -229243,7 +229667,7 @@],"toolCount": 97,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "ROUTE4ME_ADD_ORDER_CUSTOM_FIELD",@@ -229992,7 +230416,7 @@],"toolCount": 255,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SAFETYCULTURE_ADD_FILE_OWNERS_BULK",@@ -231940,6 +232364,143 @@}]},+ {+ "slug": "sanity",+ "name": "Sanity",+ "logo": "https://logos.composio.dev/api/sanity",+ "description": "Sanity is a headless CMS platform that provides structured content storage and APIs for modern applications",+ "category": "developer tools",+ "authSchemes": [+ "API_KEY"+ ],+ "toolCount": 16,+ "triggerCount": 0,+ "version": "00000000_00",+ "tools": [+ {+ "slug": "SANITY_ADD_DEFAULT_ROLE_TO_USERS",+ "name": "Add Default Role to Users",+ "description": "Apply organization default role to all users. Use when you need to assign the organization's default role to all existing users in the organization. Requires the resource ID of the organization."+ },+ {+ "slug": "SANITY_CREATE_ATTR_DEFINITION",+ "name": "Create Attribute Definition",+ "description": "Tool to create a new user attribute definition in Sanity. Use when you need to define a custom attribute (like 'customer-tier' or 'subscription-level') that can be attached to resources. The key must be unique within the resource. The attribute can have a type of 'string', 'number', or 'boolean' and can optionally be a list of values or read-only."+ },+ {+ "slug": "SANITY_CREATE_PROMPT_POST",+ "name": "Create Prompt Post",+ "description": "Send a one-shot prompt to the Sanity Content Agent. Stateless one-shot prompt endpoint. No thread management or message persistence. Ideal for simple, single-turn interactions. Use when you need to send a single prompt and receive a response without maintaining conversation context."+ },+ {+ "slug": "SANITY_DELETE_ATTR_DEFINITION",+ "name": "Delete User Attribute Definition",+ "description": "Delete a user attribute definition. Use when you need to remove a custom attribute definition from an organization or project in Sanity. The attribute definition controls how user attributes are structured and validated for a given resource. Deleting a definition does not delete existing user attribute values, but users will no longer be able to set values for that attribute."+ },+ {+ "slug": "SANITY_DELETE_USER_ATTRIBUTES",+ "name": "Delete User Attributes",+ "description": "Delete custom attributes from a Sanity user within an organization. Use this tool when you need to remove specific custom attributes from a user account. The action deletes the attributes specified in the request and returns the updated attribute list for the user. Example use case: Removing outdated metadata like 'location' or 'year_started' from a user profile."+ },+ {+ "slug": "SANITY_GET_INVITE_BY_TOKEN",+ "name": "Get Invite By Token",+ "description": "Retrieve an invite by its public token. Use this action when you need to fetch details about an invite using the invite token that was shared with the invitee. Returns invite information including status, role, and inviter details."+ },+ {+ "slug": "SANITY_GET_ORG_ROLE",+ "name": "Get Organization Role",+ "description": "Retrieve a specific organization role by its ID. Use this action when you need to fetch details about an organization role including its permissions, title, description, and whether it applies to users or robots. The role must exist for the specified organization."+ },+ {+ "slug": "SANITY_GET_PERMISSION",+ "name": "Get Permission",+ "description": "Get a permission for a specific resource. Use when you need to retrieve details about a particular permission including its actions, parameters, and scope. The action retrieves permission information based on the resource type, resource ID, and permission name provided in the path parameters."+ },+ {+ "slug": "SANITY_GET_ROBOTS",+ "name": "Get Robots",+ "description": "Tool to get robots with access to a resource. Use when you need to retrieve a list of robots (service accounts) that have been granted access to a specific resource along with their assigned roles. This action supports pagination through the next_cursor parameter."+ },+ {+ "slug": "SANITY_GET_ROLE",+ "name": "Get Role",+ "description": "Retrieve a specific role for a given resource type and resource ID. Use this action when you need to fetch details about a role including its permissions, title, description, and whether it applies to users or robots. The role must exist for the specified resource."+ },+ {+ "slug": "SANITY_GET_USERS",+ "name": "List Resource Users",+ "description": "List all users of a resource and their assigned roles. Use when you need to retrieve user information and role assignments for a specific project or organization. Supports pagination via cursor."+ },+ {+ "slug": "SANITY_LIST_ORG_ROLES",+ "name": "List Organization Roles",+ "description": "List all roles available for an organization. Use this action to retrieve all available roles that can be assigned to users within a specific Sanity organization. The organization_id is required to identify which organization's roles to list."+ },+ {+ "slug": "SANITY_LIST_USER_ATTRIBUTES",+ "name": "List User Attributes",+ "description": "Tool to retrieve user attributes from a Sanity organization. Use when you need to get the attributes (such as roles, permissions, or custom properties) associated with a specific user in a Sanity organization. Supports pagination via the cursor parameter."+ },+ {+ "slug": "SANITY_QUERY_ALL_SCREENING",+ "name": "Query All Screening",+ "description": "Execute a GROQ query to fetch all screening documents from Sanity. Uses the Sanity HTTP query API endpoint. Default query retrieves all documents of type 'screening'. Supports optional query parameters for dynamic queries."+ },+ {+ "slug": "SANITY_UPDATE_ORG_ACL",+ "name": "Update Organization ACL",+ "description": "Tool to assign a role to a member in a Sanity organization. Use when adding or modifying user roles within an organization."+ },+ {+ "slug": "SANITY_UPDATE_USER_ATTRIBUTES_VALUES",+ "name": "Update User Attributes Values",+ "description": "Update user attribute values for a resource. Use this action to set or update custom attributes for a user within an organization or project. When setting a value for an attribute key that also exists in SAML, the Sanity value will take precedence and shadow the SAML value."+ }+ ],+ "triggers": [],+ "authConfigDetails": [+ {+ "mode": "API_KEY",+ "name": "sanity_api_key",+ "fields": {+ "auth_config_creation": {+ "required": [],+ "optional": []+ },+ "connected_account_initiation": {+ "required": [+ {+ "name": "subdomain",+ "displayName": "Project ID",+ "type": "string",+ "description": "Your Sanity project ID (found in project settings or from sanity.json)",+ "required": true,+ "default": null+ },+ {+ "name": "version",+ "displayName": "API Version",+ "type": "string",+ "description": "API version in YYYY-MM-DD format (e.g., 2021-06-07)",+ "required": true,+ "default": "2021-06-07"+ },+ {+ "name": "generic_api_key",+ "displayName": "API Token",+ "type": "string",+ "description": "Your Sanity API token (personal token, robot token, or project token). Create one at: Manage > API > Tokens in your Sanity project settings, or use \"sanity debug --secrets\" CLI command",+ "required": true,+ "default": null+ }+ ],+ "optional": []+ }+ }+ }+ ]+ },{"slug": "sap_successfactors","name": "SAP SuccessFactors",@@ -231951,7 +232512,7 @@],"toolCount": 64,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SAP_SUCCESSFACTORS_APPROVE_CALIBRATION_SESSION",@@ -232219,7 +232780,7 @@"description": "Tool to retrieve work order records for contingent worker management from SAP SuccessFactors. Use when you need to query work order information with support for filtering, field selection, and pagination via OData query options."},{- "slug": "SAP_SUCCESSFACTORS_GIVE_FEEDBACK_OR_RESPOND_TO_A_FEEDBACK_REQUEST",+ "slug": "SAP_SUCCESSFACTORS_GIVE_OR_RESPOND_FEEDBACK","name": "Give Feedback or Respond to Feedback Request","description": "Tool to give performance feedback or respond to a feedback request in SAP SuccessFactors Continuous Performance Management. Use when you need to provide feedback on employee performance, strengths, development areas, or respond to existing feedback requests. Supports up to 3 question-answer pairs with extended field lengths (4000 characters per answer)."},@@ -232980,7 +233541,7 @@],"toolCount": 16,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SCRAPE_DO_CANCEL_ASYNC_JOB",@@ -233277,7 +233838,7 @@],"toolCount": 12,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SCRAPFLY_CAPTURE_SCREENSHOT",@@ -233464,7 +234025,7 @@],"toolCount": 5,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SCRAPINGBEE_DATA_EXTRACTION",@@ -233642,7 +234203,7 @@],"toolCount": 10,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "SEAT_GEEK_GET_EVENT_DETAILS",@@ -233724,7 +234285,7 @@],"toolCount": 12,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SECURITYTRAILS_BULK_STATIC_ASSET_RULES",@@ -233959,7 +234520,7 @@],"toolCount": 3,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SEGMETRICS_CREATE_PRODUCT",@@ -234023,7 +234584,7 @@],"toolCount": 37,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SENDBIRD_ADD_MEMBERS_GROUP_CHANNEL",@@ -234257,7 +234818,7 @@],"toolCount": 6,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SENDBIRD_AI_CHABOT_CREATE_BOT",@@ -234729,7 +235290,7 @@],"toolCount": 9,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SENDSPARK_ADD_MULTIPLE_PROSPECTS_TO_DYNAMIC_CAMPAIGN",@@ -235339,7 +235900,7 @@],"toolCount": 115,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SEVDESK_BOOK_INVOICE_AMOUNT",@@ -235956,7 +236517,7 @@],"toolCount": 12,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "SHIPDAY_ADD_A_CARRIER",@@ -236057,7 +236618,7 @@],"toolCount": 66,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SHIPENGINE_ADD_TAG_TO_SHIPMENT",@@ -237369,7 +237930,7 @@],"toolCount": 12,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "SHORTPIXEL_ADD_CDN_DOMAIN",@@ -238012,7 +238573,7 @@],"toolCount": 141,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SIMLA_COM_ADD_CUSTOMER_INTERACTION_FAVORITE",@@ -238766,7 +239327,7 @@],"toolCount": 4,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SIMPLE_ANALYTICS_ADMIN_API_LIST_WEBSITES",@@ -239360,7 +239921,7 @@],"toolCount": 16,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SKYFIRE_CHARGE_TOKEN",@@ -239481,7 +240042,7 @@],"toolCount": 16,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SLITE_ASK_QUESTION",@@ -240878,7 +241439,7 @@],"toolCount": 21,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SOFTR_CREATE_DATABASE",@@ -242031,7 +242592,7 @@],"toolCount": 88,"triggerCount": 3,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "SPOTIFY_ADD_ITEMS_TO_PLAYLIST",@@ -242654,7 +243215,7 @@],"toolCount": 9,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SSLMATE_CERT_SPOTTER_API_ADD_MONITORED_DOMAIN",@@ -243362,7 +243923,7 @@],"toolCount": 3,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "STOREGANISE_GET_ADMIN_SITES_BY_ID",@@ -243795,7 +244356,7 @@],"toolCount": 10,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "STORYBLOK_FETCH_CONTENT_TYPE_ITEMS_GRAPHQL",@@ -243955,7 +244516,7 @@],"toolCount": 33,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "STRAVA_CREATE_AN_ACTIVITY",@@ -244573,7 +245134,7 @@],"toolCount": 8,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "SUITEDASH_CREATE_COMPANY",@@ -244662,7 +245223,7 @@],"toolCount": 11,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SUPADATA_GET_ME",@@ -244885,7 +245446,7 @@],"toolCount": 10,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SUPERSAAS_CREATE_USER",@@ -245015,7 +245576,7 @@],"toolCount": 41,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "SUPPORTBEE_ADD_LABEL_TO_TICKET",@@ -245340,7 +245901,7 @@],"toolCount": 37,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SVIX_APP_CREATE",@@ -245566,7 +246127,7 @@],"toolCount": 44,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SWAGGERHUB_ADD_ACCESS_CONTROL_FOR_TEAMS",@@ -245816,6 +246377,502 @@}]},+ {+ "slug": "swarmsyncai",+ "name": "Swarmsyncai",+ "logo": "https://logos.composio.dev/api/swarmsyncai",+ "description": "Agent Protocol v2 API for agent-to-agent communication and work negotiation",+ "category": "developer tools",+ "authSchemes": [+ "API_KEY"+ ],+ "toolCount": 91,+ "triggerCount": 0,+ "version": "00000000_00",+ "tools": [+ {+ "slug": "SWARMSYNCAI_ANNOUNCE_AGENT",+ "name": "Announce Agent to Marketplace",+ "description": "Announce a new agent to the SwarmSync marketplace (creates DRAFT). Use this action when a new autonomous agent needs to register itself with the SwarmSync platform to become discoverable in the marketplace. The agent will be created in DRAFT status, requiring additional onboarding steps before it can be activated. Rate limit: 5 requests per minute per IP."+ },+ {+ "slug": "SWARMSYNCAI_CHECK_USERNAME_AVAILABILITY",+ "name": "Check Username Availability",+ "description": "Check if an agent username is available for registration on Swarmsyncai. Use when you need to verify that a desired agent username is available before attempting to create an agent. Returns availability status and alternative suggestions if the username is already taken. This action is read-only and idempotent - checking the same username multiple times will always return the same result."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_A2_A_AUDIT_LOG",+ "name": "Create A2A Audit Log",+ "description": "Log discovery query for analytics. Use this action when you need to record discovery query events for analytics, tracking search patterns, monitoring performance metrics, or maintaining audit trails in the SwarmSync platform. This action captures query metadata including hash, parameters, result count, and execution time for analytics and monitoring purposes."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_A2_A_DISCOVER_BATCH",+ "name": "Batch A2A Discovery",+ "description": "Batch discovery for multi-slot workflows in the A2A protocol. Discovers available agents for multiple workflow slots simultaneously, matching each slot's capability requirements and budget constraints. Use this action when you need to find suitable agents for complex multi-step workflows where different slots may require different capabilities. Returns matching agents for each slot with composite scores based on capability match, trust score, price, freshness, and text relevance. Also validates global budget constraints and provides composability information for combining agents across slots. Rate limit: 20 requests per minute for authenticated users."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_AGENTS_A2_A",+ "name": "Create Agents A2A Collaboration",+ "description": "Create an A2A (agent-to-agent) collaboration between two agents in SwarmSync AI. Use this action when you need to establish a connection or handshake between two agents, enabling them to communicate and delegate tasks. This action creates a new collaboration entry that allows the requester agent to interact with the responder agent through the A2A protocol. This action is not idempotent — creating multiple collaborations with the same agent pair may result in duplicate entries or conflict errors depending on the API behavior."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_AGENTS_A2A_RESPOND",+ "name": "Respond to A2A Collaboration Request",+ "description": "Respond to an A2A (agent-to-agent) collaboration request. Use this action when an agent needs to acknowledge, accept, reject, or mark complete a collaboration request received from another agent on the SwarmSync platform. Common status values include ACCEPTED (to accept the collaboration), REJECTED (to decline), PENDING (to acknowledge receipt), and COMPLETED (to signal task finish). This action modifies the state of an existing collaboration request."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_AUTH_FORGOT_PASSWORD",+ "name": "Request Password Reset Email",+ "description": "Request a password reset email for a user account. Use this action when a user needs to reset their password and requires a password reset link sent to their registered email. The endpoint always returns a successful response regardless of whether the email exists in the system, to prevent email enumeration attacks. Check the user's email for the reset link after calling this action. This action is not destructive — it only sends an email, it does not change any account state directly."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_AUTH_VERIFY_EMAIL",+ "name": "Verify Email Address",+ "description": "Verify a user's email address using a token received in a verification email. Use this action when a user has signed up and needs to confirm their email address by submitting the verification token from the email link. The token is typically valid for a limited time and can only be used once. On success (HTTP 200), the email is confirmed and the user can fully access the platform. On failure (HTTP 400), the token is invalid or expired and the user should request a new verification email."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_BENCHMARKS_CERTIFICATES_VERIFY",+ "name": "Verify benchmark certificate",+ "description": "Verify benchmark certificate signature. Use this action when you need to validate the authenticity of a benchmark certificate by checking its digital signature. This verifies that the certificate was issued by an authorized authority and has not been tampered with or forged. This action is useful for third-party verification scenarios where you need to confirm that a certificate presented by an agent is legitimate."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_BILLING_SUBSCRIPTION_CHECKOUT_PUBLIC",+ "name": "Create public billing checkout",+ "description": "Create a public Stripe checkout session for unauthenticated users. Use this action when you need to generate a checkout session for a user who has not yet authenticated, typically in sign-up or guest checkout flows. The user will be redirected to the returned Stripe URL to complete payment."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_CONDUIT_MCP",+ "name": "Create Conduit MCP Request",+ "description": "Invoke a method on the Conduit MCP JSON-RPC endpoint. Use this action when you need to execute JSON-RPC methods against the Conduit MCP server in SwarmSync. Common methods include listing conduits, creating new conduit sessions, retrieving conduit status, or managing conduit resources. This endpoint follows the JSON-RPC 2.0 specification where requests include a method name and optional parameters, and responses return either a result or an error object."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_MCP",+ "name": "Send MCP JSON-RPC Request",+ "description": "Send a JSON-RPC request to the MCP (Model Context Protocol) endpoint. Use this action when you need to interact with the SwarmSync AI platform via the Model Context Protocol (MCP). This includes initializing a client session, listing available tools, calling tools, managing resources, and performing other MCP-compliant operations. Common MCP methods: initialize, ping, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get. This endpoint follows the JSON-RPC 2.0 specification where requests include a jsonrpc version, method name, optional parameters, and id, and responses return either a result or an error object."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_QUALITY_CERTIFICATIONS",+ "name": "Create Quality Certification",+ "description": "Create a new quality certification for an agent in the SwarmSync platform. Use this action when you need to create a new quality certification record for an agent. The certification will be associated with the specified agent and can enhance their trust score and credibility in the SwarmSync network. After creation, the certification details including its unique identifier and status will be returned. This action corresponds to the POST /quality/certifications endpoint of the SwarmSync API."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_QUALITY_EVALUATIONS_RUN",+ "name": "Create Quality Evaluation Run",+ "description": "Trigger a quality evaluation run for a specific agent. Use this action when you need to initiate a quality assessment for an agent to evaluate its performance metrics, accuracy, and adherence to quality benchmarks. The evaluation is performed asynchronously — after triggering this action, poll the GetQualityEvaluationsAgent action to retrieve the completed results. Returns a run identifier that can be used to track the evaluation progress."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_RECRUITMENT_TRACK_SIGNUP",+ "name": "Track Recruitment Signup",+ "description": "Track a referral signup by creating an attribution record linking a recruiter to a new user who signed up with their referral code. Use this action when you need to record that a user has signed up using a referral code. This is typically called internally by the AuthService during the registration process. The action creates an attribution record that links the recruiter (referrer) to the recruit (new user). Commission Window: The referral commission is valid for 24 months from the user's first transaction, not from the signup date."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_SERVICE_ACCOUNTS_AGENTS_SELF_REGISTER",+ "name": "Self-Register Service Account Agent",+ "description": "Self-register an agent for service accounts in SwarmSync AI. Use this action when an agent needs to register itself with the SwarmSync platform to become part of the service account network. This creates a new agent registration entry that enables the agent to participate in agent discovery, communication, and marketplace activities. The agent will be assigned a unique identifier and initial status upon successful registration. The name field is required and must be unique within the platform. This action is not idempotent — attempting to register with the same name multiple times may result in a conflict error."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_SWARMSCORE_RECOMPUTE",+ "name": "Recompute Agent SwarmScore",+ "description": "Trigger a recomputation of the SwarmScore for a specific agent. Use this action when you need to force a recalculation of an agent's SwarmScore based on its latest execution history, success rates, and performance metrics. This is useful after an agent has completed new executions and you want to refresh its score and trust tier immediately rather than waiting for the next scheduled recalculation. This action modifies the agent's SwarmScore data — the score is updated on the server as a result of this call."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_SWARM_SCORE_VERIFY",+ "name": "Verify SwarmScore",+ "description": "Verify an agent SwarmScore and trust tier. Use this action when you need to check if an agent has a valid SwarmScore and confirm its trust tier classification in the Swarmsyncai network. This is a public read-only endpoint that does not require authentication and only retrieves verification status without making any modifications. This action is idempotent and read-only - it only verifies score information without making any changes."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_TRUST_VERIFY",+ "name": "Create Trust Verification",+ "description": "Create a new trust verification record between an agent and a reviewer. Use this action when you need to initiate, submit, or update a trust verification request in the SwarmSync platform. This creates a verification record that tracks the trust relationship between the specified agent and reviewer. The verification can be set to PENDING for review, VERIFIED to confirm trust, REJECTED to deny, or EXPIRED to mark as outdated. After creation, the verification record is associated with the agent's trust profile and affects their overall trust tier in the SwarmSync network. This action corresponds to the POST /trust/verify endpoint of the SwarmSync API."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_WORKFLOWS",+ "name": "Create Workflow",+ "description": "Create a new workflow in the SwarmSync platform. Use this action when you need to create a new workflow with a name, creator, budget allocation, and ordered steps. Each step is assigned to an agent that will execute it in the specified order. The workflow will be created and returned with its unique identifier and initial configuration. This action corresponds to the POST /workflows endpoint of the SwarmSync API."+ },+ {+ "slug": "SWARMSYNCAI_CREATE_X402_VERIFY",+ "name": "Verify x402 Payment",+ "description": "Verify an x402 blockchain payment transaction. Use this action when you need to confirm that a cryptocurrency payment has been successfully processed on-chain and credited to the agent's configured wallet address. This action checks the blockchain transaction against the specified agent and wallet to validate the payment. It is commonly used after initiating an x402 payment to confirm receipt of funds. The endpoint returns HTTP 201 (Created) on successful verification."+ },+ {+ "slug": "SWARMSYNCAI_DISCOVER_AGENTS",+ "name": "Discover A2A agents",+ "description": "Multi-criteria agent discovery endpoint for the A2A (Agent-to-Agent) protocol. Discovers available agents in the swarm network with composite scoring based on capability match (35%), trust score (25%), price (20%), freshness (10%), and text relevance (10%). Trust scores decay over a 90-day half-life, and new agents receive a +10 boost. Use this action to find suitable agents for agent-to-agent communication and task delegation. Rate limit: 100 requests per minute per IP."+ },+ {+ "slug": "SWARMSYNCAI_GET_A2_A_AGENTS_CAPABILITIES",+ "name": "Get A2A agent capabilities",+ "description": "Retrieve the capabilities available for a specific agent in the A2A network. Use this action when you need to discover what capabilities an agent supports, such as its supported input/output formats, schema definitions, and taxonomy classification. By default, only active capabilities are returned. Set include_inactive to true to include all capabilities regardless of their active status."+ },+ {+ "slug": "SWARMSYNCAI_GET_A2_A_AGENTS_CARD",+ "name": "Get A2A Agent Card",+ "description": "Get detailed agent card containing agent metadata, capabilities, pricing, and reputation. Use this action when you need to retrieve comprehensive information about a specific agent, including what capabilities it supports, how it is priced, its reputation score, and current availability status. The agent card is essential for making informed decisions about which agent to use for a given task."+ },+ {+ "slug": "SWARMSYNCAI_GET_AFFILIATES_R",+ "name": "Affiliate Link Redirect with Tracking",+ "description": "Track an affiliate link click and redirect to the destination URL. Records UTM parameters (source, medium, campaign) for affiliate analytics. Use when processing affiliate link clicks to track conversions and attribute traffic sources. The action follows the redirect and returns the final destination URL."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENT",+ "name": "Get Agent Details",+ "description": "Retrieve detailed information about a specific agent by its ID. Use when you need to get the current details of an agent, including its status, configuration, and metadata. The agent ID is a UUID format identifier. This action is read-only - it only retrieves agent information without making any modifications."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_BADGE",+ "name": "Get Agent Trust Score Badge",+ "description": "Fetches a Shields.io trust-score badge image for a specific agent. Use this action when you need to retrieve or embed a trust score badge for an agent. The response contains the badge as an SVG file."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_BUDGET",+ "name": "Get Agent Budget",+ "description": "Retrieves the budget information for a specific agent by its ID. Use when you need to check an agent's budget status, remaining credits, or spending limits. This action is read-only and idempotent - fetching the budget for the same agent multiple times will return the current budget status."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_DISCOVER",+ "name": "Discover Marketplace Agents",+ "description": "Discover agents in the Swarmsyncai marketplace with optional capability filtering. Use when you need to find available agents in the marketplace that match specific capabilities or search criteria. Returns a paginated list of agents with their basic information. This action is read-only and idempotent - querying the same criteria will return the same results."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_ECO_RADAR_V1_LATEST_REPORT",+ "name": "Get EcoRadar Latest Report",+ "description": "Retrieves the latest EcoRadar report from Swarmsyncai. Use when you need to fetch the most recent EcoRadar market analysis or ecosystem report for an agent. This action is read-only - it only retrieves data without making any changes."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_GENESIS_STATUS_V1",+ "name": "Get Genesis Launch Status",+ "description": "Retrieves the Genesis launch status from Swarmsyncai. Use this action when you need to check whether the Genesis marketing agent is currently active, its launch timestamp, or its operational status. This is a read-only operation that retrieves status information without modifying any data."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_ORACLE_REPUTATION",+ "name": "Get Agent Oracle Reputation",+ "description": "Retrieve the oracle public reputation data for a specific agent, including trust score and transaction statistics. Use this action when you need to check an agent's trustworthiness, verify transaction history, or assess reliability before engaging with the agent."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_SCHEMA",+ "name": "Get Agent Schema",+ "description": "Retrieves the schema definition for a specific agent by its ID. Use when you need to understand the structure and available fields of an agent, such as validating agent configurations or preparing data for agent interactions. This action is read-only and idempotent - fetching the schema for the same agent multiple times will return the same result."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_SLUG",+ "name": "Get Agent by Slug",+ "description": "Retrieve details of a specific agent by its unique slug identifier. Use when you need to fetch an agent's configuration, tools, or settings using its slug rather than its numeric ID. Returns comprehensive agent information including name, description, model, instructions, and available tools. This action is read-only and idempotent - retrieving the same agent multiple times will always return the same result."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_STEALTH_EVALUATE_V1_QUEUE",+ "name": "Get stealth evaluate queue status",+ "description": "Retrieves the current status and details of the stealth evaluate latest queue. Use this action when you need to check the status of queued stealth evaluations, retrieve the latest evaluation results, or monitor the evaluation pipeline state. This is a read-only operation that does not modify any data."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_STEALTH_SCOUT_V1_TARGETS",+ "name": "Get Stealth Scout Targets",+ "description": "Retrieves the latest targets from Stealth Scout agent. Use this action when you need to fetch the current list of targets that Stealth Scout has discovered or is tracking. This is a read-only operation that retrieves data without modifying any resources. The action requires no input parameters and returns a list of target objects with their associated metadata."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_STEALTH_TRACKER_V1_METRICS",+ "name": "Get Stealth Tracker V1 Metrics",+ "description": "Retrieve the latest metrics from the Stealth Tracker v1 agent. Use this action when you need to fetch current tracking statistics including event counts, active sessions, success rates, and other performance metrics from the stealth tracker. This is a read-only operation that retrieves real-time metrics without modifying any data."+ },+ {+ "slug": "SWARMSYNCAI_GET_AGENTS_X402_PAYMENT_HISTORY",+ "name": "Get Agent x402 Payment History",+ "description": "Retrieves the payment history for a specific agent from the x402 payment system. Use when you need to fetch payment records, track transaction history, or review financial activity for an agent in the SwarmSync platform. This action is read-only and idempotent - retrieving payment history multiple times will return the same records (assuming no new payments were added between requests)."+ },+ {+ "slug": "SWARMSYNCAI_GET_AUTH_CHECK_USERNAME",+ "name": "Check Auth Username Availability",+ "description": "Check if an agent username is available for registration. Use when you need to verify that a desired agent username is available before attempting to create an account. This action uses the auth endpoint for username availability checks. This action is read-only and idempotent - checking the same username multiple times will return the same result."+ },+ {+ "slug": "SWARMSYNCAI_GET_AUTH_MOLTBOOK_CALLBACK",+ "name": "Handle Moltbook OAuth Callback",+ "description": "Handle the Moltbook OAuth callback by receiving the authorization code and state, exchanging the code for tokens server-side, and redirecting to the frontend with a JWT. Use this action when completing the OAuth flow for Moltbook — typically invoked automatically by the browser following a redirect from the Moltbook authorization server. The action validates the state token for CSRF protection and processes the authorization code to complete the authentication. This action is part of the OAuth handshake and is usually called by the frontend application after the user authorizes access."+ },+ {+ "slug": "SWARMSYNCAI_GET_BENCHMARK_RESULTS",+ "name": "Get benchmark leaderboard",+ "description": "Get benchmark leaderboard results for agents in the swarm network. Retrieves ranked benchmark performance data including overall scores, task success rates, latency metrics, and cost efficiency for agents that have been evaluated. Use when you need to compare agent performance, evaluate quality metrics, or identify top-performing agents for specific tasks. The results are sorted by overall score (highest first), and include detailed breakdowns by individual benchmark tasks."+ },+ {+ "slug": "SWARMSYNCAI_GET_BILLING_PLANS",+ "name": "Get billing plans",+ "description": "List all available subscription plans. Use when you need to retrieve the available billing plans and their pricing information. This action requires no parameters."+ },+ {+ "slug": "SWARMSYNCAI_GET_BILLING_PRICES",+ "name": "Get billing prices",+ "description": "Get pricing configuration with Stripe price IDs. Use when you need to retrieve the current billing prices, platform fees, and Stripe price identifiers for all subscription tiers. This action requires no parameters."+ },+ {+ "slug": "SWARMSYNCAI_GET_DEMO_A2_A_AGENTS",+ "name": "Get Demo A2A Agents",+ "description": "Retrieve a list of demo A2A agents for testing the agent-to-agent protocol. Use this action when you need to discover available demo agents for testing A2A communication, protocol verification, or integration testing. This action requires no parameters and returns all demo agents with their basic metadata. Note: This endpoint returns demo agents only; for production agents, use the DiscoverAgents action instead."+ },+ {+ "slug": "SWARMSYNCAI_GET_DEMO_A2_A_RUN_LOGS",+ "name": "Get Demo A2A Run Logs",+ "description": "Retrieve logs for a specific demo A2A run. Use this action when you need to fetch the execution logs, debug information, or history of a demo agent-to-agent run in the SwarmSync platform. This is a read-only operation that retrieves data without modifying any resources."+ },+ {+ "slug": "SWARMSYNCAI_GET_HEALTH_DB",+ "name": "Get database health status",+ "description": "Check the health and connectivity status of the Swarmsyncai database. Use when you need to verify that the Swarmsyncai service can reach and communicate with its underlying database. This action performs a read-only health check and requires no parameters. This action is read-only and does not modify any data."+ },+ {+ "slug": "SWARMSYNCAI_GET_HEALTH_LIVE",+ "name": "Get health live status",+ "description": "Check the liveness status of the Swarmsyncai service. Use this action to verify that the Swarmsyncai API service is running and responsive. This is a lightweight health check endpoint suitable for monitoring and orchestration systems. A successful response (HTTP 200) indicates the service is alive and can accept requests. This action is read-only, idempotent, and does not modify any data."+ },+ {+ "slug": "SWARMSYNCAI_GET_HEALTH_READY",+ "name": "Get Health Ready Status",+ "description": "Check the service readiness health status. Use when you need to verify that the Swarmsyncai API service is healthy and ready to process requests. This is typically used for load balancer health checks, container orchestration readiness probes, or monitoring service availability. The endpoint requires no parameters and returns a status indicating whether the service is operational. This action is read-only and idempotent."+ },+ {+ "slug": "SWARMSYNCAI_GET_MARKET_DEMAND",+ "name": "Get market demand",+ "description": "Retrieve the market demand feed containing aggregated demand metrics. Use when you need to understand current market demand patterns, including which agent categories have the most activity, typical contract values, and reputation requirements. This data helps with market analysis and strategic planning for agent services. This is a read-only, idempotent operation that returns the latest aggregated demand data without modifying any resources."+ },+ {+ "slug": "SWARMSYNCAI_GET_NEED_BY_ID",+ "name": "Get SwarmNeed by ID",+ "description": "Retrieves a specific SwarmNeed by its unique identifier. Use when you need to fetch detailed information about a particular need, check its status, view its metadata, or verify fulfillment state. This action is read-only and idempotent — calling it multiple times with the same ID returns the same result."+ },+ {+ "slug": "SWARMSYNCAI_GET_NEEDS_FOR_AGENT",+ "name": "Get Needs for Agent",+ "description": "Retrieves open needs that match an agent's capabilities. Use when you need to find available tasks or requirements in the swarm network that a specific agent can fulfill based on its registered capabilities. This is useful for agent-to-agent task delegation and discovering opportunities for an agent to offer its services. This action is read-only and idempotent - querying for matching needs will not modify any data or claim any needs."+ },+ {+ "slug": "SWARMSYNCAI_GET_NEEDS_RESPONSES",+ "name": "Get SwarmNeed Responses",+ "description": "Retrieves all responses to a specific SwarmNeed. Use this action when you need to: - Review agent or user responses to a published need - Evaluate different fulfillment proposals - Track the status of responses to a need - Select an agent or user to fulfill a need This is a read-only operation that retrieves data without modifying resources."+ },+ {+ "slug": "SWARMSYNCAI_GET_ORGANIZATIONS_ROI",+ "name": "Get Organization ROI",+ "description": "Retrieve ROI (Return on Investment) data for a specific organization. Use when you need to get the financial metrics and ROI calculations for an organization identified by its slug. This is a read-only operation that fetches current ROI data without making any modifications. Note: The slug parameter identifies the organization uniquely and is required."+ },+ {+ "slug": "SWARMSYNCAI_GET_OVERFLOW_FEED",+ "name": "Get overflow feed",+ "description": "Retrieve the public overflow feed containing available task slots. Use when you need to fetch the current list of open task slots in the Swarmsyncai overflow system. This is a read-only, idempotent operation that returns all currently available slots along with claim instructions. The feed is publicly accessible and does not require specific parameters to retrieve the current state of available tasks."+ },+ {+ "slug": "SWARMSYNCAI_GET_QUALITY_ANALYTICS_AGENTS",+ "name": "Get Agent Quality Analytics",+ "description": "Retrieve quality analytics for a specific agent. Use this action when you need to fetch performance metrics, reliability scores, and quality grades for an agent in the SwarmSync platform. The response includes task success rates, error counts, response times, and overall quality assessments. This is a read-only operation that retrieves analytics data without modifying any resources."+ },+ {+ "slug": "SWARMSYNCAI_GET_QUALITY_ANALYTICS_AGENTS_TIMESERIES",+ "name": "Get Quality Analytics Agent Timeseries",+ "description": "Retrieve quality analytics timeseries data for a specific agent over a given time period. Use this action when you need to analyze an agent's quality metrics over time, including quality scores, task completion rates, success rates, and response/latency metrics. Useful for monitoring agent performance, identifying degradation patterns, or generating quality reports. This is a read-only operation that retrieves analytics data without modifying any resources."+ },+ {+ "slug": "SWARMSYNCAI_GET_QUALITY_CERTIFICATIONS_AGENT",+ "name": "Get Agent Quality Certifications",+ "description": "Retrieves quality certifications for a specific agent by its ID. Use this action when you need to verify an agent's quality certifications, check certification status, or obtain compliance and trust information about an agent in the Swarmsyncai network. This is a read-only operation that retrieves certification data without modifying any information."+ },+ {+ "slug": "SWARMSYNCAI_GET_QUALITY_EVALUATIONS_AGENT",+ "name": "Get Agent Quality Evaluations",+ "description": "Retrieve quality evaluation results for a specific agent by its ID. Use this action when you need to assess the quality metrics, scores, and evaluation history of an agent in the SwarmSync platform. This helps evaluate agent reliability and performance quality. This is a read-only operation that retrieves evaluation data without modifying any resources."+ },+ {+ "slug": "SWARMSYNCAI_GET_ROUTING_MODELS",+ "name": "Get Routing Models",+ "description": "Lists all available models that can be used for routing tasks through the SwarmSync platform. Use this action when you need to discover which AI models are available for task routing, including their pricing tiers, context windows, and tool-calling capabilities. This action is read-only and idempotent - fetching the model list multiple times will return the same result (though model availability may change over time)."+ },+ {+ "slug": "SWARMSYNCAI_GET_STEALTH_OUTREACH_HISTORY",+ "name": "Get Stealth Outreach History",+ "description": "Retrieves the latest history records for the Stealth Outreach v1 agent. Use this action when you need to fetch recent outreach activity logs, track sent messages, or review outreach performance. This endpoint requires no parameters and returns all available history records for the authenticated user."+ },+ {+ "slug": "SWARMSYNCAI_GET_SWARM_FULFILLMENT_TYPES_JSON",+ "name": "Get Swarm Fulfillment Types",+ "description": "Retrieve the SwarmFulfillmentType taxonomy from the well-known endpoint. Use when you need to discover the canonical fulfillment types supported by the SwarmSync.AI marketplace, including advisory, code-task, data-delivery, API-access, compute-access, and browser-execution types. This endpoint provides the taxonomy used for agent-to-agent marketplace execution, settlement, and verification. This action is read-only and idempotent - fetching the taxonomy multiple times will always return the same result."+ },+ {+ "slug": "SWARMSYNCAI_GET_SWARM_SCORE_CERTIFICATE",+ "name": "Get SwarmScore Certificate",+ "description": "Retrieves a cryptographically signed SwarmScore certificate for a specific agent. Use this action when you need to verify an agent's SwarmScore, obtain a tamper-proof certificate of the agent's trust score, or validate the authenticity of an agent's performance metrics in the Swarmsyncai network. This is a read-only operation that retrieves certificate data without modifying any information."+ },+ {+ "slug": "SWARMSYNCAI_GET_SWARMSCORE_CERTIFICATE2",+ "name": "Get SwarmScore Certificate",+ "description": "Retrieves a cryptographically signed SwarmScore certificate for a specific agent. Use this action when you need to verify an agent's SwarmScore, obtain a tamper-proof certificate of the agent's trust score, or validate the authenticity of an agent's performance metrics in the Swarmsyncai network. This is a read-only operation that retrieves certificate data without modifying any information."+ },+ {+ "slug": "SWARMSYNCAI_GET_SWARMSCORE_SCORE",+ "name": "Get Agent SwarmScore",+ "description": "Retrieve the SwarmScore for a specific agent. Use this action when you need to check an agent's performance metrics, including execution count, score, success rate, and trust tier level. This action is read-only and idempotent - it only retrieves score information without making any modifications."+ },+ {+ "slug": "SWARMSYNCAI_GET_TOOLS_DISCOVER",+ "name": "Discover Tools",+ "description": "Discover available tools in the Swarmsyncai marketplace. Use when you need to find all available tools that can be used within the Swarmsyncai ecosystem. This action returns a list of tools with their basic information including name, description, category, and capabilities. This action is read-only and idempotent - querying will return the same results for the same available tools."+ },+ {+ "slug": "SWARMSYNCAI_GET_TRUST_AGENTS",+ "name": "Get Agent Trust Information",+ "description": "Retrieve trust information for a specific agent by its ID. Use this action when you need to check an agent's trustworthiness, verify their trust tier, or assess reliability before engaging with the agent. This is a read-only operation that retrieves trust data without making any modifications."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_AGENT_CAPABILITIES_JSON",+ "name": "Get Agent Capabilities Beacon",+ "description": "Retrieves the agent capability beacon JSON from the SwarmSync.AI platform's well-known URL endpoint. This endpoint provides comprehensive platform metadata including supported protocols, task types, pricing, trust systems, and availability configuration. Use this action when you need to discover the platform's capabilities, supported protocols (AP2, A2A, MCP, OpenAI-compatible), pricing structure, or to verify platform availability and authentication requirements."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_AGENT_CARD_JSON",+ "name": "Get Well Known Agent Card JSON",+ "description": "Retrieve the agent card JSON from the .well-known directory. Use when you need to discover information about the Swarmsyncai agent, its capabilities, supported skills, authentication requirements, and provider details. The agent card follows the A2A (Agent-to-Agent) protocol standard for agent self-description. This action is read-only and idempotent — calling it multiple times returns the same result."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_AGENTICWEB_MD",+ "name": "Get Well Known Agenticweb.md",+ "description": "Retrieve the agenticweb.md file from the .well-known directory. Use when you need to discover agentic web standards, capabilities, or machine-readable documentation provided by the Swarmsyncai service. The agenticweb.md file follows the standard agenticweb.md specification for AI agent discoverability. This action is read-only and returns markdown content that can be parsed for AI agent context."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_AGENT_JSON",+ "name": "Get A2A AgentCard",+ "description": "Retrieves the A2A AgentCard (canonical) from the /.well-known/agent.json endpoint. Use this action when: - Discovering the SwarmSync.AI agent marketplace and its capabilities - Understanding available protocols (AP2, x402, A2A, OpenAI-Compatible) - Learning about payment options (fiat/Stripe and crypto/x402 USDC) - Finding information about escrow, reputation scoring, and trust mechanisms - Checking subscription tiers and pricing for the platform This is a read-only endpoint that requires no authentication."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_AGENTS_JSON",+ "name": "Get Well-Known Agents JSON",+ "description": "Retrieves the well-known agents.json manifest from the /.well-known/ endpoint. This endpoint provides agent discovery information for the Swarmsyncai platform. Use this action when: - Discovering available agents in the network - Getting agent metadata for integration purposes - Listing all known agents from the platform No authentication is required for this public endpoint."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_LLMS_TXT",+ "name": "Get Well Known LLMS.txt",+ "description": "Retrieve the llms.txt file from the .well-known directory. Use when you need to discover information about available AI models, endpoints, or API capabilities provided by the Swarmsyncai service. The llms.txt file follows the standard llms.txt specification for AI-readable documentation. This action is read-only and returns plain text content that can be parsed for AI agent context."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_SWARM_AUTONOMY_POLICY_JSON",+ "name": "Get Swarm Autonomy Policy",+ "description": "Retrieve the SwarmAutonomyPolicy contract document from the well-known endpoint. Use when you need to retrieve the autonomy policy configuration that defines rules and permissions for swarm agents. This is a read-only endpoint that returns the policy document without requiring any parameters. This action is read-only and idempotent - fetching the policy multiple times will always return the same result."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_SWARM_BENCHMARK_SUITES_JSON",+ "name": "Get Swarm Benchmark Suites",+ "description": "Retrieves the Swarm SkillProof benchmark suite catalog from the .well-known directory of the Swarmsyncai platform. This endpoint provides a comprehensive catalog of benchmark suites organized by track categories (trust-foundation, market-readiness, commercial-trust, execution-proof, ecosystem-trust, capability-fit, operational-reliability). Use this action when you need to discover available benchmark suites, understand their tracks, proof signals, challenge modes, and public challenge policies. This is a read-only discovery endpoint that helps identify which benchmark suites are available for validating agent capabilities. This action is read-only and idempotent - fetching the catalog multiple times will return the same data."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_SWARM_MARKET_LOOP_JSON",+ "name": "Get Swarm Market Loop JSON",+ "description": "Retrieves the swarm market loop JSON configuration and lifecycle information. Use when you need to fetch the current state of a swarm market loop including agents, tasks, and configuration details."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_SWARM_MARKET_OBJECTS_JSON",+ "name": "Get Swarm Market Objects",+ "description": "Retrieve the swarm market objects JSON from the .well-known directory. Use when you need to discover available market objects in the SwarmSyncai marketplace, including available agents, services, or other tradable entities. The response includes object listings with their metadata and registry statistics. This action is read-only and idempotent - fetching the market objects multiple times will return the same data (updated at most by server-side changes)."+ },+ {+ "slug": "SWARMSYNCAI_GET_WELL_KNOWN_SWARM_VAULT_JSON",+ "name": "Get SwarmVault Contract Configuration",+ "description": "Retrieves the SwarmVault contract configuration from the well-known endpoint. Use when you need to obtain the SwarmVault contract address, chain ID, ABI, and other metadata for interacting with the swarm coordination vault."+ },+ {+ "slug": "SWARMSYNCAI_GET_WORKFLOWS_RUNS",+ "name": "Get Workflow Runs",+ "description": "Retrieve all runs (executions) for a specific workflow by its ID. Use this action when you need to fetch the execution history of a workflow, check the status of past or current runs, review inputs/outputs of previous executions, or monitor workflow performance over time. This action is read-only and idempotent — it only retrieves data without modifying any resources."+ },+ {+ "slug": "SWARMSYNCAI_GET_X402_AGENTS_PAYMENT_METHODS",+ "name": "Get Agent Payment Methods",+ "description": "Retrieve the payment methods associated with a specific agent. Use when you need to get the payment methods configured for an agent to receive payments or settlements. This action is read-only - it only retrieves payment method information without making any modifications."+ },+ {+ "slug": "SWARMSYNCAI_GET_X402_CONFIG_STATUS",+ "name": "Get x402 Config Status",+ "description": "Retrieve the x402 payment configuration status. Use when you need to check whether the x402 payment configuration is properly set up, enabled, or to view the current configuration details. This is a read-only operation that retrieves configuration status without modifying any data."+ },+ {+ "slug": "SWARMSYNCAI_GET_X402_TRANSACTIONS_STATUS",+ "name": "Get x402 Transaction Status",+ "description": "Retrieves the status and details of an x402 blockchain transaction. Use this action when you need to check if a payment transaction has been confirmed on-chain, track transaction progress, or verify that a blockchain payment was successfully processed. This is a read-only operation that queries blockchain state without modifying any resources."+ },+ {+ "slug": "SWARMSYNCAI_LIST_AGENTS",+ "name": "List Marketplace Agents",+ "description": "List agents from the SwarmSync AI marketplace. Retrieves agents from the marketplace with optional filtering by status, visibility, category, tags, search query, verification status, conduit type, and creator ID. Use when you need to browse or find available agents in the marketplace that match specific criteria. This is a read-only operation that fetches data without modifying any resources."+ },+ {+ "slug": "SWARMSYNCAI_LIST_CONDUIT_MCP",+ "name": "List Conduit MCP Server Metadata",+ "description": "Retrieves metadata about the Conduit MCP server. Use when you need to discover information about the Conduit MCP server, including its version, status, and capabilities. This action requires no parameters. This action is read-only and idempotent - fetching the server metadata multiple times will return the same result."+ },+ {+ "slug": "SWARMSYNCAI_LIST_HEALTH",+ "name": "Check API Health",+ "description": "Check the health status of the Swarmsyncai API. Use when you need to verify that the API service is running and responding correctly. This is a read-only, idempotent operation commonly used for monitoring and readiness probes. The health endpoint confirms connectivity to the API service without requiring specific parameters."+ },+ {+ "slug": "SWARMSYNCAI_LIST_NEEDS",+ "name": "List SwarmNeeds",+ "description": "List SwarmNeed objects from the SwarmSync platform. Retrieves all available SwarmNeed objects with their identification, classification, and status information. Use when you need to discover or browse available needs within the swarm network for task assignment, resource allocation, or fulfillment coordination. This is a read-only operation that fetches data without modifying any resources."+ },+ {+ "slug": "SWARMSYNCAI_LIST_SWARM_SCORE",+ "name": "List Agent SwarmScore",+ "description": "Retrieve the SwarmScore for a specific agent. Use this action when you need to check an agent's performance metrics, including execution count, score, success rate, and trust tier level. This action is read-only and idempotent - it only retrieves score information without making any modifications."+ },+ {+ "slug": "SWARMSYNCAI_LIST_WORKFLOWS",+ "name": "List Workflows",+ "description": "List workflow objects from the SwarmSync platform. Retrieves all available workflows with their identification, status, and configuration information. Use when you need to discover, browse, or manage workflows within the swarm network for automation coordination, process monitoring, or workflow administration. This is a read-only operation that fetches data without modifying any resources."+ },+ {+ "slug": "SWARMSYNCAI_REGISTER_AGENT",+ "name": "Register Agent Account",+ "description": "Register a new AI agent account on Swarmsyncai. Use this action when a new autonomous AI agent needs to create an account on the Swarmsyncai platform to participate in the swarm marketplace. The agent will receive an access token for API requests and an API key for authentication. These credentials are returned only once during registration. This action is irreversible - once registered, the agent account cannot be deleted through this API."+ },+ {+ "slug": "SWARMSYNCAI_REGISTER_AUTH",+ "name": "Register New User Account",+ "description": "Register a new user account on Swarmsyncai with email and password credentials. Use this action when creating a new user account for the Swarmsyncai platform. Upon successful registration, the action returns a JWT access token for immediate authentication and user details including the generated user ID. Agent account registration requires the ENABLE_AGENT_SIGNUP feature flag to be enabled. Note: If registration fails due to an existing email, use a different email address or check if the user already has an account."+ },+ {+ "slug": "SWARMSYNCAI_RESEND_VERIFICATION",+ "name": "Resend Email Verification",+ "description": "Resend email verification link. Use this action when you need to send a new email verification link to a user who has not yet verified their email address. Common scenarios include: the user did not receive the original verification email, the verification link expired, or the user needs to verify a newly registered account. The API always returns a 200 status code to prevent email enumeration attacks - even if the email address is not registered, the response will indicate success. This action is idempotent - requesting multiple verification emails for the same address will simply result in multiple emails being sent."+ },+ {+ "slug": "SWARMSYNCAI_TRACK_CLICK",+ "name": "Track Referral Click",+ "description": "Track a referral click for recruitment analytics. Use this action when a user clicks on a referral link to record the click for affiliate analytics. This updates the affiliate's totalClicks counter. The endpoint is publicly accessible and does not require authentication. The referral code is typically extracted from the 'ref' query parameter in the URL. Note: This action silently fails for invalid or unapproved referral codes."+ }+ ],+ "triggers": [],+ "authConfigDetails": [+ {+ "mode": "API_KEY",+ "name": "swarmsyncai_api_key",+ "fields": {+ "auth_config_creation": {+ "required": [],+ "optional": []+ },+ "connected_account_initiation": {+ "required": [+ {+ "name": "generic_api_key",+ "displayName": "API Key",+ "type": "string",+ "description": "Service Account API Key from SwarmSync dashboard",+ "required": true,+ "default": null+ }+ ],+ "optional": []+ }+ }+ }+ ]+ },{"slug": "sympla","name": "Sympla",@@ -245873,7 +246930,7 @@],"toolCount": 79,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "SYNTHFLOW_AI_ADD_KB_SOURCE_DOCUMENT",@@ -246309,7 +247366,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "TAGGUN_ADD_MERCHANT_NAME",@@ -246475,7 +247532,7 @@],"toolCount": 18,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "TALLY_CREATE_FORM",@@ -246654,7 +247711,7 @@],"toolCount": 40,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "TAPFILIATE_AFFILIATES_RETRIEVE_AN_AFFILIATE",@@ -247817,7 +248874,7 @@],"toolCount": 14,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "TEAMCAMP_CREATE_PROJECT",@@ -248250,7 +249307,7 @@],"toolCount": 26,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "TELTEL_CREATE_AUTODIALER_CUSTOM_STATUS",@@ -249591,7 +250648,7 @@],"toolCount": 10,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "TIKTOK_FETCH_PUBLISH_STATUS",@@ -250046,7 +251103,7 @@],"toolCount": 56,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "TOGGL_CREATE_CLIENT",@@ -250532,7 +251589,7 @@],"toolCount": 82,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "TOMTOM_ASSETS_LIST_FONTS",@@ -251237,7 +252294,7 @@],"toolCount": 15,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "TRUVERA_CREATE_API_KEY",@@ -251361,7 +252418,7 @@],"toolCount": 170,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "TURBOT_PIPES_ACTOR_GET",@@ -252308,7 +253365,7 @@],"toolCount": 97,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "TWELVE_DATA_CASH_FLOW",@@ -252903,7 +253960,7 @@],"toolCount": 35,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260409_00","tools": [{"slug": "TYPEFORM_CREATE_ACCOUNT_WORKSPACE",@@ -253200,7 +254257,7 @@],"toolCount": 3,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "U301_DELETE_LINK",@@ -253813,7 +254870,7 @@],"toolCount": 34,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "UPLOADCARE_CHECK_AWS_REKOGNITION_MODERATION_STATUS",@@ -254148,7 +255205,7 @@],"toolCount": 18,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "USERFLOW_CREATE_OR_UPDATE_A_GROUP",@@ -254330,7 +255387,7 @@],"toolCount": 44,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "V0_ASSIGN_CHAT_TO_PROJECT",@@ -254591,7 +255648,7 @@],"toolCount": 38,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "VAPI_ASSISTANT_CONTROLLER_UPDATE",@@ -254984,7 +256041,7 @@],"toolCount": 146,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "VERCEL_ADD_ENVIRONMENT_VARIABLE",@@ -255952,7 +257009,7 @@],"toolCount": 16,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "VIRUSTOTAL_ADD_COMMENT",@@ -256228,7 +257285,7 @@],"toolCount": 5,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260410_00","tools": [{"slug": "WATI_ADD_CONTACT",@@ -256402,7 +257459,7 @@],"toolCount": 7,"triggerCount": 0,- "version": "20260407_00",+ "version": "20260408_00","tools": [{"slug": "WEBSCRAPING_AI_ACCOUNT_INFO",@@ -256517,450 +257574,5 @@}}]- },- {- "slug": "whautomate",- "name": "Whautomate",- "logo": "https://logos.composio.dev/api/whautomate",- "description": "Whautomate is a platform that offers seamless integrations for customer engagement, including AI chatbots, appointment scheduling, and broadcast messaging.",- "category": "ai chatbots",- "authSchemes": [- "API_KEY"- ],- "toolCount": 17,- "triggerCount": 0,- "version": "20260407_00",- "tools": [- {- "slug": "WHAUTOMATE_ADD_CONTACT",- "name": "Add Contact",- "description": "Tool to add a new contact. Use when you need to programmatically create contacts via the API."- },- {- "slug": "WHAUTOMATE_DELETE_SEGMENT",- "name": "Delete Segment",- "description": "Tool to delete a specific segment. Use when you need to remove a segment by its ID. Use after confirming you have the correct segmentId."- },- {- "slug": "WHAUTOMATE_DELETE_SERVICE_CATEGORY",- "name": "Delete Service Category",- "description": "Tool to delete a service category. Use when you need to remove a specific service category by its ID. Use after confirming you have the correct serviceCategoryId."- },- {- "slug": "WHAUTOMATE_GET_ACCOUNT_INFO",- "name": "Get Account Info",- "description": "Tool to retrieve account information for the authenticated user. Use when you need to fetch account details like account name and owner email."- },- {- "slug": "WHAUTOMATE_GET_ALL_WEBHOOKS",- "name": "Get All Webhooks",- "description": "Tool to retrieve all registered webhooks. Use after authenticating to audit or inspect existing webhook subscriptions."- },- {- "slug": "WHAUTOMATE_GET_BROADCAST_BY_ID",- "name": "Get Broadcast By ID",- "description": "Tool to retrieve a specific broadcast's details. Use when you have a broadcast ID and need its metadata. Use after confirming the broadcastId is valid, as this returns detailed broadcast data."- },- {- "slug": "WHAUTOMATE_GET_BROADCASTS",- "name": "Get Broadcasts",- "description": "Tool to retrieve a list of broadcasts. Use when you need to fetch broadcasts with optional filters such as status or date ranges. Example: \"Get all scheduled broadcasts after 2023-01-01T00:00:00Z.\""- },- {- "slug": "WHAUTOMATE_GET_CONTACTS",- "name": "Get Contacts",- "description": "Tool to retrieve a list of contacts. Use when you need to fetch contacts from WhatsApp with optional pagination and filters."- },- {- "slug": "WHAUTOMATE_GET_MESSAGES_OF_CONTACT",- "name": "Get Messages of Contact",- "description": "Tool to retrieve chat messages for a specific contact. Use after providing a valid contactId. Supports pagination and optional date filtering."- },- {- "slug": "WHAUTOMATE_GET_SEGMENTS",- "name": "Get Segments",- "description": "Tool to retrieve a list of segments. Use when you need to fetch segments with optional name filtering and pagination. Segments can be used to organize clients and contacts into groups based on various criteria."- },- {- "slug": "WHAUTOMATE_GET_SERVICE_BY_ID",- "name": "Get Service By Id",- "description": "Tool to retrieve details of a specific service by its unique ID. Use when you need comprehensive service information."- },- {- "slug": "WHAUTOMATE_GET_SERVICE_CATEGORIES",- "name": "Get Service Categories",- "description": "Tool to retrieve a list of service categories. Use when you need to list categories with optional pagination."- },- {- "slug": "WHAUTOMATE_GET_SERVICES",- "name": "Get Services",- "description": "Tool to retrieve a list of services with optional filters. Use when you need to fetch available services for display or scheduling."- },- {- "slug": "WHAUTOMATE_GET_STAFF_AVAILABILITY_BLOCKS",- "name": "Get Staff Availability Blocks",- "description": "Tool to retrieve a staff member's blocked time schedule over a date range. Use when you need to view unavailable slots after confirming staffId and desired date range."- },- {- "slug": "WHAUTOMATE_GET_STAFF_BY_ID",- "name": "Get Staff By ID",- "description": "Tool to retrieve detailed information about a specific staff member. Use when you have a valid staff ID and need full profile details. Use after confirming staffId."- },- {- "slug": "WHAUTOMATE_GET_STAFFS",- "name": "Get Staffs",- "description": "Tool to retrieve a list of staff members. Use when you need to list staff with optional pagination or search filters."- },- {- "slug": "WHAUTOMATE_UPDATE_SERVICE",- "name": "Update Service",- "description": "Tool to update an existing Whautomate service. Use when you need to modify service attributes like name, pricing, duration, or active status."- }- ],- "triggers": [],- "authConfigDetails": [- {- "mode": "API_KEY",- "name": "whautomate_api_key",- "fields": {- "auth_config_creation": {- "required": [],- "optional": []- },- "connected_account_initiation": {- "required": [- {- "name": "full",- "displayName": "API Host URL",- "type": "string",- "description": "The API host URL based on your geographical location. For example, 'https://api.whautomate.com' for global access or 'https://api.in.whautomate.com' for India.",- "required": true,- "default": null- },- {- "name": "generic_api_key",- "displayName": "Whautomate API Key",- "type": "string",- "description": "The API key generated from your Whautomate account. This API key is required and must be included in the \"x-api-key\" header for all API requests.",- "required": true,- "default": null- }- ],- "optional": []- }- }- }- ]- },- {- "slug": "whoisfreaks",- "name": "Whoisfreaks",- "logo": "https://logos.composio.dev/api/whoisfreaks",- "description": "Best Source For Domain WHOIS Database and API.",- "category": "developer tools",- "authSchemes": [- "API_KEY"- ],- "toolCount": 17,- "triggerCount": 0,- "version": "20260407_00",- "tools": [- {- "slug": "WHOISFREAKS_ASN_WHOIS_LOOKUP",- "name": "ASN WHOIS Lookup",- "description": "Tool to retrieve comprehensive ASN WHOIS information including ownership, network infrastructure, and IP address ranges. Use when you need to identify ASN ownership, organization details, or associated IP blocks for network administration or security analysis."- },- {- "slug": "WHOISFREAKS_BULK_DNS_LOOKUP",- "name": "Bulk DNS Lookup",- "description": "Tool to process multiple domains or IPs simultaneously, returning all DNS records in a single request (max 100). Use when you need to retrieve DNS records for multiple domains at once for efficient batch processing."- },- {- "slug": "WHOISFREAKS_BULK_DOMAIN_AVAILABILITY_CHECK",- "name": "Bulk Domain Availability Check",- "description": "Tool to check availability of multiple domains in one request (max 100 domains). Use when you need to verify if domain names are available for registration. Response time ranges from 16 seconds to 1 minute for 100 domains."- },- {- "slug": "WHOISFREAKS_BULK_WHOIS_LOOKUP",- "name": "Bulk WHOIS Lookup",- "description": "Tool to query WHOIS information for up to 100 domains in a single request. Use when you need comprehensive registration details, contact information, name servers, and domain status for multiple domains. Response includes normalized and parsed WHOIS data with 1 credit charged per successful query for each domain."- },- {- "slug": "WHOISFREAKS_DNS_LIVE_LOOKUP",- "name": "DNS Live Lookup",- "description": "Tool to perform real-time DNS record resolution for network diagnostics and configuration verification. Use when you need to retrieve current DNS records for a domain or perform reverse DNS lookup for an IP address."- },- {- "slug": "WHOISFREAKS_DOMAIN_AVAILABILITY_CHECK",- "name": "Check Domain Availability",- "description": "Tool to check if a domain is available for registration with optional suggestions. Use when you need to verify domain availability or get alternative domain suggestions."- },- {- "slug": "WHOISFREAKS_GET_DOMAINER_FILES_STATUS",- "name": "Get Domain Files Status",- "description": "Tool to check availability and update status of domain data files including newly registered, expired, and dropped domains. Use when you need to verify that domain data files are prepared and ready for download before accessing file download endpoints."- },- {- "slug": "WHOISFREAKS_IP_GEOLOCATION_LOOKUP",- "name": "IP Geolocation Lookup",- "description": "Tool to retrieve geographic location information for an IP address including country, city, coordinates, ISP, and security details. Use when you need to identify the physical location of an IP, detect VPN/proxy usage, or gather network intelligence for security or analytics purposes."- },- {- "slug": "WHOISFREAKS_IP_WHOIS_LOOKUP",- "name": "IP WHOIS Lookup",- "description": "Tool to retrieve comprehensive WHOIS information for an IP address including organization, ISP, and network details. Use when you need to identify IP ownership, allocation status, or contact information for network administration or security purposes."- },- {- "slug": "WHOISFREAKS_SECURITY_THREAT_LOOKUP",- "name": "Security Threat Lookup",- "description": "Tool to check if an IP address is associated with malicious activity, security threats, or appears on blocklists. Use when you need to assess IP reputation, detect VPN/proxy/Tor usage, identify bots or spam sources, or evaluate security risk for access control and fraud prevention."- },- {- "slug": "WHOISFREAKS_SSL_CERTIFICATE_LOOKUP",- "name": "SSL Certificate Lookup",- "description": "Tool to fetch live SSL certificate with full secure cert chain, validity dates, and issuer information. Use when you need to retrieve SSL certificate details for a domain, including certificate validation dates, issuer details, public key information, and certificate extensions."- },- {- "slug": "WHOISFREAKS_SUBDOMAINS_LOOKUP",- "name": "Subdomain Lookup",- "description": "Tool to discover all subdomains associated with a domain name. Use when you need to enumerate subdomains for security assessment, asset discovery, or domain reconnaissance. Supports filtering by active/inactive status and date ranges."- },- {- "slug": "WHOISFREAKS_WHOIS_HISTORICAL_LOOKUP",- "name": "WHOIS Historical Lookup",- "description": "Tool to access historical domain records from comprehensive database with up to 100 records per page. Use when you need to retrieve historical WHOIS data for a domain dating back to 1986. Database is updated monthly with one-month data latency."- },- {- "slug": "WHOISFREAKS_WHOIS_LIVE_LOOKUP_V2",- "name": "WHOIS Live Lookup V2",- "description": "Tool to fetch real-time WHOIS domain data using v2.0 endpoint. Use when you need current domain ownership, registration dates, contact information, or nameserver details via the updated v2.0 API. Note that some fields may show 'REDACTED FOR PRIVACY' due to ICANN privacy regulations."- },- {- "slug": "WHOISFREAKS_WHOIS_REVERSE_LOOKUP_BY_COMPANY",- "name": "WHOIS Reverse Lookup By Company",- "description": "Tool to search for domains registered by a specific company or organization using reverse WHOIS lookup. Use when you need to find all domains associated with a particular company name. Performs full-text phrase matching with pagination support. Charges 5 credits per page retrieved."- },- {- "slug": "WHOISFREAKS_WHOIS_REVERSE_LOOKUP_BY_EMAIL",- "name": "WHOIS Reverse Lookup by Email",- "description": "Tool to search for domains registered with a specific email address. Use when you need to find all domains associated with an email in WHOIS records. Supports exact or regex email matching. Returns paginated results with domain registration details."- },- {- "slug": "WHOISFREAKS_WHOIS_REVERSE_LOOKUP_BY_OWNER",- "name": "WHOIS Reverse Lookup By Owner",- "description": "Tool to search for domains registered by a specific owner name using reverse WHOIS lookup. Use when you need to find all domains associated with a particular registrant or owner name. Performs pattern-based full-text search with pagination support."- }- ],- "triggers": [],- "authConfigDetails": [- {- "mode": "API_KEY",- "name": "whoisfreaks_api_key",- "fields": {- "auth_config_creation": {- "required": [],- "optional": []- },- "connected_account_initiation": {- "required": [- {- "name": "generic_api_key",- "displayName": "API Key",- "type": "string",- "description": "Sign in and copy your API key directly from your dashboard at https://billing.whoisfreaks.com/",- "required": true,- "default": null- }- ],- "optional": []- }- }- }- ]- },- {- "slug": "whop",- "name": "Whop",- "logo": "https://logos.composio.dev/api/whop",- "description": "Making everyone an internet entrepreneur. Explore a playground for digital products, memberships & communities.",- "category": "ecommerce",- "authSchemes": [- "API_KEY",- "OAUTH2"- ],- "toolCount": 19,- "triggerCount": 0,- "version": "20260407_00",- "tools": [- {- "slug": "WHOP_CREATE_ACCESS_TOKEN",- "name": "Create Access Token",- "description": "Tool to create a short-lived access token for authenticating API requests. Use when you need to generate temporary credentials for Whop's web and mobile embedded components."- },- {- "slug": "WHOP_CREATE_FILE",- "name": "Create file",- "description": "Tool to create a new file record and receive a presigned URL for uploading content to S3. Use when you need to upload files to Whop."- },- {- "slug": "WHOP_DELETE_PROMO_CODE",- "name": "Delete Promo Code",- "description": "Tool to archive a promo code, preventing it from being used in future checkouts. Use when you need to deactivate or remove a promo code from circulation. Existing memberships created with this promo code are not affected by archiving. The operation changes the promo code status from 'active' to 'archived'."- },- {- "slug": "WHOP_LIST_APPS",- "name": "List Apps",- "description": "Tool to retrieve a paginated list of apps on the Whop platform. Use when you need to browse or search for apps with optional filtering by company, type, verification status, or view support. Supports cursor-based pagination."- },- {- "slug": "WHOP_LIST_AUTHORIZED_USERS",- "name": "List Authorized Users",- "description": "Tool to retrieve a paginated list of authorized team members for a company. Use when you need to view company team members, check user permissions, or audit team access. Supports filtering by company, user, role, and creation date with cursor-based pagination."- },- {- "slug": "WHOP_LIST_MEMBERS",- "name": "List Members",- "description": "Tool to retrieve a paginated list of members for a company. Use when you need to view company members with optional filtering by product, plan, status, access level, and more. Supports cursor-based pagination and searching by name, username, or email."- },- {- "slug": "WHOP_LIST_MEMBERSHIPS",- "name": "List memberships",- "description": "Tool to retrieve a paginated list of memberships with filtering options. Use when you need to list memberships by product, plan, status, user, or promo code."- },- {- "slug": "WHOP_LIST_PAYMENT_METHODS",- "name": "List Payment Methods",- "description": "Tool to retrieve a paginated list of payment methods for a member or company. Use when you need to view stored payment information such as cards, bank accounts, or digital wallets. Either member_id or company_id must be provided."- },- {- "slug": "WHOP_LIST_PAYMENTS",- "name": "List Payments",- "description": "Tool to retrieve a paginated list of payments for a company. Use when you need to view payment history with optional filtering by product, plan, status, billing reason, currency, and creation date. Supports cursor-based pagination."- },- {- "slug": "WHOP_RETRIEVE_APP",- "name": "Retrieve App",- "description": "Tool to retrieve the details of an existing app. Use when you need to get information about a specific Whop app by its ID."- },- {- "slug": "WHOP_RETRIEVE_AUTHORIZED_USER",- "name": "Retrieve Authorized User",- "description": "Tool to retrieve the details of an existing authorized user. Use when you need to get information about a specific authorized user by their ID."- },- {- "slug": "WHOP_RETRIEVE_COMPANY",- "name": "Retrieve Company",- "description": "Tool to retrieve the details of an existing company. Use when you need to fetch company information including settings, team details, verification status, and social links."- },- {- "slug": "WHOP_RETRIEVE_COMPANY_TOKEN_TRANSACTION",- "name": "Retrieve company token transaction",- "description": "Tool to retrieve the details of an existing company token transaction. Use when you need to view information about a specific token transaction including amount, type, and associated user/member/company details."- },- {- "slug": "WHOP_RETRIEVE_FILE",- "name": "Retrieve File",- "description": "Tool to retrieve the details of an existing file from Whop. Use when you need to get information about a specific file by its ID."- },- {- "slug": "WHOP_RETRIEVE_MEMBER",- "name": "Retrieve Member",- "description": "Tool to retrieve detailed information about an existing member by ID. Use when you need to get a specific member's details including their status, access level, spending history, and associated user information."- },- {- "slug": "WHOP_RETRIEVE_PLAN",- "name": "Retrieve Plan",- "description": "Tool to retrieve information about an existing plan. A plan defines pricing and billing terms for a product."- },- {- "slug": "WHOP_RETRIEVE_PROMO_CODE",- "name": "Retrieve Promo Code",- "description": "Tool to retrieve the details of an existing promo code by its unique identifier. Use when you need to fetch information about a specific promo code's discount settings, usage limits, and restrictions."- },- {- "slug": "WHOP_RETRIEVE_USER",- "name": "Retrieve User",- "description": "Tool to retrieve the details of an existing user from Whop. Use when you need to get information about a specific user by their ID or username."- },- {- "slug": "WHOP_UPDATE_PLAN",- "name": "Update Plan",- "description": "Tool to update a plan's pricing, billing interval, visibility, stock, and other settings. Use when you need to modify an existing plan's configuration such as changing prices, adjusting billing periods, updating visibility status, or managing stock levels."- }- ],- "triggers": [],- "authConfigDetails": [- {- "mode": "OAUTH2",- "name": "whop_oauth",- "fields": {- "auth_config_creation": {- "required": [- {- "name": "client_id",- "displayName": "Client id",- "type": "string",- "description": "Client id of the app",- "required": true,- "default": null- },- {- "name": "client_secret",- "displayName": "Client secret",- "type": "string",- "description": "Client secret of the app",- "required": true,- "default": null- }- ],- "optional": [- {- "name": "oauth_redirect_uri",- "displayName": "Redirect URI",- "type": "string",- "description": "Add this Redirect URL to your app's OAuth allow list.",- "required": false,- "default": "https://backend.composio.dev/api/v1/auth-apps/add"- },- {- "name": "scopes",- "displayName": "Scopes",- "type": "string",- "description": "Scopes to request from the user, comma separated",- "required": false,- "default": "member:basic:read,payment:basic:read"- }- ]- },- "connected_account_initiation": {- "required": [],- "optional": []- }- }- },- {- "mode": "API_KEY",- "name": "whop_api_key",- "fields": {- "auth_config_creation": {- "required": [],- "optional": []- },- "connected_account_initiation": {- "required": [- {- "name": "generic_api_key",- "displayName": "API Key",- "type": "string",- "description": "Navigate to the Developers setting panel under your business to find your API Key. Format: whop_xxxxxxxxxxxx",- "required": true,- "default": null- }- ],- "optional": []- }- }- }- ]}]\ No newline at end of filediff --git a/docs/public/openapi.json b/docs/public/openapi.jsonindex cfa3d39b6..029aaa563 100644--- a/docs/public/openapi.json+++ b/docs/public/openapi.json@@ -167,6 +167,183 @@"error"]},+ "PatchConnectedAccountBody": {+ "type": "object",+ "properties": {+ "alias": {+ "type": "string",+ "description": "A human-readable alias for this connected account. Pass an empty string to clear the alias. Must be unique per entity and toolkit within the project."+ },+ "connection": {+ "type": "object",+ "properties": {+ "state": {+ "type": "object",+ "properties": {+ "authScheme": {+ "type": "string",+ "enum": [+ "BEARER_TOKEN",+ "API_KEY",+ "BASIC",+ "BASIC_WITH_JWT",+ "GOOGLE_SERVICE_ACCOUNT",+ "SERVICE_ACCOUNT"+ ],+ "description": "The auth scheme of the connected account. Must match the connection's actual auth scheme."+ },+ "val": {+ "type": "object",+ "properties": {+ "subdomain": {+ "type": "string",+ "nullable": true+ },+ "your-domain": {+ "type": "string",+ "nullable": true+ },+ "region": {+ "type": "string",+ "nullable": true+ },+ "shop": {+ "type": "string",+ "nullable": true+ },+ "account_url": {+ "type": "string",+ "nullable": true+ },+ "COMPANYDOMAIN": {+ "type": "string",+ "nullable": true+ },+ "extension": {+ "type": "string",+ "nullable": true+ },+ "form_api_base_url": {+ "type": "string",+ "nullable": true+ },+ "instanceEndpoint": {+ "type": "string",+ "nullable": true+ },+ "api_url": {+ "type": "string",+ "nullable": true+ },+ "borneo_dashboard_url": {+ "type": "string",+ "nullable": true+ },+ "proxy_username": {+ "type": "string",+ "nullable": true+ },+ "proxy_password": {+ "type": "string",+ "nullable": true+ },+ "domain": {+ "type": "string",+ "nullable": true+ },+ "version": {+ "type": "string",+ "nullable": true+ },+ "dc": {+ "type": "string",+ "nullable": true+ },+ "site_name": {+ "type": "string",+ "nullable": true+ },+ "instanceName": {+ "type": "string",+ "nullable": true+ },+ "account_id": {+ "type": "string",+ "nullable": true+ },+ "your_server": {+ "type": "string",+ "nullable": true+ },+ "server_location": {+ "type": "string",+ "nullable": true+ },+ "base_url": {+ "type": "string",+ "nullable": true+ },+ "token": {+ "type": "string",+ "nullable": true+ },+ "generic_api_key": {+ "type": "string",+ "nullable": true+ },+ "api_key": {+ "type": "string",+ "nullable": true+ },+ "bearer_token": {+ "type": "string",+ "nullable": true+ },+ "basic_encoded": {+ "type": "string",+ "nullable": true+ },+ "username": {+ "type": "string",+ "nullable": true+ },+ "password": {+ "type": "string",+ "nullable": true+ },+ "credentials_json": {+ "type": "string",+ "nullable": true+ },+ "application_id": {+ "type": "string",+ "nullable": true+ },+ "installation_id": {+ "type": "string",+ "nullable": true+ },+ "private_key": {+ "type": "string",+ "nullable": true+ }+ },+ "additionalProperties": {},+ "description": "Credential fields to update. Only provided fields are changed — omitted fields are preserved. Set a field to null to remove it."+ }+ },+ "required": [+ "authScheme",+ "val"+ ]+ }+ },+ "required": [+ "state"+ ]+ }+ }+ },"DeprecatedToolkitInfo": {"type": "object","properties": {@@ -189,7 +366,7 @@"slug": {"type": "string","description": "Unique identifier for the tool",- "example": "github-actions"+ "example": "GITHUB_CREATE_A_WORKFLOW_DISPATCH_EVENT"},"name": {"type": "string",@@ -2222,8 +2399,8 @@"client_secret": "YOUR_NEW_CLIENT_SECRET"},"restrict_to_following_tools": [- "tool1",- "tool2"+ "GMAIL_SEND_EMAIL",+ "GMAIL_FETCH_EMAILS"]}}@@ -3223,6 +3400,10 @@"default": "default","description": "The user id of the connected account"},+ "alias": {+ "type": "string",+ "description": "A human-readable alias for this connected account. Must be unique per entity and toolkit within the project."+ },"callback_url": {"type": "string","format": "uri",@@ -3555,7 +3736,7 @@},"required": true,"description": "The unique identifier (nanoid) of the connected account",- "example": "con_1a2b3c4d5e6f",+ "example": "ca_1a2b3c4d5e6f","name": "nanoid","in": "path"}@@ -3981,7 +4162,7 @@},"required": true,"description": "The unique identifier (nanoid) of the connected account",- "example": "con_1a2b3c4d5e6f",+ "example": "ca_1a2b3c4d5e6f","name": "nanoid","in": "path"}@@ -4065,7 +4246,7 @@},"patch": {"summary": "Update a connected account",- "description": "Updates mutable fields of a connected account. Currently supports updating the alias field. Alias must be unique within the same project, entity, and toolkit scope.",+ "description": "Update a connected account. Supports updating the alias and/or credentials. Only specified fields will be updated. Set a credential field to null to remove it. Alias must be unique within the same project, entity, and toolkit scope.","tags": ["Connected Accounts"],@@ -4086,7 +4267,7 @@},"required": true,"description": "The unique identifier (nanoid) of the connected account",- "example": "con_1a2b3c4d5e6f",+ "example": "ca_1a2b3c4d5e6f","name": "nanoid","in": "path"}@@ -4095,18 +4276,27 @@"content": {"application/json": {"schema": {- "type": "object",- "properties": {- "alias": {- "type": "string",- "description": "A human-readable alias for this connected account. Pass an empty string to clear the alias. Must be unique per entity and toolkit within the project."+ "$ref": "#/components/schemas/PatchConnectedAccountBody"+ },+ "examples": {+ "credentials": {+ "summary": "Update credentials",+ "value": {+ "connection": {+ "state": {+ "authScheme": "BEARER_TOKEN",+ "val": {+ "token": "new_access_token"+ }+ }+ }}},- "required": [- "alias"- ],- "example": {- "alias": "work-gmail"+ "alias": {+ "summary": "Update alias",+ "value": {+ "alias": "work-gmail"+ }}}}@@ -4114,7 +4304,7 @@},"responses": {"200": {- "description": "Successfully updated the connected account",+ "description": "Successfully updated connected account","content": {"application/json": {"schema": {@@ -4122,22 +4312,34 @@"properties": {"success": {"type": "boolean",- "description": "Indicates whether the connected account was successfully updated"+ "description": "Whether the update was successful"+ },+ "id": {+ "type": "string",+ "format": "connectedAccountId",+ "description": "The unique identifier of the updated connected account"+ },+ "status": {+ "type": "string",+ "description": "The current status of the connected account after the update (ACTIVE, EXPIRED, INACTIVE, etc.)"}},"required": [- "success"+ "success",+ "id",+ "status"],- "description": "Response returned after successfully updating a connected account","example": {- "success": true+ "success": true,+ "id": "ca_1a2b3c4d5e6f",+ "status": "ACTIVE"}}}}},"400": {- "description": "Bad request - Invalid nanoid format, invalid request body, or duplicate alias",+ "description": "Bad request - Invalid nanoid, duplicate alias, or invalid credential values","content": {"application/json": {"schema": {@@ -4167,18 +4369,17 @@}},"404": {- "description": "Connected account not found - The specified account does not exist or has been deleted",+ "description": "Not found - Connected account does not exist or was deleted","content": {"application/json": {"schema": {- "type": "object",- "properties": {}+ "$ref": "#/components/schemas/Error"}}}},"500": {- "description": "Internal server error - Failed to update the connected account due to a server-side issue",+ "description": "Internal server error - Failed to update connected account","content": {"application/json": {"schema": {@@ -4214,7 +4415,7 @@},"required": true,"description": "The unique identifier of the connected account",- "example": "con_1a2b3c4d5e6f",+ "example": "ca_1a2b3c4d5e6f","name": "nanoId","in": "path"}@@ -4342,7 +4543,7 @@},"required": true,"description": "The unique identifier of the connected account",- "example": "con_1a2b3c4d5e6f",+ "example": "ca_1a2b3c4d5e6f","name": "nanoid","in": "path"},@@ -4414,7 +4615,7 @@],"description": "Response schema for a refreshed connected account authentication","example": {- "id": "con_1a2b3c4d5e6f",+ "id": "ca_1a2b3c4d5e6f","status": "ACTIVE","redirect_url": "https://app.example.com/oauth/callback"}@@ -4517,6 +4718,10 @@"minLength": 1,"description": "The user id to create a link for"},+ "alias": {+ "type": "string",+ "description": "A human-readable alias for this connected account. Must be unique per entity and toolkit within the project."+ },"callback_url": {"type": "string","description": "The callback url to create a link for"@@ -4868,57 +5073,187 @@}}},- "/api/v3/org/project/config": {+ "/api/v3/org/usage/summary": {"get": {- "summary": "Get project configuration",- "description": "Retrieves the current project configuration including 2FA settings.",+ "summary": "Org usage summary",+ "description": "Aggregated metering usage for the authenticated organization across all projects. Requires ClickHouse logging (`USE_CLICKHOUSE_FOR_LOGS`). Values are summed from raw metering events grouped by `entity_type`.","tags": [- "Projects"+ "Organization"],- "operationId": "getOrgProjectConfig",- "security": [+ "operationId": "getOrgUsageSummary",+ "parameters": [{- "ApiKeyAuth": []+ "schema": {+ "type": "string",+ "description": "Inclusive range start (ISO 8601). Defaults to 30 days before end_time."+ },+ "required": false,+ "description": "Inclusive range start (ISO 8601). Defaults to 30 days before end_time.",+ "name": "start_time",+ "in": "query"},{- "UserApiKeyAuth": []+ "schema": {+ "type": "string",+ "description": "Exclusive range end (ISO 8601). Defaults to now."+ },+ "required": false,+ "description": "Exclusive range end (ISO 8601). Defaults to now.",+ "name": "end_time",+ "in": "query"+ },+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string"+ },+ "description": "Filter to these metering entity types (comma-separated or repeated query keys). Omit for all types."+ },+ "required": false,+ "description": "Filter to these metering entity types (comma-separated or repeated query keys). Omit for all types.",+ "name": "entity_types",+ "in": "query"}],"responses": {"200": {- "description": "Project configuration retrieved successfully.",+ "description": "Usage aggregates for the organization.","content": {"application/json": {"schema": {"type": "object","properties": {- "is_2FA_enabled": {- "type": "boolean"- },- "logo_url": {- "type": "string"- },- "display_name": {- "type": "string"- },- "mask_secret_keys_in_connected_account": {- "type": "boolean"- },- "log_visibility_setting": {- "type": "string",- "enum": [- "show_all",- "dont_store_data"- ]- },- "require_mcp_api_key": {- "type": "boolean"- },- "is_composio_link_enabled_for_managed_auth": {- "type": "boolean",- "description": "Whether to enable composio link for managed authentication. This key will be deprecated in the future. Please don't use this key."- },- "signed_url_file_expiry_in_seconds": {+ "rows": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "entity_type": {+ "type": "string"+ },+ "unit": {+ "type": "string"+ },+ "total_quantity": {+ "type": "string"+ },+ "event_count": {+ "type": "integer",+ "minimum": 0+ }+ },+ "required": [+ "entity_type",+ "unit",+ "total_quantity",+ "event_count"+ ]+ }+ }+ },+ "required": [+ "rows"+ ]+ }+ }+ }+ },+ "400": {+ "description": "Invalid time range, entity_types, or query parameters.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "401": {+ "description": "Authentication required.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "403": {+ "description": "Forbidden.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "500": {+ "description": "Failed to load usage from analytics store or feature configuration.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ }+ }+ }+ },+ "/api/v3/org/project/config": {+ "get": {+ "summary": "Get project configuration",+ "description": "Retrieves the current project configuration including 2FA settings.",+ "tags": [+ "Projects"+ ],+ "operationId": "getOrgProjectConfig",+ "security": [+ {+ "ApiKeyAuth": []+ },+ {+ "UserApiKeyAuth": []+ }+ ],+ "responses": {+ "200": {+ "description": "Project configuration retrieved successfully.",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "is_2FA_enabled": {+ "type": "boolean"+ },+ "logo_url": {+ "type": "string"+ },+ "display_name": {+ "type": "string"+ },+ "mask_secret_keys_in_connected_account": {+ "type": "boolean"+ },+ "log_visibility_setting": {+ "type": "string",+ "enum": [+ "show_all",+ "dont_store_data"+ ]+ },+ "require_mcp_api_key": {+ "type": "boolean"+ },+ "is_composio_link_enabled_for_managed_auth": {+ "type": "boolean",+ "description": "Whether to enable composio link for managed authentication. This key will be deprecated in the future. Please don't use this key."+ },+ "signed_url_file_expiry_in_seconds": {"type": "number","minimum": 1,"maximum": 86400@@ -5136,6 +5471,144 @@}}},+ "/api/v3/org/project/usage/summary": {+ "get": {+ "summary": "Project usage summary",+ "description": "Aggregated metering usage for the authenticated project only. Requires ClickHouse logging (`USE_CLICKHOUSE_FOR_LOGS`). Values are summed from raw metering events grouped by `entity_type`.",+ "tags": [+ "Projects"+ ],+ "operationId": "getOrgProjectUsageSummary",+ "security": [+ {+ "ApiKeyAuth": []+ },+ {+ "UserApiKeyAuth": []+ }+ ],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "description": "Inclusive range start (ISO 8601). Defaults to 30 days before end_time."+ },+ "required": false,+ "description": "Inclusive range start (ISO 8601). Defaults to 30 days before end_time.",+ "name": "start_time",+ "in": "query"+ },+ {+ "schema": {+ "type": "string",+ "description": "Exclusive range end (ISO 8601). Defaults to now."+ },+ "required": false,+ "description": "Exclusive range end (ISO 8601). Defaults to now.",+ "name": "end_time",+ "in": "query"+ },+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string"+ },+ "description": "Filter to these metering entity types (comma-separated or repeated query keys). Omit for all types."+ },+ "required": false,+ "description": "Filter to these metering entity types (comma-separated or repeated query keys). Omit for all types.",+ "name": "entity_types",+ "in": "query"+ }+ ],+ "responses": {+ "200": {+ "description": "Usage aggregates for the project.",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "rows": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "entity_type": {+ "type": "string"+ },+ "unit": {+ "type": "string"+ },+ "total_quantity": {+ "type": "string"+ },+ "event_count": {+ "type": "integer",+ "minimum": 0+ }+ },+ "required": [+ "entity_type",+ "unit",+ "total_quantity",+ "event_count"+ ]+ }+ }+ },+ "required": [+ "rows"+ ]+ }+ }+ }+ },+ "400": {+ "description": "Invalid time range, entity_types, or query parameters.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "401": {+ "description": "Authentication required.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "403": {+ "description": "Forbidden.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "500": {+ "description": "Failed to load usage from analytics store or feature configuration.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ }+ }+ }+ },"/api/v3/org/owner/project/new": {"post": {"summary": "Create a new project",@@ -7763,14 +8236,14 @@}}},- "/api/v3/toolkits/multi": {- "post": {- "summary": "Fetch multiple toolkits",- "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. You can optionally specify a list of toolkit slugs to fetch specific toolkits.",+ "/api/v3/tools": {+ "get": {+ "summary": "List available tools",+ "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.","tags": [- "Toolkits"+ "Tools"],- "operationId": "postToolkitsMulti",+ "operationId": "getTools","security": [{"ApiKeyAuth": []@@ -7779,250 +8252,182 @@"UserApiKeyAuth": []}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "toolkits": {- "type": "array",- "items": {- "type": "string"- },- "description": "Array of toolkit slug identifiers to retrieve",- "example": [- "github",- "slack",- "gmail"- ]- },- "category": {- "type": "string",- "description": "Category ID or name to filter toolkits by",- "example": "productivity"- },- "managed_by": {- "type": "string",- "enum": [- "composio",- "all",- "project"- ],- "description": "Entity responsible for managing the toolkits"- },- "sort_by": {- "type": "string",- "enum": [- "usage",- "alphabetically"- ],- "description": "Determines how toolkits should be sorted in the response"- },- "limit": {- "type": "number",- "nullable": true- },- "cursor": {+ "parameters": [+ {+ "schema": {+ "type": "string"+ },+ "required": false,+ "description": "The slug of the toolkit to filter by",+ "in": "query",+ "name": "toolkit_slug"+ },+ {+ "schema": {+ "type": "string"+ },+ "required": false,+ "description": "Comma-separated list of specific tool slugs to retrieve (overrides other filters)",+ "in": "query",+ "name": "tool_slugs"+ },+ {+ "schema": {+ "oneOf": [+ {+ "type": "string"+ },+ {+ "type": "array",+ "items": {"type": "string"}+ }+ ]+ },+ "required": false,+ "description": "Comma-separated list of auth config IDs to filter tools by",+ "in": "query",+ "name": "auth_config_ids"+ },+ {+ "schema": {+ "type": "string",+ "enum": [+ "true",+ "false"+ ]+ },+ "required": false,+ "description": "Filter to only show important/featured tools (set to \"true\" to enable)",+ "in": "query",+ "name": "important"+ },+ {+ "schema": {+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "required": false,+ "description": "Filter tools by one or more tags (can be specified multiple times)",+ "in": "query",+ "name": "tags"+ },+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string"+ },+ "description": "Filter tools by one or more scopes (can be specified multiple times)"+ },+ "required": false,+ "description": "Array of scopes to filter tools by)",+ "name": "scopes",+ "in": "query"+ },+ {+ "schema": {+ "type": "string"+ },+ "required": false,+ "description": "Full-text search query to filter tools by name, slug, or description. Applied as a soft filter on top of other filters.",+ "in": "query",+ "name": "query"+ },+ {+ "schema": {+ "type": "string"+ },+ "required": false,+ "description": "Deprecated: use \"query\" instead. Free-text search query to find tools by name, description, or functionality.",+ "in": "query",+ "name": "search",+ "deprecated": true+ },+ {+ "schema": {+ "type": "boolean",+ "default": true+ },+ "required": false,+ "description": "Include deprecated tools in the response",+ "in": "query",+ "name": "include_deprecated"+ },+ {+ "schema": {+ "oneOf": [+ {+ "type": "null"},- "description": "Body parameters for filtering and sorting toolkits"+ {+ "type": "string"+ },+ {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ },+ "description": "Object representation of parsed bracket notation"+ }+ ]+ },+ "required": false,+ "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",+ "in": "query",+ "name": "toolkit_versions",+ "examples": {+ "latest_version": {+ "summary": "Latest version for all toolkits",+ "value": "latest"+ },+ "bracket_notation": {+ "summary": "Specific versions using bracket notation",+ "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"+ },+ "null_value": {+ "summary": "No version specified (uses 00000000_00)",+ "value": null}}+ },+ {+ "schema": {+ "type": "number",+ "nullable": true+ },+ "required": false,+ "description": "Number of items per page, max allowed is 1000",+ "name": "limit",+ "in": "query"+ },+ {+ "schema": {+ "type": "string"+ },+ "required": false,+ "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.",+ "name": "cursor",+ "in": "query"}- },+ ],"responses": {"200": {- "description": "Toolkits retrieved successfully. Returns a paginated list of available toolkits with detailed metadata.",+ "description": "Successfully retrieved tools list with pagination information","content": {"application/json": {"schema": {- "type": "object",- "properties": {- "items": {- "type": "array",- "items": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "description": "URL-friendly unique identifier for the toolkit",- "example": "github"- },- "name": {- "type": "string",- "description": "Human-readable name of the toolkit",- "example": "GitHub"- },- "auth_schemes": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of authentication methods supported by this toolkit",- "example": [- "oauth2",- "api_key"- ]- },- "composio_managed_auth_schemes": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of authentication methods that Composio manages for this toolkit",- "example": [- "oauth2"- ]- },- "is_local_toolkit": {- "type": "boolean",- "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.",- "deprecated": true,- "example": false- },- "no_auth": {- "type": "boolean",- "description": "When true, this toolkit can be used without authentication",- "example": false- },- "auth_guide_url": {- "type": "string",- "nullable": true,- "description": "URL to a guide page with authentication setup instructions for this toolkit",- "example": "https://composio.dev/auth/github"- },- "deprecated": {- "$ref": "#/components/schemas/DeprecatedToolkitInfo"- },- "meta": {- "type": "object",- "properties": {- "created_at": {- "type": "string",- "description": "Creation date and time of the toolkit",- "example": "2023-01-15T09:30:00.000Z"- },- "updated_at": {- "type": "string",- "description": "Last modification date and time of the toolkit",- "example": "2023-05-20T14:45:00.000Z"- },- "description": {- "type": "string",- "description": "Human-readable description explaining the toolkit's purpose and functionality",- "example": "Integrate with GitHub repositories, issues, pull requests, and more."- },- "logo": {- "type": "string",- "description": "Image URL for the toolkit's branding",- "example": "https://assets.composio.dev/logos/github.png"- },- "app_url": {- "type": "string",- "nullable": true,- "description": "Link to the toolkit's main application or service website",- "example": "https://github.com"- },- "categories": {- "type": "array",- "items": {- "type": "object",- "properties": {- "id": {- "type": "string",- "description": "Category identifier",- "example": "developer-tools"- },- "name": {- "type": "string",- "description": "Human-readable category name",- "example": "Developer Tools"- }- },- "required": [- "id",- "name"- ]- },- "description": "List of categories associated with this toolkit",- "example": [- {- "id": "developer-tools",- "name": "Developer Tools"- },- {- "id": "productivity",- "name": "Productivity"- }- ]- },- "triggers_count": {- "type": "number",- "description": "Count of available triggers in this toolkit",- "example": 5- },- "tools_count": {- "type": "number",- "description": "Count of available tools in this toolkit",- "example": 12- },- "version": {- "type": "string",- "description": "Version of the toolkit",- "example": "20250905_00"- }- },- "required": [- "created_at",- "updated_at",- "description",- "logo",- "categories",- "triggers_count",- "tools_count",- "version"- ],- "description": "Additional metadata about the toolkit"- }- },- "required": [- "slug",- "name",- "is_local_toolkit",- "deprecated",- "meta"- ],- "description": "Detailed information about a toolkit"- }- },- "next_cursor": {- "type": "string",- "nullable": true- },- "total_pages": {- "type": "number"- },- "current_page": {- "type": "number"- },- "total_items": {- "type": "number"- }- },- "required": [- "items",- "total_pages",- "current_page",- "total_items"- ]+ "$ref": "#/components/schemas/ToolsPaginated"}}}},"400": {- "description": "Bad request. The query parameters may be invalid or in an incorrect format.",+ "description": "Bad request - Invalid query parameters","content": {"application/json": {"schema": {@@ -8032,7 +8437,17 @@}},"401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "description": "Unauthorized - Authentication credentials are missing or invalid",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "403": {+ "description": "Forbidden - User does not have permission to access tools","content": {"application/json": {"schema": {@@ -8042,7 +8457,17 @@}},"404": {- "description": "Not found. The toolkits you are looking for do not exist.",+ "description": "Not found - The requested resource was not found",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "429": {+ "description": "Too many requests - Rate limit exceeded","content": {"application/json": {"schema": {@@ -8052,7 +8477,7 @@}},"500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",+ "description": "Internal server error - Something went wrong on the server","content": {"application/json": {"schema": {@@ -8064,14 +8489,14 @@}}},- "/api/v3/tools/execute/proxy": {- "post": {- "summary": "Execute proxy request",- "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.",+ "/api/v3/tools/enum": {+ "get": {+ "summary": "Get tool enum list",+ "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.","tags": ["Tools"],- "operationId": "postToolsExecuteProxy",+ "operationId": "getToolsEnum","security": [{"ApiKeyAuth": []@@ -8080,452 +8505,461 @@"UserApiKeyAuth": []}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "connected_account_id": {- "type": "string",- "format": "connectedAccountId",- "description": "The ID of the connected account to use for authentication (if not provided, will use the default account for the project)",- "example": "ca_1a2b3c4d5e6f"- },- "endpoint": {- "type": "string",- "description": "The API endpoint to call (absolute URL or path relative to base URL of the connected account)",- "example": "/api/v1/resources"- },- "method": {- "type": "string",- "enum": [- "GET",- "POST",- "PUT",- "DELETE",- "PATCH",- "HEAD"- ],- "description": "The HTTP method to use for the request",- "example": "GET"- },- "body": {- "nullable": true,- "description": "The request body (for POST, PUT, and PATCH requests)",- "example": {- "name": "New Resource",- "description": "This is a new resource"- },- "type": "object"- },- "binary_body": {- "anyOf": [- {- "type": "object",- "properties": {- "url": {- "type": "string",- "format": "uri",- "description": "URL to fetch binary content from"- },- "content_type": {- "type": "string",- "description": "Content-Type header to use for the request"- }- },- "required": [- "url"- ]- },- {- "type": "object",- "properties": {- "base64": {- "type": "string",- "minLength": 1,- "description": "Base64-encoded binary data"- },- "content_type": {- "type": "string",- "description": "Content-Type header to use for the request"- }- },- "required": [- "base64"- ]- }- ],- "description": "Binary body to send. For binary upload via URL: use {url: \"https://...\", content_type?: \"...\"}. For binary upload via base64: use {base64: \"...\", content_type?: \"...\"}."+ "responses": {+ "200": {+ "description": "Successfully retrieved tool enum list",+ "content": {+ "application/json": {+ "schema": {+ "type": "array",+ "items": {+ "type": "string"},- "parameters": {- "type": "array",- "items": {- "type": "object",- "properties": {- "name": {- "type": "string",- "description": "Parameter name",- "example": "x-api-key"- },- "value": {- "type": "string",- "description": "Parameter value",- "example": "abc123def456"- },- "type": {- "type": "string",- "enum": [- "header",- "query"- ],- "description": "Parameter type (header or query)",- "example": "header"- }- },- "required": [- "name",- "value",- "type"- ]+ "description": "JSON string containing all tool enum values from latest version of each toolkit"+ }+ }+ }+ },+ "400": {+ "description": "Bad request - Invalid request parameters",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "401": {+ "description": "Unauthorized - Authentication credentials are missing or invalid",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "403": {+ "description": "Forbidden - User does not have permission to access tool enums",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "404": {+ "description": "Not found - Tool enum list not found",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "500": {+ "description": "Internal server error - Something went wrong on the server",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ }+ }+ }+ },+ "/api/v3/tools/{tool_slug}": {+ "get": {+ "summary": "Get tool by slug",+ "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.",+ "tags": [+ "Tools"+ ],+ "operationId": "getToolsByToolSlug",+ "security": [+ {+ "ApiKeyAuth": []+ },+ {+ "UserApiKeyAuth": []+ }+ ],+ "parameters": [+ {+ "schema": {+ "type": "string"+ },+ "required": true,+ "description": "The unique slug identifier of the tool",+ "name": "tool_slug",+ "in": "path"+ },+ {+ "schema": {+ "type": "string"+ },+ "required": false,+ "description": "Optional version of the tool to retrieve",+ "name": "version",+ "in": "query"+ },+ {+ "schema": {+ "oneOf": [+ {+ "type": "null"+ },+ {+ "type": "string"+ },+ {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ },+ "description": "Object representation of parsed bracket notation"+ }+ ]+ },+ "required": false,+ "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",+ "in": "query",+ "name": "toolkit_versions",+ "examples": {+ "latest_version": {+ "summary": "Latest version for all toolkits",+ "value": "latest"+ },+ "bracket_notation": {+ "summary": "Specific versions using bracket notation",+ "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"+ },+ "null_value": {+ "summary": "No version specified (uses 00000000_00)",+ "value": null+ }+ }+ }+ ],+ "responses": {+ "200": {+ "description": "Successfully retrieved tool details",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Tool"+ }+ }+ }+ },+ "400": {+ "description": "Bad request - Invalid tool slug format",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "401": {+ "description": "Unauthorized - Authentication credentials are missing or invalid",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "404": {+ "description": "Not found - Tool with the specified slug does not exist",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "500": {+ "description": "Internal server error - Something went wrong on the server",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ }+ }+ }+ },+ "/api/v3/toolkits/multi": {+ "post": {+ "summary": "Fetch multiple toolkits",+ "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. You can optionally specify a list of toolkit slugs to fetch specific toolkits.",+ "tags": [+ "Toolkits"+ ],+ "operationId": "postToolkitsMulti",+ "security": [+ {+ "ApiKeyAuth": []+ },+ {+ "UserApiKeyAuth": []+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "toolkits": {+ "type": "array",+ "items": {+ "type": "string"},- "description": "Additional HTTP headers or query parameters to include in the request",+ "description": "Array of toolkit slug identifiers to retrieve","example": [- {- "name": "x-api-key",- "value": "abc123def456",- "type": "header"- },- {- "name": "filter",- "value": "active",- "type": "query"- }+ "github",+ "slack",+ "gmail"]},- "custom_connection_data": {- "deprecated": true,- "type": "object",- "properties": {- "authScheme": {- "type": "string",- "enum": [- "OAUTH2",- "DCR_OAUTH",- "API_KEY",- "BASIC_WITH_JWT",- "BASIC",- "BEARER_TOKEN",- "OAUTH1",- "NO_AUTH",- "SERVICE_ACCOUNT",- "GOOGLE_SERVICE_ACCOUNT",- "S2S_OAUTH2"- ]- },- "toolkitSlug": {- "type": "string"- },- "val": {- "type": "object",- "properties": {- "subdomain": {- "type": "string"- },- "your-domain": {- "type": "string"- },- "region": {- "type": "string"- },- "shop": {- "type": "string"- },- "account_url": {- "type": "string"- },- "COMPANYDOMAIN": {- "type": "string"- },- "extension": {- "type": "string"- },- "form_api_base_url": {- "type": "string"- },- "instanceEndpoint": {- "type": "string"- },- "api_url": {- "type": "string"- },- "borneo_dashboard_url": {- "type": "string"- },- "proxy_username": {- "type": "string"- },- "proxy_password": {- "type": "string"- },- "domain": {- "type": "string"- },- "version": {- "type": "string"- },- "dc": {- "type": "string"- },- "site_name": {- "type": "string"- },- "instanceName": {- "type": "string"- },- "account_id": {- "type": "string"- },- "your_server": {- "type": "string"- },- "server_location": {- "type": "string"- },- "base_url": {- "type": "string"+ "category": {+ "type": "string",+ "description": "Category ID or name to filter toolkits by",+ "example": "productivity"+ },+ "managed_by": {+ "type": "string",+ "enum": [+ "composio",+ "all",+ "project"+ ],+ "description": "Entity responsible for managing the toolkits"+ },+ "sort_by": {+ "type": "string",+ "enum": [+ "usage",+ "alphabetically"+ ],+ "description": "Determines how toolkits should be sorted in the response"+ },+ "limit": {+ "type": "number",+ "nullable": true+ },+ "cursor": {+ "type": "string"+ }+ },+ "description": "Body parameters for filtering and sorting toolkits"+ }+ }+ }+ },+ "responses": {+ "200": {+ "description": "Toolkits retrieved successfully. Returns a paginated list of available toolkits with detailed metadata.",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "items": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "description": "URL-friendly unique identifier for the toolkit",+ "example": "github"},- "state_prefix": {+ "name": {"type": "string",- "maxLength": 40,- "description": "The oauth2 state prefix for the connection"+ "description": "Human-readable name of the toolkit",+ "example": "GitHub"},- "long_redirect_url": {- "type": "boolean",- "description": "Whether to return the redirect url without shortening"+ "auth_schemes": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of authentication methods supported by this toolkit",+ "example": [+ "oauth2",+ "api_key"+ ]},- "access_token": {- "type": "string"+ "composio_managed_auth_schemes": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of authentication methods that Composio manages for this toolkit",+ "example": [+ "oauth2"+ ]},- "id_token": {- "type": "string"+ "is_local_toolkit": {+ "type": "boolean",+ "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.",+ "deprecated": true,+ "example": false},- "token_type": {- "type": "string"+ "no_auth": {+ "type": "boolean",+ "description": "When true, this toolkit can be used without authentication",+ "example": false},- "refresh_token": {+ "auth_guide_url": {"type": "string",- "nullable": true+ "nullable": true,+ "description": "URL to a guide page with authentication setup instructions for this toolkit",+ "example": "https://composio.dev/auth/github"},- "expires_in": {- "anyOf": [- {- "type": "number"+ "deprecated": {+ "$ref": "#/components/schemas/DeprecatedToolkitInfo"+ },+ "meta": {+ "type": "object",+ "properties": {+ "created_at": {+ "type": "string",+ "description": "Creation date and time of the toolkit",+ "example": "2023-01-15T09:30:00.000Z"},- {- "type": "string"+ "updated_at": {+ "type": "string",+ "description": "Last modification date and time of the toolkit",+ "example": "2023-05-20T14:45:00.000Z"},- {+ "description": {+ "type": "string",+ "description": "Human-readable description explaining the toolkit's purpose and functionality",+ "example": "Integrate with GitHub repositories, issues, pull requests, and more."+ },+ "logo": {+ "type": "string",+ "description": "Image URL for the toolkit's branding",+ "example": "https://assets.composio.dev/logos/github.png"+ },+ "app_url": {+ "type": "string","nullable": true,- "type": "object"- }- ]- },- "scope": {- "anyOf": [- {- "type": "string"+ "description": "Link to the toolkit's main application or service website",+ "example": "https://github.com"},- {+ "categories": {"type": "array","items": {- "type": "string"- }+ "type": "object",+ "properties": {+ "id": {+ "type": "string",+ "description": "Category identifier",+ "example": "developer-tools"+ },+ "name": {+ "type": "string",+ "description": "Human-readable category name",+ "example": "Developer Tools"+ }+ },+ "required": [+ "id",+ "name"+ ]+ },+ "description": "List of categories associated with this toolkit",+ "example": [+ {+ "id": "developer-tools",+ "name": "Developer Tools"+ },+ {+ "id": "productivity",+ "name": "Productivity"+ }+ ]},- {- "nullable": true,- "type": "object"- }- ]- },- "webhook_signature": {- "type": "string"- },- "authed_user": {- "type": "object",- "properties": {- "access_token": {- "type": "string"+ "triggers_count": {+ "type": "number",+ "description": "Count of available triggers in this toolkit",+ "example": 5},- "scope": {- "type": "string"+ "tools_count": {+ "type": "number",+ "description": "Count of available tools in this toolkit",+ "example": 12+ },+ "version": {+ "type": "string",+ "description": "Version of the toolkit",+ "example": "20250905_00"}},- "description": "for slack user scopes"- },- "client_id": {- "type": "string",- "description": "Dynamically registered client ID"- },- "client_secret": {- "type": "string",- "description": "Dynamically registered client secret"- },- "client_id_issued_at": {- "type": "number"- },- "client_secret_expires_at": {- "type": "number"- },- "generic_api_key": {- "type": "string"- },- "api_key": {- "type": "string"- },- "bearer_token": {- "type": "string"- },- "basic_encoded": {- "type": "string"- },- "username": {- "type": "string"- },- "password": {- "type": "string"- },- "token": {- "type": "string"- },- "oauth_token": {- "type": "string"- },- "oauth_token_secret": {- "type": "string"- },- "oauth_verifier": {- "type": "string"- },- "consumer_key": {- "type": "string"- },- "redirectUrl": {- "type": "string"- },- "callback_url": {- "type": "string"- },- "application_id": {- "type": "string"- },- "installation_id": {- "type": "string"- },- "private_key": {- "type": "string"- },- "credentials_json": {- "type": "string"- },- "expires_at": {- "type": "string"+ "required": [+ "created_at",+ "updated_at",+ "description",+ "logo",+ "categories",+ "triggers_count",+ "tools_count",+ "version"+ ],+ "description": "Additional metadata about the toolkit"}},"required": [- "access_token"+ "slug",+ "name",+ "is_local_toolkit",+ "deprecated",+ "meta"],- "additionalProperties": {}+ "description": "Detailed information about a toolkit"}},- "required": [- "authScheme",- "toolkitSlug",- "val"- ],- "additionalProperties": true- }- },- "required": [- "endpoint",- "method"- ]- }- }- }- },- "responses": {- "200": {- "description": "Successfully executed proxy request and received response",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "data": {- "nullable": true,- "description": "The response data returned from the proxied API",- "example": {- "id": "123",- "name": "Resource Name",- "created_at": "2023-01-01T00:00:00Z"- },- "type": "object"+ "next_cursor": {+ "type": "string",+ "nullable": true},- "binary_data": {- "type": "object",- "properties": {- "url": {- "type": "string",- "description": "URL to download binary content"- },- "content_type": {- "type": "string",- "description": "Content-Type of the binary data"- },- "size": {- "type": "number",- "description": "File size in bytes"- },- "expires_at": {- "type": "string",- "description": "ISO 8601 timestamp when the URL expires"- }- },- "required": [- "url",- "content_type",- "size"- ],- "description": "Binary body response data. Present when the response is a binary file."+ "total_pages": {+ "type": "number"},- "status": {- "type": "number",- "description": "The HTTP status code returned from the proxied API",- "example": 200+ "current_page": {+ "type": "number"},- "headers": {- "type": "object",- "additionalProperties": {- "type": "string"- },- "description": "The HTTP headers returned from the proxied API",- "example": {- "content-type": "application/json",- "cache-control": "no-cache",- "host": "api.example.com"- }+ "total_items": {+ "type": "number"}},"required": [- "status"+ "items",+ "total_pages",+ "current_page",+ "total_items"]}}}},"400": {- "description": "Bad request - Invalid request parameters or body format",+ "description": "Bad request. The query parameters may be invalid or in an incorrect format.","content": {"application/json": {"schema": {@@ -8535,17 +8969,7 @@}},"401": {- "description": "Unauthorized - Authentication credentials are missing or invalid",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "403": {- "description": "Forbidden - Connected account does not have permission to access the requested resource",+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.","content": {"application/json": {"schema": {@@ -8555,27 +8979,7 @@}},"404": {- "description": "Not found - Resource not found or connected account not found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "422": {- "description": "Unprocessable entity - Invalid state of the connected account",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "429": {- "description": "Too many requests - Rate limit exceeded on the connected account or proxy service",+ "description": "Not found. The toolkits you are looking for do not exist.","content": {"application/json": {"schema": {@@ -8585,37 +8989,7 @@}},"500": {- "description": "Internal server error - Something went wrong on the server",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "501": {- "description": "Not implemented - This operation is not supported for the requested connected account or authentication scheme",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "502": {- "description": "Bad gateway - Error communicating with the upstream API",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "504": {- "description": "Gateway timeout - Upstream API timed out",+ "description": "Internal server error. An unexpected error occurred while processing the request.","content": {"application/json": {"schema": {@@ -8627,14 +9001,14 @@}}},- "/api/v3/trigger_instances/{slug}/upsert": {+ "/api/v3/tools/execute/{tool_slug}": {"post": {- "summary": "Create or update a trigger",- "description": "Creates a new trigger instance or updates an existing one with the same configuration. Triggers listen for events from external services (webhooks or polling) and can invoke your workflows. If a matching trigger already exists and is disabled, it will be re-enabled. Requires a connected account ID to associate the trigger with a specific user connection.",+ "summary": "Execute tool",+ "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.","tags": [- "Triggers"+ "Tools"],- "operationId": "postTriggerInstancesBySlugUpsert",+ "operationId": "postToolsExecuteByToolSlug","security": [{"ApiKeyAuth": []@@ -8646,13 +9020,22 @@"parameters": [{"schema": {- "type": "string",- "description": "The slug of the trigger instance. Case-insensitive (internally normalized to uppercase)."+ "type": "string"},"required": true,- "description": "The slug of the trigger instance. Case-insensitive (internally normalized to uppercase).",- "name": "slug",+ "description": "The tool slug to execute",+ "name": "tool_slug","in": "path"+ },+ {+ "schema": {+ "type": "string",+ "description": "JSON object containing custom headers to pass to LLM providers (OpenAI, Bedrock, etc.)",+ "example": "{\"x-custom-header\": \"value\", \"authorization\": \"Bearer token\"}"+ },+ "required": false,+ "name": "x-llm-gateway-headers",+ "in": "header"}],"requestBody": {@@ -8661,186 +9044,502 @@"schema": {"type": "object","properties": {- "connectedAuthId": {+ "connected_account_id": {"type": "string",- "format": "connectedAccountId",- "description": "DEPRECATED: This parameter will be removed in a future version. Please use connected_account_id instead.",- "deprecated": true+ "description": "Unique identifier for the connected account to use for authentication",+ "example": "ca_1a2b3c4d5e6f"},- "triggerConfig": {- "type": "object",- "additionalProperties": {},- "description": "DEPRECATED: This parameter will be removed in a future version. Please use trigger_config instead.",+ "entity_id": {+ "type": "string",+ "description": "Deprecated: please use user_id instead. Entity identifier for multi-entity connected accounts (e.g. multiple repositories, organizations)",+ "example": "repo-123","deprecated": true},- "connected_account_id": {+ "user_id": {"type": "string",- "format": "connectedAccountId",- "description": "Connected account nanoid"- },- "trigger_config": {- "type": "object",- "additionalProperties": {},- "description": "Trigger configuration"+ "description": "User id for multi-user connected accounts (e.g. multiple users, organizations)",+ "example": "user-123"},"version": {"type": "string",- "description": "DEPRECATED: This parameter will be removed in a future version. Please use toolkit_versions instead.",- "deprecated": true,+ "description": "Tool version to execute (defaults to \"00000000_00\" if not specified)","example": "latest"},- "toolkit_versions": {- "anyOf": [- {- "type": "string"+ "custom_auth_params": {+ "type": "object",+ "properties": {+ "base_url": {+ "type": "string",+ "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'"},- {- "type": "object",- "additionalProperties": {- "type": "string"+ "parameters": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "name": {+ "type": "string",+ "description": "The name of the parameter. For example, 'x-api-key', 'Content-Type', etc."+ },+ "in": {+ "type": "string",+ "enum": [+ "query",+ "header"+ ],+ "description": "The location of the parameter. Can be 'query' or 'header'."+ },+ "value": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "number"+ }+ ],+ "description": "The value of the parameter. For example, '1234567890', 'application/json', etc."+ }+ },+ "required": [+ "name",+ "in",+ "value"+ ]}},- {- "nullable": true,- "type": "object"+ "body": {+ "type": "object",+ "additionalProperties": {},+ "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."}- ],- "description": "Toolkit version specification. Supports \"latest\" string or a record mapping toolkit slugs to specific versions.",- "example": "latest"- }- }- }- }- }- },- "responses": {- "200": {- "description": "Successfully upserted trigger instance",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "trigger_id": {- "type": "string",- "description": "ID of the updated trigger"},- "deprecated": {- "type": "object",- "properties": {- "uuid": {- "type": "string",- "description": "ID of the updated trigger"+ "description": "Custom authentication parameters for tools that support parameterized authentication",+ "example": {+ "base_url": "https://api.example.com",+ "parameters": [+ {+ "name": "x-api-key",+ "value": "secret-key",+ "in": "header"}- },- "required": [- "uuid"]}},- "required": [- "trigger_id",- "deprecated"- ]- }- }- }- },- "201": {- "description": "Successfully created trigger instance",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "trigger_id": {- "type": "string",- "description": "ID of the updated trigger"+ "custom_connection_data": {+ "description": "Custom connection data for tools that support custom connection data",+ "example": {+ "authScheme": "OAUTH2",+ "toolkitSlug": "github",+ "val": {+ "access_token": "secret-token"+ }},- "deprecated": {- "type": "object",- "properties": {- "uuid": {- "type": "string",- "description": "ID of the updated trigger"- }+ "type": "object",+ "properties": {+ "authScheme": {+ "type": "string",+ "enum": [+ "OAUTH2",+ "DCR_OAUTH",+ "API_KEY",+ "BASIC_WITH_JWT",+ "BASIC",+ "BEARER_TOKEN",+ "OAUTH1",+ "NO_AUTH",+ "SERVICE_ACCOUNT",+ "GOOGLE_SERVICE_ACCOUNT",+ "S2S_OAUTH2"+ ]},- "required": [- "uuid"- ]- }- },- "required": [- "trigger_id",- "deprecated"- ]- }- }- }- },- "204": {- "description": "No content",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {}- }- }- }- },- "400": {- "description": "Bad request",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "401": {- "description": "Unauthorized",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "404": {- "description": "Trigger instance not found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "408": {- "description": "Request timeout",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "410": {- "description": "Gone",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"+ "toolkitSlug": {+ "type": "string"+ },+ "val": {+ "type": "object",+ "properties": {+ "subdomain": {+ "type": "string"+ },+ "your-domain": {+ "type": "string"+ },+ "region": {+ "type": "string"+ },+ "shop": {+ "type": "string"+ },+ "account_url": {+ "type": "string"+ },+ "COMPANYDOMAIN": {+ "type": "string"+ },+ "extension": {+ "type": "string"+ },+ "form_api_base_url": {+ "type": "string"+ },+ "instanceEndpoint": {+ "type": "string"+ },+ "api_url": {+ "type": "string"+ },+ "borneo_dashboard_url": {+ "type": "string"+ },+ "proxy_username": {+ "type": "string"+ },+ "proxy_password": {+ "type": "string"+ },+ "domain": {+ "type": "string"+ },+ "version": {+ "type": "string"+ },+ "dc": {+ "type": "string"+ },+ "site_name": {+ "type": "string"+ },+ "instanceName": {+ "type": "string"+ },+ "account_id": {+ "type": "string"+ },+ "your_server": {+ "type": "string"+ },+ "server_location": {+ "type": "string"+ },+ "base_url": {+ "type": "string"+ },+ "state_prefix": {+ "type": "string",+ "maxLength": 40,+ "description": "The oauth2 state prefix for the connection"+ },+ "long_redirect_url": {+ "type": "boolean",+ "description": "Whether to return the redirect url without shortening"+ },+ "access_token": {+ "type": "string"+ },+ "id_token": {+ "type": "string"+ },+ "token_type": {+ "type": "string"+ },+ "refresh_token": {+ "type": "string",+ "nullable": true+ },+ "expires_in": {+ "anyOf": [+ {+ "type": "number"+ },+ {+ "type": "string"+ },+ {+ "nullable": true,+ "type": "object"+ }+ ]+ },+ "scope": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ {+ "nullable": true,+ "type": "object"+ }+ ]+ },+ "webhook_signature": {+ "type": "string"+ },+ "authed_user": {+ "type": "object",+ "properties": {+ "access_token": {+ "type": "string"+ },+ "scope": {+ "type": "string"+ }+ },+ "description": "for slack user scopes"+ },+ "client_id": {+ "type": "string",+ "description": "Dynamically registered client ID"+ },+ "client_secret": {+ "type": "string",+ "description": "Dynamically registered client secret"+ },+ "client_id_issued_at": {+ "type": "number"+ },+ "client_secret_expires_at": {+ "type": "number"+ },+ "generic_api_key": {+ "type": "string"+ },+ "api_key": {+ "type": "string"+ },+ "bearer_token": {+ "type": "string"+ },+ "basic_encoded": {+ "type": "string"+ },+ "username": {+ "type": "string"+ },+ "password": {+ "type": "string"+ },+ "token": {+ "type": "string"+ },+ "oauth_token": {+ "type": "string"+ },+ "oauth_token_secret": {+ "type": "string"+ },+ "oauth_verifier": {+ "type": "string"+ },+ "consumer_key": {+ "type": "string"+ },+ "redirectUrl": {+ "type": "string"+ },+ "callback_url": {+ "type": "string"+ },+ "application_id": {+ "type": "string"+ },+ "installation_id": {+ "type": "string"+ },+ "private_key": {+ "type": "string"+ },+ "credentials_json": {+ "type": "string"+ },+ "expires_at": {+ "type": "string"+ }+ },+ "required": [+ "access_token"+ ],+ "additionalProperties": {}+ }+ },+ "required": [+ "authScheme",+ "toolkitSlug",+ "val"+ ],+ "additionalProperties": true+ },+ "arguments": {+ "type": "object",+ "additionalProperties": {},+ "description": "Key-value pairs of arguments required by the tool (mutually exclusive with text)",+ "example": {+ "repository": "octocat/Hello-World",+ "workflow_id": "main.yml",+ "ref": "main",+ "inputs": {+ "environment": "production"+ }+ }+ },+ "text": {+ "type": "string",+ "description": "Natural language description of the task to perform (mutually exclusive with arguments)",+ "example": "Trigger the main workflow in the octocat/Hello-World repository on the main branch for the production environment"+ },+ "allow_tracing": {+ "type": "boolean",+ "nullable": true,+ "description": "Deprecated. Enable debug tracing for tool execution (useful for debugging)",+ "deprecated": true,+ "example": false+ }}}}- },+ }+ },+ "responses": {+ "200": {+ "description": "Successfully executed action and received response",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "data": {+ "type": "object",+ "additionalProperties": {},+ "description": "Tool execution output data that varies based on the specific tool",+ "example": {+ "run_id": 12345678,+ "status": "queued",+ "created_at": "2023-01-01T12:00:00Z",+ "html_url": "https://github.com/octocat/Hello-World/actions/runs/12345678"+ }+ },+ "error": {+ "type": "string",+ "nullable": true,+ "description": "Error message if the tool execution was not successful (null if successful)"+ },+ "successful": {+ "type": "boolean",+ "description": "Indicates if the tool execution was successful",+ "example": true+ },+ "session_info": {+ "nullable": true,+ "description": "Optional session information for tools that return session context",+ "example": {+ "session_id": "session-12345",+ "expires_at": "2023-01-01T13:00:00Z"+ },+ "type": "object"+ },+ "log_id": {+ "type": "string",+ "description": "Unique identifier for the execution log (useful for debugging and support)",+ "example": "log_abc123def456"+ }+ },+ "required": [+ "data",+ "error",+ "successful"+ ]+ }+ }+ }+ },+ "400": {+ "description": "Bad request - Invalid request parameters, missing required arguments, or conflicting parameters",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "401": {+ "description": "Unauthorized - Authentication credentials are missing or invalid",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "403": {+ "description": "Forbidden - Connected account does not have permission to execute this tool or access the requested resource",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "404": {+ "description": "Not found - Tool or connected account not found",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "408": {+ "description": "Request timeout - Tool execution exceeded the maximum allowed time",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "410": {+ "description": "Gone - Tool has been deprecated and is no longer available",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "413": {+ "description": "Payload too large - Request or response payload exceeds size limits",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },"422": {- "description": "Unprocessable entity",+ "description": "Unprocessable entity - Invalid state of the connected account",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "429": {+ "description": "Rate limit exceeded - Too many requests to the tool or underlying API","content": {"application/json": {"schema": {@@ -8850,7 +9549,7 @@}},"500": {- "description": "Internal server error",+ "description": "Internal server error - Something went wrong on the server","content": {"application/json": {"schema": {@@ -8868,18 +9567,38 @@}}}+ },+ "502": {+ "description": "Bad gateway - Error communicating with the tool provider API",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "503": {+ "description": "Upstream service unavailable - Tool provider API is currently down or unavailable",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }}}}},- "/api/v3/trigger_instances/active": {- "get": {- "summary": "List active triggers",- "description": "Retrieves all active trigger instances for your project. Triggers listen for events from connected accounts (e.g., new emails, Slack messages, GitHub commits) and can invoke webhooks or workflows. Use filters to find triggers for specific users, connected accounts, or trigger types.",+ "/api/v3/tools/execute/{tool_slug}/input": {+ "post": {+ "summary": "Generate tool inputs from natural language",+ "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.","tags": [- "Triggers"+ "Tools"],- "operationId": "getTriggerInstancesActive",+ "operationId": "postToolsExecuteByToolSlugInput","security": [{"ApiKeyAuth": []@@ -8891,363 +9610,604 @@"parameters": [{"schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string"- },- "description": "Array of user IDs to filter triggers by"+ "type": "string"},- "required": false,- "description": "Array of user IDs to filter triggers by",- "name": "user_ids",- "in": "query"+ "required": true,+ "description": "The tool slug to generate inputs for",+ "name": "tool_slug",+ "in": "path"+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "text": {+ "type": "string",+ "description": "Natural language description of what you want to accomplish with this tool",+ "example": "I need to trigger the main workflow in the octocat/Hello-World repository to deploy to production"+ },+ "custom_description": {+ "type": "string",+ "description": "Custom description of the tool to help guide the LLM in generating more accurate inputs",+ "example": "This tool triggers GitHub Actions workflows in a repository. It requires the repository name, workflow ID, and optional input parameters."+ },+ "system_prompt": {+ "type": "string",+ "description": "System prompt to control and guide the behavior of the LLM when generating inputs",+ "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."+ },+ "version": {+ "type": "string",+ "description": "Tool version to use when generating inputs (defaults to \"latest\" if not specified)",+ "example": "latest"+ }+ },+ "required": [+ "text"+ ]+ }+ }+ }+ },+ "responses": {+ "200": {+ "description": "Successfully generated structured inputs for the action based on natural language description",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "arguments": {+ "type": "object",+ "additionalProperties": {},+ "description": "Key-value pairs of arguments required by the tool to accomplish the described task",+ "example": {+ "repository": "octocat/Hello-World",+ "workflow_id": "main.yml",+ "ref": "main",+ "inputs": {+ "environment": "production"+ }+ }+ },+ "error": {+ "type": "string",+ "description": "Error message if the arguments could not be generated (null if successful)",+ "example": "Unable to determine the repository name from the provided description"+ }+ }+ }+ }+ }},- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string",- "format": "connectedAccountId"- },- "description": "Array of connected account IDs to filter triggers by"- },- "required": false,- "description": "Array of connected account IDs to filter triggers by",- "name": "connected_account_ids",- "in": "query"- },- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string",- "format": "authConfigId"- },- "description": "Array of auth config IDs to filter triggers by"- },- "required": false,- "description": "Array of auth config IDs to filter triggers by",- "name": "auth_config_ids",- "in": "query"- },- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string",- "format": "triggerInstanceId"- },- "description": "Array of trigger IDs to filter triggers by"- },- "required": false,- "description": "Array of trigger IDs to filter triggers by",- "name": "trigger_ids",- "in": "query"- },- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string"- },- "description": "Array of trigger names to filter triggers by. Case-insensitive (internally normalized to uppercase)."- },- "required": false,- "description": "Array of trigger names to filter triggers by. Case-insensitive (internally normalized to uppercase).",- "name": "trigger_names",- "in": "query"- },- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string",- "format": "connectedAccountId"+ "400": {+ "description": "Bad request - Invalid input parameters or insufficient description to generate tool arguments",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }}- },- "required": false,- "description": "DEPRECATED: This parameter will be removed in a future version. Please use connected_account_ids instead.",- "deprecated": true,- "name": "connectedAccountIds",- "in": "query"+ }},- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string",- "format": "authConfigId"+ "401": {+ "description": "Unauthorized - Authentication credentials are missing or invalid",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }}- },- "required": false,- "description": "DEPRECATED: This parameter will be removed in a future version. Please use auth_config_ids instead.",- "deprecated": true,- "name": "authConfigIds",- "in": "query"+ }},- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string",- "format": "triggerInstanceId"+ "404": {+ "description": "Not found - The specified tool does not exist",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }}- },- "required": false,- "description": "DEPRECATED: This parameter will be removed in a future version. Please use trigger_ids instead.",- "deprecated": true,- "name": "triggerIds",- "in": "query"- },- {- "schema": {- "type": "boolean",- "nullable": true,- "default": false,- "description": "When set to true, includes disabled triggers in the response."- },- "required": false,- "description": "When set to true, includes disabled triggers in the response.",- "name": "show_disabled",- "in": "query"+ }},- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string"+ "422": {+ "description": "Unprocessable entity - Invalid state of the connected account",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }}- },- "required": false,- "description": "DEPRECATED: This parameter will be removed in a future version. Please use trigger_names instead.",- "deprecated": true,- "name": "triggerNames",- "in": "query"- },- {- "schema": {- "type": "boolean",- "nullable": true,- "default": false,- "description": "DEPRECATED: Use show_disabled instead"- },- "required": false,- "description": "DEPRECATED: This parameter will be removed in a future version. Please use show_disabled instead.",- "deprecated": true,- "name": "showDisabled",- "in": "query"- },- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string"- },- "description": "Array of connected account UUIDs to filter triggers by"- },- "required": false,- "description": "DEPRECATED: This parameter will be removed in a future version. Please use connected_account_ids instead.",- "deprecated": true,- "name": "deprecatedConnectedAccountUuids",- "in": "query"+ }},- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string"- },- "description": "Array of auth config UUIDs to filter triggers by"- },- "required": false,- "description": "DEPRECATED: This parameter will be removed in a future version. Please use auth_config_ids instead.",- "deprecated": true,- "name": "deprecatedAuthConfigUuids",- "in": "query"+ "429": {+ "description": "Too many requests - Rate limit exceeded for natural language processing",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }},+ "500": {+ "description": "Internal server error - AI processing failed or other server error occurred",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ }+ }+ }+ },+ "/api/v3/tools/execute/proxy": {+ "post": {+ "summary": "Execute proxy request",+ "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.",+ "tags": [+ "Tools"+ ],+ "operationId": "postToolsExecuteProxy",+ "security": [{- "schema": {- "type": "number",- "nullable": true- },- "required": false,- "description": "Number of items per page, max allowed is 1000",- "name": "limit",- "in": "query"+ "ApiKeyAuth": []},{- "schema": {- "type": "string"- },- "required": false,- "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.",- "name": "cursor",- "in": "query"+ "UserApiKeyAuth": []}],- "responses": {- "200": {- "description": "Successfully retrieved active trigger instances",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "items": {- "type": "array",- "items": {- "type": "object",- "properties": {- "uuid": {- "type": "string",- "description": "Unique identifier of the trigger instance"- },- "id": {+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "connected_account_id": {+ "type": "string",+ "format": "connectedAccountId",+ "description": "The ID of the connected account to use for authentication (if not provided, will use the default account for the project)",+ "example": "ca_1a2b3c4d5e6f"+ },+ "endpoint": {+ "type": "string",+ "description": "The API endpoint to call (absolute URL or path relative to base URL of the connected account)",+ "example": "/api/v1/resources"+ },+ "method": {+ "type": "string",+ "enum": [+ "GET",+ "POST",+ "PUT",+ "DELETE",+ "PATCH",+ "HEAD"+ ],+ "description": "The HTTP method to use for the request",+ "example": "GET"+ },+ "body": {+ "nullable": true,+ "description": "The request body (for POST, PUT, and PATCH requests)",+ "example": {+ "name": "New Resource",+ "description": "This is a new resource"+ },+ "type": "object"+ },+ "binary_body": {+ "anyOf": [+ {+ "type": "object",+ "properties": {+ "url": {"type": "string",- "format": "triggerInstanceId",- "description": "Nano ID of the trigger instance"+ "format": "uri",+ "description": "URL to fetch binary content from"},- "connected_account_id": {+ "content_type": {"type": "string",- "description": "ID of the connected account this trigger is associated with"- },- "trigger_name": {+ "description": "Content-Type header to use for the request"+ }+ },+ "required": [+ "url"+ ]+ },+ {+ "type": "object",+ "properties": {+ "base64": {"type": "string",- "description": "Name of the trigger"+ "minLength": 1,+ "description": "Base64-encoded binary data"},- "connected_account_uuid": {+ "content_type": {"type": "string",- "description": "UUID of the connected account this trigger is associated with"+ "description": "Content-Type header to use for the request"+ }+ },+ "required": [+ "base64"+ ]+ }+ ],+ "description": "Binary body to send. For binary upload via URL: use {url: \"https://...\", content_type?: \"...\"}. For binary upload via base64: use {base64: \"...\", content_type?: \"...\"}."+ },+ "parameters": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "name": {+ "type": "string",+ "description": "Parameter name",+ "example": "x-api-key"+ },+ "value": {+ "type": "string",+ "description": "Parameter value",+ "example": "abc123def456"+ },+ "type": {+ "type": "string",+ "enum": [+ "header",+ "query"+ ],+ "description": "Parameter type (header or query)",+ "example": "header"+ }+ },+ "required": [+ "name",+ "value",+ "type"+ ]+ },+ "description": "Additional HTTP headers or query parameters to include in the request",+ "example": [+ {+ "name": "x-api-key",+ "value": "abc123def456",+ "type": "header"+ },+ {+ "name": "filter",+ "value": "active",+ "type": "query"+ }+ ]+ },+ "custom_connection_data": {+ "deprecated": true,+ "type": "object",+ "properties": {+ "authScheme": {+ "type": "string",+ "enum": [+ "OAUTH2",+ "DCR_OAUTH",+ "API_KEY",+ "BASIC_WITH_JWT",+ "BASIC",+ "BEARER_TOKEN",+ "OAUTH1",+ "NO_AUTH",+ "SERVICE_ACCOUNT",+ "GOOGLE_SERVICE_ACCOUNT",+ "S2S_OAUTH2"+ ]+ },+ "toolkitSlug": {+ "type": "string"+ },+ "val": {+ "type": "object",+ "properties": {+ "subdomain": {+ "type": "string"},- "user_id": {- "type": "string",- "description": "ID of the user this trigger is associated with"+ "your-domain": {+ "type": "string"},- "trigger_data": {- "type": "string",- "description": "Additional data associated with the trigger instance"+ "region": {+ "type": "string"+ },+ "shop": {+ "type": "string"+ },+ "account_url": {+ "type": "string"+ },+ "COMPANYDOMAIN": {+ "type": "string"+ },+ "extension": {+ "type": "string"+ },+ "form_api_base_url": {+ "type": "string"+ },+ "instanceEndpoint": {+ "type": "string"+ },+ "api_url": {+ "type": "string"+ },+ "borneo_dashboard_url": {+ "type": "string"+ },+ "proxy_username": {+ "type": "string"+ },+ "proxy_password": {+ "type": "string"+ },+ "domain": {+ "type": "string"},"version": {- "type": "string",- "description": "Version of the trigger instance"+ "type": "string"},- "trigger_config": {- "type": "object",- "additionalProperties": {},- "description": "Configuration for the trigger"+ "dc": {+ "type": "string"},- "state": {- "type": "object",- "additionalProperties": {},- "description": "DEPRECATED: This field exposes internal state and will be removed in a future version.",- "deprecated": true+ "site_name": {+ "type": "string"},- "updated_at": {- "type": "string",- "description": "ISO 8601 timestamp when the trigger instance was updated"+ "instanceName": {+ "type": "string"},- "disabled_at": {- "type": "string",- "nullable": true,- "description": "ISO 8601 timestamp when the trigger instance was disabled, if applicable"+ "account_id": {+ "type": "string"},- "disabledAt": {- "type": "string",- "nullable": true,- "description": "DEPRECATED: This parameter will be removed in a future version. Please use disabled_at instead.",- "deprecated": true+ "your_server": {+ "type": "string"},- "connectedAccountId": {- "type": "string",- "description": "DEPRECATED: This parameter will be removed in a future version. Please use connected_account_id instead.",- "deprecated": true+ "server_location": {+ "type": "string"},- "triggerName": {- "type": "string",- "description": "DEPRECATED: This parameter will be removed in a future version. Please use trigger_name instead.",- "deprecated": true+ "base_url": {+ "type": "string"},- "updatedAt": {+ "state_prefix": {"type": "string",- "description": "DEPRECATED: This parameter will be removed in a future version. Please use updated_at instead.",- "deprecated": true- },- "triggerConfig": {- "type": "object",- "additionalProperties": {},- "description": "DEPRECATED: This parameter will be removed in a future version. Please use trigger_config instead.",- "deprecated": true+ "maxLength": 40,+ "description": "The oauth2 state prefix for the connection"},- "deprecated": {+ "long_redirect_url": {+ "type": "boolean",+ "description": "Whether to return the redirect url without shortening"+ },+ "access_token": {+ "type": "string"+ },+ "id_token": {+ "type": "string"+ },+ "token_type": {+ "type": "string"+ },+ "refresh_token": {+ "type": "string",+ "nullable": true+ },+ "expires_in": {+ "anyOf": [+ {+ "type": "number"+ },+ {+ "type": "string"+ },+ {+ "nullable": true,+ "type": "object"+ }+ ]+ },+ "scope": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ {+ "nullable": true,+ "type": "object"+ }+ ]+ },+ "webhook_signature": {+ "type": "string"+ },+ "authed_user": {"type": "object","properties": {- "createdAt": {- "type": "string",- "description": "Deprecated created_at for the trigger instance"+ "access_token": {+ "type": "string"+ },+ "scope": {+ "type": "string"}},- "required": [- "createdAt"- ],- "description": "Deprecated fields for the trigger instance"+ "description": "for slack user scopes"+ },+ "client_id": {+ "type": "string",+ "description": "Dynamically registered client ID"+ },+ "client_secret": {+ "type": "string",+ "description": "Dynamically registered client secret"+ },+ "client_id_issued_at": {+ "type": "number"+ },+ "client_secret_expires_at": {+ "type": "number"+ },+ "generic_api_key": {+ "type": "string"+ },+ "api_key": {+ "type": "string"+ },+ "bearer_token": {+ "type": "string"+ },+ "basic_encoded": {+ "type": "string"+ },+ "username": {+ "type": "string"+ },+ "password": {+ "type": "string"+ },+ "token": {+ "type": "string"+ },+ "oauth_token": {+ "type": "string"+ },+ "oauth_token_secret": {+ "type": "string"+ },+ "oauth_verifier": {+ "type": "string"+ },+ "consumer_key": {+ "type": "string"+ },+ "redirectUrl": {+ "type": "string"+ },+ "callback_url": {+ "type": "string"+ },+ "application_id": {+ "type": "string"+ },+ "installation_id": {+ "type": "string"+ },+ "private_key": {+ "type": "string"+ },+ "credentials_json": {+ "type": "string"+ },+ "expires_at": {+ "type": "string"}},"required": [- "id",- "connected_account_id",- "trigger_name",- "connected_account_uuid",- "user_id",- "version",- "trigger_config",- "state",- "updated_at",- "disabled_at",- "disabledAt",- "connectedAccountId",- "triggerName",- "updatedAt",- "triggerConfig"- ]+ "access_token"+ ],+ "additionalProperties": {}}},- "next_cursor": {- "type": "string",- "nullable": true+ "required": [+ "authScheme",+ "toolkitSlug",+ "val"+ ],+ "additionalProperties": true+ }+ },+ "required": [+ "endpoint",+ "method"+ ]+ }+ }+ }+ },+ "responses": {+ "200": {+ "description": "Successfully executed proxy request and received response",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "data": {+ "nullable": true,+ "description": "The response data returned from the proxied API",+ "example": {+ "id": "123",+ "name": "Resource Name",+ "created_at": "2023-01-01T00:00:00Z"+ },+ "type": "object"},- "total_pages": {- "type": "number"+ "binary_data": {+ "type": "object",+ "properties": {+ "url": {+ "type": "string",+ "description": "URL to download binary content"+ },+ "content_type": {+ "type": "string",+ "description": "Content-Type of the binary data"+ },+ "size": {+ "type": "number",+ "description": "File size in bytes"+ },+ "expires_at": {+ "type": "string",+ "description": "ISO 8601 timestamp when the URL expires"+ }+ },+ "required": [+ "url",+ "content_type",+ "size"+ ],+ "description": "Binary body response data. Present when the response is a binary file."},- "current_page": {- "type": "number"+ "status": {+ "type": "number",+ "description": "The HTTP status code returned from the proxied API",+ "example": 200},- "total_items": {- "type": "number"+ "headers": {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ },+ "description": "The HTTP headers returned from the proxied API",+ "example": {+ "content-type": "application/json",+ "cache-control": "no-cache",+ "host": "api.example.com"+ }}},"required": [- "items",- "total_pages",- "current_page",- "total_items"+ "status"]}}}},"400": {- "description": "Bad request",+ "description": "Bad request - Invalid request parameters or body format","content": {"application/json": {"schema": {@@ -9257,7 +10217,7 @@}},"401": {- "description": "Unauthorized",+ "description": "Unauthorized - Authentication credentials are missing or invalid","content": {"application/json": {"schema": {@@ -9266,8 +10226,8 @@}}},- "500": {- "description": "Internal server error",+ "403": {+ "description": "Forbidden - Connected account does not have permission to access the requested resource","content": {"application/json": {"schema": {@@ -9275,62 +10235,19 @@}}}- }- }- }- },- "/api/v3/trigger_instances/manage/{triggerId}": {- "delete": {- "summary": "Delete a trigger",- "description": "Permanently deletes a trigger instance. This stops the trigger from listening for events and removes it from your project. Use the PATCH endpoint with status \"disable\" if you want to temporarily pause a trigger instead.",- "tags": [- "Triggers"- ],- "operationId": "deleteTriggerInstancesManageByTriggerId",- "security": [- {- "ApiKeyAuth": []},- {- "UserApiKeyAuth": []- }- ],- "parameters": [- {- "schema": {- "type": "string",- "format": "triggerInstanceId",- "description": "The ID of the trigger instance to delete"- },- "required": true,- "description": "The ID of the trigger instance to delete",- "name": "triggerId",- "in": "path"- }- ],- "responses": {- "200": {- "description": "Successfully deleted the trigger instance",+ "404": {+ "description": "Not found - Resource not found or connected account not found","content": {"application/json": {"schema": {- "type": "object",- "properties": {- "trigger_id": {- "type": "string",- "format": "triggerInstanceId",- "description": "The ID of the deleted trigger instance"- }- },- "required": [- "trigger_id"- ]+ "$ref": "#/components/schemas/Error"}}}},- "400": {- "description": "Bad request",+ "422": {+ "description": "Unprocessable entity - Invalid state of the connected account","content": {"application/json": {"schema": {@@ -9339,8 +10256,8 @@}}},- "401": {- "description": "Unauthorized",+ "429": {+ "description": "Too many requests - Rate limit exceeded on the connected account or proxy service","content": {"application/json": {"schema": {@@ -9349,8 +10266,8 @@}}},- "404": {- "description": "Trigger instance not found",+ "500": {+ "description": "Internal server error - Something went wrong on the server","content": {"application/json": {"schema": {@@ -9359,8 +10276,8 @@}}},- "409": {- "description": "Trigger instance already deleted",+ "501": {+ "description": "Not implemented - This operation is not supported for the requested connected account or authentication scheme","content": {"application/json": {"schema": {@@ -9369,8 +10286,8 @@}}},- "410": {- "description": "Trigger instance already gone",+ "502": {+ "description": "Bad gateway - Error communicating with the upstream API","content": {"application/json": {"schema": {@@ -9379,8 +10296,8 @@}}},- "500": {- "description": "Internal server error",+ "504": {+ "description": "Gateway timeout - Upstream API timed out","content": {"application/json": {"schema": {@@ -9390,14 +10307,16 @@}}}- },- "patch": {- "summary": "Enable or disable a trigger",- "description": "Updates the status of a trigger instance to enable or disable it. Disabling a trigger pauses event listening without deleting the trigger configuration. Re-enabling restores the trigger to its active state. Use this for temporary maintenance or to control trigger execution.",+ }+ },+ "/api/v3/trigger_instances/{slug}/upsert": {+ "post": {+ "summary": "Create or update a trigger",+ "description": "Creates a new trigger instance or updates an existing one with the same configuration. Triggers listen for events from external services (webhooks or polling) and can invoke your workflows. If a matching trigger already exists and is disabled, it will be re-enabled. Requires a connected account ID to associate the trigger with a specific user connection.","tags": ["Triggers"],- "operationId": "patchTriggerInstancesManageByTriggerId",+ "operationId": "postTriggerInstancesBySlugUpsert","security": [{"ApiKeyAuth": []@@ -9410,12 +10329,11 @@{"schema": {"type": "string",- "format": "triggerInstanceId",- "description": "The ID of the trigger instance to update"+ "description": "The slug of the trigger instance. Case-insensitive (internally normalized to uppercase)."},"required": true,- "description": "The ID of the trigger instance to update",- "name": "triggerId",+ "description": "The slug of the trigger instance. Case-insensitive (internally normalized to uppercase).",+ "name": "slug","in": "path"}],@@ -9425,46 +10343,136 @@"schema": {"type": "object","properties": {- "status": {+ "connectedAuthId": {"type": "string",- "enum": [- "enable",- "disable"- ]+ "format": "connectedAccountId",+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use connected_account_id instead.",+ "deprecated": true+ },+ "triggerConfig": {+ "type": "object",+ "additionalProperties": {},+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use trigger_config instead.",+ "deprecated": true+ },+ "connected_account_id": {+ "type": "string",+ "format": "connectedAccountId",+ "description": "Connected account nanoid"+ },+ "trigger_config": {+ "type": "object",+ "additionalProperties": {},+ "description": "Trigger configuration"+ },+ "version": {+ "type": "string",+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use toolkit_versions instead.",+ "deprecated": true,+ "example": "latest"+ },+ "toolkit_versions": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ }+ },+ {+ "nullable": true,+ "type": "object"+ }+ ],+ "description": "Toolkit version specification. Supports \"latest\" string or a record mapping toolkit slugs to specific versions.",+ "example": "latest"}- },- "required": [- "status"- ]+ }}}}},"responses": {"200": {- "description": "Successfully updated trigger status",+ "description": "Successfully upserted trigger instance","content": {"application/json": {"schema": {"type": "object","properties": {- "status": {+ "trigger_id": {"type": "string",- "enum": [- "success"- ],- "description": "Status of the operation"+ "description": "ID of the updated trigger"+ },+ "deprecated": {+ "type": "object",+ "properties": {+ "uuid": {+ "type": "string",+ "description": "ID of the updated trigger"+ }+ },+ "required": [+ "uuid"+ ]}},"required": [- "status"+ "trigger_id",+ "deprecated"+ ]+ }+ }+ }+ },+ "201": {+ "description": "Successfully created trigger instance",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "trigger_id": {+ "type": "string",+ "description": "ID of the updated trigger"+ },+ "deprecated": {+ "type": "object",+ "properties": {+ "uuid": {+ "type": "string",+ "description": "ID of the updated trigger"+ }+ },+ "required": [+ "uuid"+ ]+ }+ },+ "required": [+ "trigger_id",+ "deprecated"]}}}},+ "204": {+ "description": "No content",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {}+ }+ }+ }+ },"400": {- "description": "Bad Request",+ "description": "Bad request","content": {"application/json": {"schema": {@@ -9493,8 +10501,18 @@}}},+ "408": {+ "description": "Request timeout",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },"409": {- "description": "Trigger instance already enabled/disabled",+ "description": "Conflict","content": {"application/json": {"schema": {@@ -9504,7 +10522,17 @@}},"410": {- "description": "Trigger instance already gone",+ "description": "Gone",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "422": {+ "description": "Unprocessable entity","content": {"application/json": {"schema": {@@ -9514,7 +10542,7 @@}},"500": {- "description": "Internal Server Error",+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -9536,14 +10564,14 @@}}},- "/api/v3/triggers_types/list/enum": {+ "/api/v3/trigger_instances/active": {"get": {- "summary": "List trigger type enums",- "description": "Retrieves a list of all available trigger type enum values that can be used across the API from latest versions of the toolkit only",+ "summary": "List active triggers",+ "description": "Retrieves all active trigger instances for your project. Triggers listen for events from connected accounts (e.g., new emails, Slack messages, GitHub commits) and can invoke webhooks or workflows. Use filters to find triggers for specific users, connected accounts, or trigger types.","tags": ["Triggers"],- "operationId": "getTriggersTypesListEnum",+ "operationId": "getTriggerInstancesActive","security": [{"ApiKeyAuth": []@@ -9552,367 +10580,194 @@"UserApiKeyAuth": []}],- "responses": {- "200": {- "description": "Successfully retrieved trigger enum list",- "content": {- "application/json": {- "schema": {- "type": "array",- "items": {- "type": "string"- },- "description": "JSON string containing all trigger enum values"- }- }- }- },- "400": {- "description": "Bad request",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }+ "parameters": [+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string"+ },+ "description": "Array of user IDs to filter triggers by"+ },+ "required": false,+ "description": "Array of user IDs to filter triggers by",+ "name": "user_ids",+ "in": "query"},- "401": {- "description": "Unauthorized",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string",+ "format": "connectedAccountId"+ },+ "description": "Array of connected account IDs to filter triggers by"+ },+ "required": false,+ "description": "Array of connected account IDs to filter triggers by",+ "name": "connected_account_ids",+ "in": "query"},- "404": {- "description": "Not found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string",+ "format": "authConfigId"+ },+ "description": "Array of auth config IDs to filter triggers by"+ },+ "required": false,+ "description": "Array of auth config IDs to filter triggers by",+ "name": "auth_config_ids",+ "in": "query"+ },+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string",+ "format": "triggerInstanceId"+ },+ "description": "Array of trigger IDs to filter triggers by"+ },+ "required": false,+ "description": "Array of trigger IDs to filter triggers by",+ "name": "trigger_ids",+ "in": "query"+ },+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string"+ },+ "description": "Array of trigger names to filter triggers by. Case-insensitive (internally normalized to uppercase)."+ },+ "required": false,+ "description": "Array of trigger names to filter triggers by. Case-insensitive (internally normalized to uppercase).",+ "name": "trigger_names",+ "in": "query"+ },+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string",+ "format": "connectedAccountId"}- }+ },+ "required": false,+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use connected_account_ids instead.",+ "deprecated": true,+ "name": "connectedAccountIds",+ "in": "query"},- "500": {- "description": "Internal server error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string",+ "format": "authConfigId"}- }- }- }- }- },- "/api/v3/triggers_types/{slug}": {- "get": {- "summary": "Get trigger type by slug",- "description": "Retrieve detailed information about a specific trigger type using its slug identifier",- "tags": [- "Triggers"- ],- "operationId": "getTriggersTypesBySlug",- "security": [+ },+ "required": false,+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use auth_config_ids instead.",+ "deprecated": true,+ "name": "authConfigIds",+ "in": "query"+ },{- "ApiKeyAuth": []+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string",+ "format": "triggerInstanceId"+ }+ },+ "required": false,+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use trigger_ids instead.",+ "deprecated": true,+ "name": "triggerIds",+ "in": "query"},{- "UserApiKeyAuth": []- }- ],- "parameters": [+ "schema": {+ "type": "boolean",+ "nullable": true,+ "default": false,+ "description": "When set to true, includes disabled triggers in the response."+ },+ "required": false,+ "description": "When set to true, includes disabled triggers in the response.",+ "name": "show_disabled",+ "in": "query"+ },{"schema": {- "type": "string",- "description": "The unique slug identifier for the trigger type. Case-insensitive (internally normalized to uppercase).",- "example": "SLACK_NEW_MESSAGE"+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string"+ }},- "required": true,- "description": "The unique slug identifier for the trigger type. Case-insensitive (internally normalized to uppercase).",- "name": "slug",- "in": "path"+ "required": false,+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use trigger_names instead.",+ "deprecated": true,+ "name": "triggerNames",+ "in": "query"},{"schema": {- "oneOf": [- {- "type": "null"- },- {- "type": "string"- },- {- "type": "object",- "additionalProperties": {- "type": "string"- },- "description": "Object representation of parsed bracket notation"- }- ]+ "type": "boolean",+ "nullable": true,+ "default": false,+ "description": "DEPRECATED: Use show_disabled instead"},"required": false,- "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",- "in": "query",- "name": "toolkit_versions",- "examples": {- "latest_version": {- "summary": "Latest version for all toolkits",- "value": "latest"+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use show_disabled instead.",+ "deprecated": true,+ "name": "showDisabled",+ "in": "query"+ },+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string"},- "bracket_notation": {- "summary": "Specific versions using bracket notation",- "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"+ "description": "Array of connected account UUIDs to filter triggers by"+ },+ "required": false,+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use connected_account_ids instead.",+ "deprecated": true,+ "name": "deprecatedConnectedAccountUuids",+ "in": "query"+ },+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string"},- "null_value": {- "summary": "No version specified (uses latest)",- "value": null- }- }- }- ],- "responses": {- "200": {- "description": "Successfully retrieved trigger type",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "description": "Unique identifier for the trigger type",- "example": "SLACK_NEW_MESSAGE"- },- "name": {- "type": "string",- "description": "Human-readable name of the trigger",- "example": "New Message in Slack Channel"- },- "description": {- "type": "string",- "description": "Detailed description of what the trigger does",- "example": "Triggers when a new message is posted to a Slack channel"- },- "instructions": {- "type": "string",- "description": "Step-by-step instructions on how to set up and use this trigger"- },- "type": {- "type": "string",- "enum": [- "webhook",- "poll"- ],- "description": "The trigger mechanism - either webhook (event-based) or poll (scheduled check)",- "example": "webhook"- },- "toolkit": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "description": "Unique identifier for the parent toolkit",- "example": "slack"- },- "name": {- "type": "string",- "description": "Deprecated: Use slug instead",- "example": "Slack"- },- "logo": {- "type": "string",- "description": "Logo of the toolkit",- "example": "https://example.com/logo.png"- }- },- "required": [- "slug",- "name",- "logo"- ],- "description": "Information about the toolkit that provides this trigger"- },- "config": {- "type": "object",- "additionalProperties": {},- "description": "Configuration schema required to set up this trigger",- "example": {- "channel_id": {- "type": "string",- "required": true- },- "message_type": {- "type": "enum",- "options": [- "all",- "direct",- "channel"- ]- }- }- },- "payload": {- "type": "object",- "additionalProperties": {},- "description": "Schema of the data payload this trigger will deliver when it fires",- "example": {- "message": {- "type": "string"- },- "sender": {- "type": "object",- "properties": {- "id": "string",- "name": "string"- }- },- "timestamp": {- "type": "number"- }- }- },- "version": {- "type": "string",- "description": "Version of the trigger type",- "example": "20250930_00"- }- },- "required": [- "slug",- "name",- "description",- "instructions",- "type",- "toolkit",- "config",- "payload",- "version"- ]- }- }- }- },- "400": {- "description": "Bad request",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "401": {- "description": "Unauthorized",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "404": {- "description": "Not found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "500": {- "description": "Internal server error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- }- }- }- },- "/api/v3/triggers_types": {- "get": {- "summary": "List trigger types",- "description": "Retrieve a list of available trigger types with optional filtering by toolkit. Results are paginated and can be filtered by toolkit.",- "tags": [- "Triggers"- ],- "operationId": "getTriggersTypes",- "security": [- {- "ApiKeyAuth": []- },- {- "UserApiKeyAuth": []- }- ],- "parameters": [- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string"- },- "description": "Array of toolkit slugs to filter triggers by",- "example": [- "slack",- "github"- ]+ "description": "Array of auth config UUIDs to filter triggers by"},"required": false,- "description": "Array of toolkit slugs to filter triggers by",- "name": "toolkit_slugs",+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use auth_config_ids instead.",+ "deprecated": true,+ "name": "deprecatedAuthConfigUuids","in": "query"},- {- "schema": {- "oneOf": [- {- "type": "null"- },- {- "type": "string"- },- {- "type": "object",- "additionalProperties": {- "type": "string"- },- "description": "Object representation of parsed bracket notation"- }- ]- },- "required": false,- "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",- "in": "query",- "name": "toolkit_versions",- "examples": {- "latest_version": {- "summary": "Latest version for all toolkits",- "value": "latest"- },- "bracket_notation": {- "summary": "Specific versions using bracket notation",- "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"- },- "null_value": {- "summary": "No version specified (uses latest)",- "value": null- }- }- },{"schema": {"type": "number",@@ -9935,7 +10790,7 @@],"responses": {"200": {- "description": "Successfully retrieved triggers",+ "description": "Successfully retrieved active trigger instances","content": {"application/json": {"schema": {@@ -9946,115 +10801,116 @@"items": {"type": "object","properties": {- "slug": {+ "uuid": {"type": "string",- "description": "Unique identifier for the trigger type",- "example": "SLACK_NEW_MESSAGE"+ "description": "Unique identifier of the trigger instance"},- "name": {+ "id": {"type": "string",- "description": "Human-readable name of the trigger",- "example": "New Message in Slack Channel"+ "format": "triggerInstanceId",+ "description": "Nano ID of the trigger instance"},- "description": {+ "connected_account_id": {"type": "string",- "description": "Detailed description of what the trigger does",- "example": "Triggers when a new message is posted to a Slack channel"+ "description": "ID of the connected account this trigger is associated with"},- "instructions": {+ "trigger_name": {"type": "string",- "description": "Step-by-step instructions on how to set up and use this trigger"+ "description": "Name of the trigger"},- "type": {+ "connected_account_uuid": {"type": "string",- "enum": [- "webhook",- "poll"- ],- "description": "The trigger mechanism - either webhook (event-based) or poll (scheduled check)",- "example": "webhook"+ "description": "UUID of the connected account this trigger is associated with"},- "toolkit": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "description": "Unique identifier for the parent toolkit",- "example": "slack"- },- "name": {- "type": "string",- "description": "Deprecated: Use slug instead",- "example": "Slack"- },- "logo": {- "type": "string",- "description": "Logo of the toolkit",- "example": "https://example.com/logo.png"- }- },- "required": [- "slug",- "name",- "logo"- ],- "description": "Information about the toolkit that provides this trigger"+ "user_id": {+ "type": "string",+ "description": "ID of the user this trigger is associated with"},- "config": {+ "trigger_data": {+ "type": "string",+ "description": "Additional data associated with the trigger instance"+ },+ "version": {+ "type": "string",+ "description": "Version of the trigger instance"+ },+ "trigger_config": {"type": "object","additionalProperties": {},- "description": "Configuration schema required to set up this trigger",- "example": {- "channel_id": {- "type": "string",- "required": true- },- "message_type": {- "type": "enum",- "options": [- "all",- "direct",- "channel"- ]- }- }+ "description": "Configuration for the trigger"},- "payload": {+ "state": {"type": "object","additionalProperties": {},- "description": "Schema of the data payload this trigger will deliver when it fires",- "example": {- "message": {- "type": "string"- },- "sender": {- "type": "object",- "properties": {- "id": "string",- "name": "string"- }- },- "timestamp": {- "type": "number"- }- }+ "description": "DEPRECATED: This field exposes internal state and will be removed in a future version.",+ "deprecated": true},- "version": {+ "updated_at": {"type": "string",- "description": "Version of the trigger type",- "example": "20250930_00"+ "description": "ISO 8601 timestamp when the trigger instance was updated"+ },+ "disabled_at": {+ "type": "string",+ "nullable": true,+ "description": "ISO 8601 timestamp when the trigger instance was disabled, if applicable"+ },+ "disabledAt": {+ "type": "string",+ "nullable": true,+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use disabled_at instead.",+ "deprecated": true+ },+ "connectedAccountId": {+ "type": "string",+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use connected_account_id instead.",+ "deprecated": true+ },+ "triggerName": {+ "type": "string",+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use trigger_name instead.",+ "deprecated": true+ },+ "updatedAt": {+ "type": "string",+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use updated_at instead.",+ "deprecated": true+ },+ "triggerConfig": {+ "type": "object",+ "additionalProperties": {},+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use trigger_config instead.",+ "deprecated": true+ },+ "deprecated": {+ "type": "object",+ "properties": {+ "createdAt": {+ "type": "string",+ "description": "Deprecated created_at for the trigger instance"+ }+ },+ "required": [+ "createdAt"+ ],+ "description": "Deprecated fields for the trigger instance"}},"required": [- "slug",- "name",- "description",- "instructions",- "type",- "toolkit",- "config",- "payload",- "version"+ "id",+ "connected_account_id",+ "trigger_name",+ "connected_account_uuid",+ "user_id",+ "version",+ "trigger_config",+ "state",+ "updated_at",+ "disabled_at",+ "disabledAt",+ "connectedAccountId",+ "triggerName",+ "updatedAt",+ "triggerConfig"]}},@@ -10102,16 +10958,6 @@}}},- "404": {- "description": "Not found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },"500": {"description": "Internal server error","content": {@@ -10125,14 +10971,14 @@}}},- "/api/v3/mcp/servers": {- "get": {- "summary": "List MCP servers with optional filters and pagination",- "description": "Retrieves a paginated list of MCP servers associated with the authenticated project. Results can be filtered by name, toolkit, or authentication configuration ID. MCP servers are used to provide Model Control Protocol integration points for connecting AI assistants to your applications and services.",+ "/api/v3/trigger_instances/manage/{triggerId}": {+ "delete": {+ "summary": "Delete a trigger",+ "description": "Permanently deletes a trigger instance. This stops the trigger from listening for events and removes it from your project. Use the PATCH endpoint with status \"disable\" if you want to temporarily pause a trigger instead.","tags": [- "MCP"+ "Triggers"],- "operationId": "getMcpServers",+ "operationId": "deleteTriggerInstancesManageByTriggerId","security": [{"ApiKeyAuth": []@@ -10145,293 +10991,58 @@{"schema": {"type": "string",- "description": "Name substring to filter servers by",- "example": "github"+ "format": "triggerInstanceId",+ "description": "The ID of the trigger instance to delete"},- "required": false,- "description": "Filter MCP servers by name (case-insensitive partial match)",- "name": "name",- "in": "query"+ "required": true,+ "description": "The ID of the trigger instance to delete",+ "name": "triggerId",+ "in": "path"+ }+ ],+ "responses": {+ "200": {+ "description": "Successfully deleted the trigger instance",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "trigger_id": {+ "type": "string",+ "format": "triggerInstanceId",+ "description": "The ID of the deleted trigger instance"+ }+ },+ "required": [+ "trigger_id"+ ]+ }+ }+ }},- {- "schema": {- "type": "string"- },- "required": false,- "description": "Comma-separated list of toolkit slugs to filter servers by",- "in": "query",- "name": "toolkits"+ "400": {+ "description": "Bad request",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }},- {- "schema": {- "type": "string"- },- "required": false,- "description": "Comma-separated list of auth config IDs to filter servers by",- "in": "query",- "name": "auth_config_ids"+ "401": {+ "description": "Unauthorized",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }},- {- "schema": {- "type": "string",- "enum": [- "created_at",- "updated_at"- ],- "default": "updated_at",- "description": "Field to use for ordering the results",- "example": "updated_at"- },- "required": false,- "description": "Field to order results by",- "name": "order_by",- "in": "query"- },- {- "schema": {- "type": "string",- "enum": [- "asc",- "desc"- ],- "default": "desc",- "description": "Sort direction (ascending or descending)",- "example": "desc"- },- "required": false,- "description": "Direction of ordering",- "name": "order_direction",- "in": "query"- },- {- "schema": {- "type": "number",- "nullable": true,- "default": 1,- "description": "Page number to retrieve",- "example": 1- },- "required": false,- "description": "Page number for pagination (1-based)",- "name": "page_no",- "in": "query"- },- {- "schema": {- "type": "number",- "nullable": true,- "default": 10,- "description": "Number of servers to return per page",- "example": 10- },- "required": false,- "description": "Number of items per page (default: 10)",- "name": "limit",- "in": "query"- }- ],- "responses": {- "200": {- "description": "Successfully retrieved MCP servers. Returns a paginated list of server configurations including connection details and command instructions.",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "items": {- "type": "array",- "items": {- "type": "object",- "properties": {- "id": {- "type": "string",- "description": "UUID of the MCP server instance",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "name": {- "type": "string",- "description": "User-defined descriptive name for this MCP server",- "example": "GitHub Integration Server"- },- "auth_config_ids": {- "type": "array",- "items": {- "type": "string"- },- "description": "ID references to the auth configurations used by this server",- "example": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ]- },- "allowed_tools": {- "type": "array",- "items": {- "type": "string"- },- "description": "Array of tool slugs that this MCP server is allowed to use",- "example": [- "github-issues",- "github-repos",- "github-pull-requests"- ]- },- "mcp_url": {- "type": "string",- "description": "[DEPRECATED] Please use the URL with user_id or connected_account_id query param",- "deprecated": true,- "example": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"- },- "toolkits": {- "type": "array",- "items": {- "type": "string"- },- "description": "Array of toolkit slugs that this MCP server is allowed to use",- "example": [- "github",- "jira",- "slack"- ]- },- "toolkit_icons": {- "type": "object",- "additionalProperties": {- "type": "string"- },- "description": "Object mapping each toolkit slug to its icon/logo URL for display purposes",- "example": {- "github": "https://assets.composio.dev/logos/github.png",- "jira": "https://assets.composio.dev/logos/jira.png",- "slack": "https://assets.composio.dev/logos/slack.png"- }- },- "commands": {- "type": "object",- "properties": {- "cursor": {- "type": "string",- "description": "Command line instruction for Cursor client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor"- },- "claude": {- "type": "string",- "description": "Command line instruction for Claude client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude"- },- "windsurf": {- "type": "string",- "description": "Command line instruction for Windsurf client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"- }- },- "required": [- "cursor",- "claude",- "windsurf"- ],- "description": "Set of command line instructions for connecting various clients to this MCP server",- "deprecated": true- },- "updated_at": {- "type": "string",- "description": "Date and time when this server configuration was last modified",- "example": "2023-06-15T14:30:00.000Z"- },- "created_at": {- "type": "string",- "description": "Date and time when this server was initially created",- "example": "2023-06-10T09:15:00.000Z"- },- "server_instance_count": {- "type": "number",- "description": "Total count of active user instances connected to this server",- "example": 5- },- "managed_auth_via_composio": {- "type": "boolean",- "description": "Whether the MCP server is managed by Composio",- "example": true- }- },- "required": [- "id",- "name",- "auth_config_ids",- "allowed_tools",- "mcp_url",- "toolkits",- "toolkit_icons",- "commands",- "updated_at",- "created_at",- "server_instance_count",- "managed_auth_via_composio"- ],- "description": "MCP server configuration and connection details"- },- "description": "Array of MCP server configurations",- "example": [- {- "id": "550e8400-e29b-41d4-a716-446655440000",- "name": "GitHub Integration Server",- "auth_config_ids": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ],- "allowed_tools": [- "github-issues",- "github-repos"- ],- "mcp_url": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john",- "commands": {- "cursor": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor",- "claude": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude",- "windsurf": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"- },- "toolkits": [- "github",- "jira",- "slack"- ],- "toolkit_icons": {- "github": "https://assets.composio.dev/logos/github.png",- "jira": "https://assets.composio.dev/logos/jira.png",- "slack": "https://assets.composio.dev/logos/slack.png"- },- "updated_at": "2023-06-15T14:30:00.000Z",- "created_at": "2023-06-10T09:15:00.000Z",- "server_instance_count": 5,- "managed_auth_via_composio": true- }- ]- },- "total_pages": {- "type": "number",- "description": "Total number of pages in the paginated response",- "example": 5- },- "current_page": {- "type": "number",- "description": "Current page number being returned",- "example": 1- }- },- "required": [- "items",- "total_pages",- "current_page"- ],- "description": "Paginated response containing MCP servers"- }- }- }- },- "400": {- "description": "Bad request. The query parameters may be invalid or in an incorrect format.",+ "404": {+ "description": "Trigger instance not found","content": {"application/json": {"schema": {@@ -10440,8 +11051,8 @@}}},- "401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "409": {+ "description": "Trigger instance already deleted","content": {"application/json": {"schema": {@@ -10450,8 +11061,8 @@}}},- "403": {- "description": "Forbidden. The authenticated user does not have permission to view MCP servers for this project.",+ "410": {+ "description": "Trigger instance already gone","content": {"application/json": {"schema": {@@ -10461,7 +11072,7 @@}},"500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -10472,13 +11083,13 @@}}},- "post": {- "summary": "Create a new MCP server",- "description": "Creates a new Model Control Protocol (MCP) server instance for the authenticated project. An MCP server provides a connection point for AI assistants to access your applications and services. The server is configured with specific authentication and tool permissions that determine what actions the connected assistants can perform.",- "tags": [- "MCP"+ "patch": {+ "summary": "Enable or disable a trigger",+ "description": "Updates the status of a trigger instance to enable or disable it. Disabling a trigger pauses event listening without deleting the trigger configuration. Re-enabling restores the trigger to its active state. Use this for temporary maintenance or to control trigger execution.",+ "tags": [+ "Triggers"],- "operationId": "postMcpServers",+ "operationId": "patchTriggerInstancesManageByTriggerId","security": [{"ApiKeyAuth": []@@ -10487,243 +11098,65 @@"UserApiKeyAuth": []}],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "format": "triggerInstanceId",+ "description": "The ID of the trigger instance to update"+ },+ "required": true,+ "description": "The ID of the trigger instance to update",+ "name": "triggerId",+ "in": "path"+ }+ ],"requestBody": {"content": {"application/json": {"schema": {"type": "object","properties": {- "name": {+ "status": {"type": "string",- "minLength": 4,- "maxLength": 30,- "pattern": "^[a-zA-Z0-9- ]+$",- "description": "Human-readable name to identify this MCP server instance (4-30 characters, alphanumeric, spaces, and hyphens only)",- "example": "Production GitHub Integration"- },- "auth_config_ids": {- "type": "array",- "items": {- "type": "string"- },- "description": "ID references to existing authentication configurations",- "example": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ]- },- "no_auth_apps": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of NO_AUTH apps to enable for this MCP server",- "example": [- "exa",- "codeinterpreter",- "composio",- "composio_search"- ]- },- "allowed_tools": {- "type": "array",- "items": {- "type": "string"- },- "default": [],- "description": "List of tool slugs that should be allowed for this server. If not provided, all available tools for the authentication configuration will be enabled.",- "example": [- "github-issues",- "github-repos",- "github-pull-requests"+ "enum": [+ "enable",+ "disable"]- },- "managed_auth_via_composio": {- "type": "boolean",- "description": "Whether the MCP server is managed by Composio"}},"required": [- "name",- "auth_config_ids"- ],- "description": "Request parameters for creating a new MCP server with specific authentication configuration"- },- "examples": {- "Basic MCP Server": {- "value": {- "name": "GitHub Integration Server",- "auth_config_ids": [- "auth_cfg_abc123def456"- ]- }- },- "Server with Limited Tools": {- "value": {- "name": "GitHub Issues Only",- "auth_config_ids": [- "auth_cfg_abc123def456"- ],- "allowed_tools": [- "GMAIL_ADD_LABEL_TO_EMAIL"- ]- }- },- "Server with Expiration": {- "value": {- "name": "Temporary Integration Server",- "auth_config_ids": [- "auth_cfg_abc123def456"- ]- }- }+ "status"+ ]}}}},"responses": {- "201": {- "description": "MCP server created successfully. Returns the complete server configuration including connection details and command instructions.",+ "200": {+ "description": "Successfully updated trigger status","content": {"application/json": {"schema": {"type": "object","properties": {- "id": {- "type": "string",- "description": "UUID of the MCP server instance",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "name": {- "type": "string",- "description": "User-defined descriptive name for this MCP server",- "example": "GitHub Integration Server"- },- "auth_config_ids": {- "type": "array",- "items": {- "type": "string"- },- "description": "ID references to the auth configurations used by this server",- "example": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ]- },- "allowed_tools": {- "type": "array",- "items": {- "type": "string"- },- "description": "Array of tool slugs that this MCP server is allowed to use",- "example": [- "github-issues",- "github-repos",- "github-pull-requests"- ]- },- "mcp_url": {+ "status": {"type": "string",- "description": "[DEPRECATED] Please use the URL with user_id or connected_account_id query param",- "deprecated": true,- "example": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"- },- "toolkits": {- "type": "array",- "items": {- "type": "string"- },- "description": "Array of toolkit slugs that this MCP server is allowed to use",- "example": [- "github",- "jira",- "slack"- ]- },- "toolkit_icons": {- "type": "object",- "additionalProperties": {- "type": "string"- },- "description": "Object mapping each toolkit slug to its icon/logo URL for display purposes",- "example": {- "github": "https://assets.composio.dev/logos/github.png",- "jira": "https://assets.composio.dev/logos/jira.png",- "slack": "https://assets.composio.dev/logos/slack.png"- }- },- "commands": {- "type": "object",- "properties": {- "cursor": {- "type": "string",- "description": "Command line instruction for Cursor client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor"- },- "claude": {- "type": "string",- "description": "Command line instruction for Claude client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude"- },- "windsurf": {- "type": "string",- "description": "Command line instruction for Windsurf client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"- }- },- "required": [- "cursor",- "claude",- "windsurf"+ "enum": [+ "success"],- "description": "Set of command line instructions for connecting various clients to this MCP server",- "deprecated": true- },- "updated_at": {- "type": "string",- "description": "Date and time when this server configuration was last modified",- "example": "2023-06-15T14:30:00.000Z"- },- "created_at": {- "type": "string",- "description": "Date and time when this server was initially created",- "example": "2023-06-10T09:15:00.000Z"- },- "server_instance_count": {- "type": "number",- "description": "Total count of active user instances connected to this server",- "example": 5- },- "managed_auth_via_composio": {- "type": "boolean",- "description": "Whether the MCP server is managed by Composio",- "example": true+ "description": "Status of the operation"}},"required": [- "id",- "name",- "auth_config_ids",- "allowed_tools",- "mcp_url",- "toolkits",- "toolkit_icons",- "commands",- "updated_at",- "created_at",- "server_instance_count",- "managed_auth_via_composio"- ],- "description": "MCP server configuration and connection details"+ "status"+ ]}}}},"400": {- "description": "Bad request. The request body may be invalid, missing required parameters, or the auth_config_id may not exist.",+ "description": "Bad Request","content": {"application/json": {"schema": {@@ -10733,7 +11166,7 @@}},"401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -10742,8 +11175,8 @@}}},- "403": {- "description": "Forbidden. The authenticated user does not have permission to create MCP servers for this project.",+ "404": {+ "description": "Trigger instance not found","content": {"application/json": {"schema": {@@ -10752,8 +11185,18 @@}}},- "404": {- "description": "Not Found. The specified auth_config_id does not exist or is not accessible to the authenticated user.",+ "409": {+ "description": "Trigger instance already enabled/disabled",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "410": {+ "description": "Trigger instance already gone","content": {"application/json": {"schema": {@@ -10763,7 +11206,7 @@}},"500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",+ "description": "Internal Server Error","content": {"application/json": {"schema": {@@ -10771,18 +11214,28 @@}}}- }- }- }- },- "/api/v3/mcp/servers/custom": {- "post": {- "summary": "Create a new custom MCP server with multiple apps",- "description": "Creates a new Model Control Protocol (MCP) server instance that can integrate with multiple applications or toolkits simultaneously. This endpoint allows you to create a server that can access tools from different applications, making it suitable for complex workflows that span multiple services.",+ },+ "501": {+ "description": "Not implemented",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ }+ }+ }+ },+ "/api/v3/triggers_types/list/enum": {+ "get": {+ "summary": "List trigger type enums",+ "description": "Retrieves a list of all available trigger type enum values that can be used across the API from latest versions of the toolkit only","tags": [- "MCP"+ "Triggers"],- "operationId": "postMcpServersCustom",+ "operationId": "getTriggersTypesListEnum","security": [{"ApiKeyAuth": []@@ -10791,191 +11244,23 @@"UserApiKeyAuth": []}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "name": {- "type": "string",- "minLength": 4,- "maxLength": 30,- "pattern": "^[a-zA-Z0-9- ]+$",- "description": "Human-readable name to identify this custom MCP server (4-30 characters, alphanumeric, spaces, and hyphens only)",- "example": "Multi App Integration Server"- },- "auth_config_ids": {- "type": "array",- "items": {- "type": "string"- },- "description": "ID references to existing authentication configurations",- "example": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ]- },- "toolkits": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of application/toolkit identifiers to enable for this server",- "example": [- "github",- "jira",- "slack"- ]- },- "allowed_tools": {- "type": "array",- "items": {- "type": "string"- },- "description": "Tool identifiers to enable that aren't part of standard toolkits",- "example": [- "custom-api-tool",- "internal-database-tool"- ]- },- "custom_tools": {- "type": "array",- "items": {- "type": "string"- },- "description": "DEPRECATED: Use allowed_tools instead. Tool identifiers to enable that aren't part of standard toolkits",- "example": [- "custom-api-tool",- "internal-database-tool"- ]- },- "managed_auth_via_composio": {- "type": "boolean",- "description": "Whether to manage authentication via Composio"- }- },- "required": [- "name"- ],- "description": "Parameters for creating a new custom MCP server with multiple applications"- },- "examples": {- "Basic Multi-App Server": {- "value": {- "name": "Development Integration Server",- "toolkits": [- "github",- "jira"- ]- }- },- "Advanced Multi-App Server": {- "value": {- "name": "Complete Workflow Integration",- "toolkits": [- "github",- "jira",- "slack"- ],- "custom_tools": [- "internal-api-tool"- ]- }- }- }- }- }- },"responses": {- "201": {- "description": "Custom MCP server created successfully. Returns the complete server configuration including connection details and command instructions for all specified applications.",+ "200": {+ "description": "Successfully retrieved trigger enum list","content": {"application/json": {"schema": {- "type": "object",- "properties": {- "id": {- "type": "string",- "description": "Unique identifier for the newly created custom MCP server",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "name": {- "type": "string",- "description": "Human-readable name of the custom MCP server",- "example": "Multi-App Integration Server"- },- "auth_config_ids": {- "type": "array",- "items": {- "type": "string"- },- "description": "ID references to the auth configurations used by this server",- "example": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ]- },- "allowed_tools": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of tool identifiers that are enabled for this server",- "example": [- "github-issues",- "jira-tickets",- "slack-messages",- "custom-api-tool"- ]- },- "mcp_url": {- "type": "string",- "description": "URL endpoint for establishing connection to this MCP server",- "example": "https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john"- },- "commands": {- "type": "object",- "properties": {- "cursor": {- "type": "string",- "description": "Command line instruction for Cursor client setup",- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client cursor"- },- "claude": {- "type": "string",- "description": "Command line instruction for Claude client setup",- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client claude"- },- "windsurf": {- "type": "string",- "description": "Command line instruction for Windsurf client setup",- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"- }- },- "required": [- "cursor",- "claude",- "windsurf"- ],- "description": "Set of command line instructions for connecting various clients to this MCP server"- }+ "type": "array",+ "items": {+ "type": "string"},- "required": [- "id",- "name",- "auth_config_ids",- "allowed_tools",- "mcp_url",- "commands"- ],- "description": "Response for a successfully created custom MCP server with multiple applications"+ "description": "JSON string containing all trigger enum values"}}}},"400": {- "description": "Bad request. The request body may be invalid, missing required parameters, or contain invalid toolkit identifiers.",+ "description": "Bad request","content": {"application/json": {"schema": {@@ -10985,7 +11270,7 @@}},"401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -10994,8 +11279,8 @@}}},- "403": {- "description": "Forbidden. The authenticated user does not have permission to create MCP servers for this project.",+ "404": {+ "description": "Not found","content": {"application/json": {"schema": {@@ -11005,7 +11290,7 @@}},"500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -11017,14 +11302,14 @@}}},- "/api/v3/mcp/servers/generate": {- "post": {- "summary": "Generate MCP URL with custom parameters",- "description": "Generates a Model Control Protocol (MCP) URL for an existing server with custom query parameters. The URL includes user-specific parameters and configuration flags that control the behavior of the MCP connection.",+ "/api/v3/triggers_types/{slug}": {+ "get": {+ "summary": "Get trigger type by slug",+ "description": "Retrieve detailed information about a specific trigger type using its slug identifier","tags": [- "MCP"+ "Triggers"],- "operationId": "postMcpServersGenerate",+ "operationId": "getTriggersTypesBySlug","security": [{"ApiKeyAuth": []@@ -11033,131 +11318,180 @@"UserApiKeyAuth": []}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "mcp_server_id": {- "type": "string",- "description": "Unique identifier of the MCP server to generate URL for",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "managed_auth_by_composio": {- "type": "boolean",- "default": false,- "description": "Flag indicating if Composio manages authentication",- "example": true+ "parameters": [+ {+ "schema": {+ "type": "string",+ "description": "The unique slug identifier for the trigger type. Case-insensitive (internally normalized to uppercase).",+ "example": "SLACK_RECEIVE_MESSAGE"+ },+ "required": true,+ "description": "The unique slug identifier for the trigger type. Case-insensitive (internally normalized to uppercase).",+ "name": "slug",+ "in": "path"+ },+ {+ "schema": {+ "oneOf": [+ {+ "type": "null"+ },+ {+ "type": "string"+ },+ {+ "type": "object",+ "additionalProperties": {+ "type": "string"},- "user_ids": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of user identifiers for whom the URL is generated",- "example": [- "user_123456",- "user_789012"- ]- },- "connected_account_ids": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of connected account identifiers",- "example": [- "account_1",- "account_2",- "account_3"- ]- }- },- "required": [- "mcp_server_id"- ],- "description": "Request parameters for generating an MCP URL"- },- "examples": {- "Basic URL Generation": {- "value": {- "mcp_server_id": "550e8400-e29b-41d4-a716-446655440000",- "user_ids": [- "user_123456"- ],- "connected_account_ids": [- "account_1",- "account_2"- ]- }- },- "Managed Auth Configuration": {- "value": {- "mcp_server_id": "550e8400-e29b-41d4-a716-446655440000",- "user_ids": [- "user_123456",- "user_789012"- ],- "connected_account_ids": [- "account_1",- "account_2",- "account_3"- ]- }+ "description": "Object representation of parsed bracket notation"}+ ]+ },+ "required": false,+ "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",+ "in": "query",+ "name": "toolkit_versions",+ "examples": {+ "latest_version": {+ "summary": "Latest version for all toolkits",+ "value": "latest"+ },+ "bracket_notation": {+ "summary": "Specific versions using bracket notation",+ "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"+ },+ "null_value": {+ "summary": "No version specified (uses latest)",+ "value": null}}}- },+ ],"responses": {"200": {- "description": "Successfully generated MCP URL. Returns the complete URL with all specified query parameters.",+ "description": "Successfully retrieved trigger type","content": {"application/json": {"schema": {"type": "object","properties": {- "mcp_url": {+ "slug": {"type": "string",- "description": "Base MCP URL without any query parameters",- "example": "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000"+ "description": "Unique identifier for the trigger type",+ "example": "SLACK_RECEIVE_MESSAGE"},- "connected_account_urls": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of URLs generated for each connected account ID",- "example": [- "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=account_1&user_id=user_123456,user_789012",- "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=account_2&user_id=user_123456,user_789012"- ]+ "name": {+ "type": "string",+ "description": "Human-readable name of the trigger",+ "example": "New Message in Slack Channel"},- "user_ids_url": {- "type": "array",- "items": {- "type": "string"+ "description": {+ "type": "string",+ "description": "Detailed description of what the trigger does",+ "example": "Triggers when a new message is posted to a Slack channel"+ },+ "instructions": {+ "type": "string",+ "description": "Step-by-step instructions on how to set up and use this trigger"+ },+ "type": {+ "type": "string",+ "enum": [+ "webhook",+ "poll"+ ],+ "description": "The trigger mechanism - either webhook (event-based) or poll (scheduled check)",+ "example": "webhook"+ },+ "toolkit": {+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "description": "Unique identifier for the parent toolkit",+ "example": "slack"+ },+ "name": {+ "type": "string",+ "description": "Deprecated: Use slug instead",+ "example": "Slack"+ },+ "logo": {+ "type": "string",+ "description": "Logo of the toolkit",+ "example": "https://example.com/logo.png"+ }},- "description": "List of URLs generated for each user ID",- "example": [- "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=account_1,account_2&user_id=user_123456",- "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=account_1,account_2&user_id=user_789012"- ]+ "required": [+ "slug",+ "name",+ "logo"+ ],+ "description": "Information about the toolkit that provides this trigger"+ },+ "config": {+ "type": "object",+ "additionalProperties": {},+ "description": "Configuration schema required to set up this trigger",+ "example": {+ "channel_id": {+ "type": "string",+ "required": true+ },+ "message_type": {+ "type": "enum",+ "options": [+ "all",+ "direct",+ "channel"+ ]+ }+ }+ },+ "payload": {+ "type": "object",+ "additionalProperties": {},+ "description": "Schema of the data payload this trigger will deliver when it fires",+ "example": {+ "message": {+ "type": "string"+ },+ "sender": {+ "type": "object",+ "properties": {+ "id": "string",+ "name": "string"+ }+ },+ "timestamp": {+ "type": "number"+ }+ }+ },+ "version": {+ "type": "string",+ "description": "Version of the trigger type",+ "example": "20250930_00"}},"required": [- "mcp_url",- "connected_account_urls",- "user_ids_url"- ],- "description": "Response containing the generated MCP URLs"+ "slug",+ "name",+ "description",+ "instructions",+ "type",+ "toolkit",+ "config",+ "payload",+ "version"+ ]}}}},"400": {- "description": "Bad request. The request body may be invalid or missing required parameters.",+ "description": "Bad request","content": {"application/json": {"schema": {@@ -11167,17 +11501,7 @@}},"401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "403": {- "description": "Forbidden. The authenticated user does not have permission to access this MCP server.",+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -11187,7 +11511,7 @@}},"404": {- "description": "MCP server not found. No server with the specified ID exists or it has been deleted.",+ "description": "Not found","content": {"application/json": {"schema": {@@ -11197,7 +11521,7 @@}},"500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -11209,14 +11533,14 @@}}},- "/api/v3/mcp/{id}": {+ "/api/v3/triggers_types": {"get": {- "summary": "Get MCP server details by ID",- "description": "Retrieves detailed configuration information for a specific Model Control Protocol (MCP) server. The returned data includes connection details, associated applications, enabled tools, and authentication configuration.",+ "summary": "List trigger types",+ "description": "Retrieve a list of available trigger types with optional filtering by toolkit. Results are paginated and can be filtered by toolkit.","tags": [- "MCP"+ "Triggers"],- "operationId": "getMcpById",+ "operationId": "getTriggersTypes","security": [{"ApiKeyAuth": []@@ -11228,505 +11552,230 @@"parameters": [{"schema": {- "type": "string",- "description": "Unique identifier of the MCP server to retrieve, update, or delete",- "example": "550e8400-e29b-41d4-a716-446655440000"+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string"+ },+ "description": "Array of toolkit slugs to filter triggers by",+ "example": [+ "slack",+ "github"+ ]},- "required": true,- "description": "The ID of the MCP server",- "name": "id",- "in": "path"- }- ],- "responses": {- "200": {- "description": "Successfully retrieved MCP server. Returns the complete server configuration including connection details, authentication settings, and available tools.",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "id": {- "type": "string",- "description": "UUID of the MCP server instance",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "name": {- "type": "string",- "description": "User-defined descriptive name for this MCP server",- "example": "GitHub Integration Server"- },- "auth_config_ids": {- "type": "array",- "items": {- "type": "string"- },- "description": "ID references to the auth configurations used by this server",- "example": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ]- },- "allowed_tools": {- "type": "array",- "items": {- "type": "string"- },- "description": "Array of tool slugs that this MCP server is allowed to use",- "example": [- "github-issues",- "github-repos",- "github-pull-requests"- ]- },- "mcp_url": {- "type": "string",- "description": "[DEPRECATED] Please use the URL with user_id or connected_account_id query param",- "deprecated": true,- "example": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"- },- "toolkits": {- "type": "array",- "items": {- "type": "string"- },- "description": "Array of toolkit slugs that this MCP server is allowed to use",- "example": [- "github",- "jira",- "slack"- ]- },- "toolkit_icons": {- "type": "object",- "additionalProperties": {- "type": "string"- },- "description": "Object mapping each toolkit slug to its icon/logo URL for display purposes",- "example": {- "github": "https://assets.composio.dev/logos/github.png",- "jira": "https://assets.composio.dev/logos/jira.png",- "slack": "https://assets.composio.dev/logos/slack.png"- }- },- "commands": {- "type": "object",- "properties": {- "cursor": {- "type": "string",- "description": "Command line instruction for Cursor client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor"- },- "claude": {- "type": "string",- "description": "Command line instruction for Claude client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude"- },- "windsurf": {- "type": "string",- "description": "Command line instruction for Windsurf client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"- }- },- "required": [- "cursor",- "claude",- "windsurf"- ],- "description": "Set of command line instructions for connecting various clients to this MCP server",- "deprecated": true- },- "updated_at": {- "type": "string",- "description": "Date and time when this server configuration was last modified",- "example": "2023-06-15T14:30:00.000Z"- },- "created_at": {- "type": "string",- "description": "Date and time when this server was initially created",- "example": "2023-06-10T09:15:00.000Z"- },- "server_instance_count": {- "type": "number",- "description": "Total count of active user instances connected to this server",- "example": 5- },- "managed_auth_via_composio": {- "type": "boolean",- "description": "Whether the MCP server is managed by Composio",- "example": true- },- "deleted": {- "type": "boolean",- "description": "Whether the MCP server is deleted"- }- },- "required": [- "id",- "name",- "auth_config_ids",- "allowed_tools",- "mcp_url",- "toolkits",- "toolkit_icons",- "commands",- "updated_at",- "created_at",- "server_instance_count",- "managed_auth_via_composio",- "deleted"- ],- "description": "MCP server configuration and connection details"- }- }- }- },- "400": {- "description": "Bad request. The server ID parameter may be invalid or in an incorrect format.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "403": {- "description": "Forbidden. The authenticated user does not have permission to view this MCP server.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }+ "required": false,+ "description": "Array of toolkit slugs to filter triggers by",+ "name": "toolkit_slugs",+ "in": "query"},- "404": {- "description": "MCP server not found. No server with the specified ID exists or it has been deleted.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"+ {+ "schema": {+ "oneOf": [+ {+ "type": "null"+ },+ {+ "type": "string"+ },+ {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ },+ "description": "Object representation of parsed bracket notation"}+ ]+ },+ "required": false,+ "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",+ "in": "query",+ "name": "toolkit_versions",+ "examples": {+ "latest_version": {+ "summary": "Latest version for all toolkits",+ "value": "latest"+ },+ "bracket_notation": {+ "summary": "Specific versions using bracket notation",+ "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"+ },+ "null_value": {+ "summary": "No version specified (uses latest)",+ "value": null}}},- "500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- }- }- },- "patch": {- "summary": "Update MCP server configuration",- "description": "Updates the configuration of an existing Model Control Protocol (MCP) server. You can modify the server name, associated applications, and enabled tools. Only the fields included in the request will be updated.",- "tags": [- "MCP"- ],- "operationId": "patchMcpById",- "security": [{- "ApiKeyAuth": []+ "schema": {+ "type": "number",+ "nullable": true+ },+ "required": false,+ "description": "Number of items per page, max allowed is 1000",+ "name": "limit",+ "in": "query"},- {- "UserApiKeyAuth": []- }- ],- "parameters": [{"schema": {- "type": "string",- "description": "Unique identifier of the MCP server to retrieve, update, or delete",- "example": "550e8400-e29b-41d4-a716-446655440000"+ "type": "string"},- "required": true,- "description": "The ID of the MCP server",- "name": "id",- "in": "path"+ "required": false,+ "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.",+ "name": "cursor",+ "in": "query"}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "name": {- "type": "string",- "description": "Human-readable name to identify this MCP server instance (4-30 characters, alphanumeric, spaces, and hyphens only)",- "example": "Production GitHub Integration"- },- "toolkits": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of toolkit slugs this server should be configured to work with.",- "example": [- "gmail",- "notion"- ]- },- "allowed_tools": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of action identifiers that should be enabled for this server",- "example": [- "GMAIL_ADD_LABEL_TO_EMAIL"- ]- },- "managed_auth_via_composio": {- "type": "boolean",- "description": "Whether the MCP server is managed by Composio",- "example": true- },- "auth_config_ids": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of auth config IDs to use for this MCP server.",- "example": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ]- }- },- "description": "Parameters for updating an existing MCP server configuration"- },- "examples": {- "Update Server Name": {- "value": {- "name": "Updated GitHub Integration Server"- }- },- "Update Single Auth Config": {- "value": {- "auth_config_ids": [- "auth_cfg_abc123def456"- ],- "toolkits": [- "gmail"- ],- "allowed_tools": [- "GMAIL_ADD_LABEL_TO_EMAIL"- ]- }- },- "Update Multiple Auth Configs": {- "value": {- "auth_config_ids": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ],- "toolkits": [- "gmail",- "notion"- ],- "allowed_tools": [- "GMAIL_ADD_LABEL_TO_EMAIL",- "NOTION_CREATE_PAGE"- ]- }- },- "Update Toolkits Only": {- "value": {- "toolkits": [- "gmail",- "notion"- ]- }- },- "Full Update": {- "value": {- "name": "Production Multi-App MCP Server",- "auth_config_ids": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ],- "toolkits": [- "gmail",- "notion"- ],- "allowed_tools": [- "GMAIL_ADD_LABEL_TO_EMAIL",- "NOTION_CREATE_PAGE"- ]- }- }- }- }- }- },"responses": {"200": {- "description": "Successfully updated MCP server. Returns the complete updated server configuration including connection details, authentication settings, and available tools.",+ "description": "Successfully retrieved triggers","content": {"application/json": {"schema": {"type": "object","properties": {- "id": {- "type": "string",- "description": "UUID of the MCP server instance",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "name": {- "type": "string",- "description": "User-defined descriptive name for this MCP server",- "example": "GitHub Integration Server"- },- "auth_config_ids": {- "type": "array",- "items": {- "type": "string"- },- "description": "ID references to the auth configurations used by this server",- "example": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"- ]- },- "allowed_tools": {+ "items": {"type": "array","items": {- "type": "string"- },- "description": "Array of tool slugs that this MCP server is allowed to use",- "example": [- "github-issues",- "github-repos",- "github-pull-requests"- ]+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "description": "Unique identifier for the trigger type",+ "example": "SLACK_RECEIVE_MESSAGE"+ },+ "name": {+ "type": "string",+ "description": "Human-readable name of the trigger",+ "example": "New Message in Slack Channel"+ },+ "description": {+ "type": "string",+ "description": "Detailed description of what the trigger does",+ "example": "Triggers when a new message is posted to a Slack channel"+ },+ "instructions": {+ "type": "string",+ "description": "Step-by-step instructions on how to set up and use this trigger"+ },+ "type": {+ "type": "string",+ "enum": [+ "webhook",+ "poll"+ ],+ "description": "The trigger mechanism - either webhook (event-based) or poll (scheduled check)",+ "example": "webhook"+ },+ "toolkit": {+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "description": "Unique identifier for the parent toolkit",+ "example": "slack"+ },+ "name": {+ "type": "string",+ "description": "Deprecated: Use slug instead",+ "example": "Slack"+ },+ "logo": {+ "type": "string",+ "description": "Logo of the toolkit",+ "example": "https://example.com/logo.png"+ }+ },+ "required": [+ "slug",+ "name",+ "logo"+ ],+ "description": "Information about the toolkit that provides this trigger"+ },+ "config": {+ "type": "object",+ "additionalProperties": {},+ "description": "Configuration schema required to set up this trigger",+ "example": {+ "channel_id": {+ "type": "string",+ "required": true+ },+ "message_type": {+ "type": "enum",+ "options": [+ "all",+ "direct",+ "channel"+ ]+ }+ }+ },+ "payload": {+ "type": "object",+ "additionalProperties": {},+ "description": "Schema of the data payload this trigger will deliver when it fires",+ "example": {+ "message": {+ "type": "string"+ },+ "sender": {+ "type": "object",+ "properties": {+ "id": "string",+ "name": "string"+ }+ },+ "timestamp": {+ "type": "number"+ }+ }+ },+ "version": {+ "type": "string",+ "description": "Version of the trigger type",+ "example": "20250930_00"+ }+ },+ "required": [+ "slug",+ "name",+ "description",+ "instructions",+ "type",+ "toolkit",+ "config",+ "payload",+ "version"+ ]+ }},- "mcp_url": {+ "next_cursor": {"type": "string",- "description": "[DEPRECATED] Please use the URL with user_id or connected_account_id query param",- "deprecated": true,- "example": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"+ "nullable": true},- "toolkits": {- "type": "array",- "items": {- "type": "string"- },- "description": "Array of toolkit slugs that this MCP server is allowed to use",- "example": [- "github",- "jira",- "slack"- ]+ "total_pages": {+ "type": "number"},- "toolkit_icons": {- "type": "object",- "additionalProperties": {- "type": "string"- },- "description": "Object mapping each toolkit slug to its icon/logo URL for display purposes",- "example": {- "github": "https://assets.composio.dev/logos/github.png",- "jira": "https://assets.composio.dev/logos/jira.png",- "slack": "https://assets.composio.dev/logos/slack.png"- }- },- "commands": {- "type": "object",- "properties": {- "cursor": {- "type": "string",- "description": "Command line instruction for Cursor client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor"- },- "claude": {- "type": "string",- "description": "Command line instruction for Claude client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude"- },- "windsurf": {- "type": "string",- "description": "Command line instruction for Windsurf client setup",- "deprecated": true,- "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"- }- },- "required": [- "cursor",- "claude",- "windsurf"- ],- "description": "Set of command line instructions for connecting various clients to this MCP server",- "deprecated": true- },- "updated_at": {- "type": "string",- "description": "Date and time when this server configuration was last modified",- "example": "2023-06-15T14:30:00.000Z"- },- "created_at": {- "type": "string",- "description": "Date and time when this server was initially created",- "example": "2023-06-10T09:15:00.000Z"- },- "server_instance_count": {- "type": "number",- "description": "Total count of active user instances connected to this server",- "example": 5- },- "managed_auth_via_composio": {- "type": "boolean",- "description": "Whether the MCP server is managed by Composio",- "example": true+ "current_page": {+ "type": "number"},- "deleted": {- "type": "boolean",- "description": "Whether the MCP server is deleted"+ "total_items": {+ "type": "number"}},"required": [- "id",- "name",- "auth_config_ids",- "allowed_tools",- "mcp_url",- "toolkits",- "toolkit_icons",- "commands",- "updated_at",- "created_at",- "server_instance_count",- "managed_auth_via_composio",- "deleted"- ],- "description": "MCP server configuration and connection details"+ "items",+ "total_pages",+ "current_page",+ "total_items"+ ]}}}},"400": {- "description": "Bad request. The request parameters may be invalid or in an incorrect format.",+ "description": "Bad request","content": {"application/json": {"schema": {@@ -11736,17 +11785,7 @@}},"401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "403": {- "description": "Forbidden. The authenticated user does not have permission to update this MCP server.",+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -11756,105 +11795,7 @@}},"404": {- "description": "MCP server not found. No server with the specified ID exists or it has been deleted.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- }- }- },- "delete": {- "summary": "Delete an MCP server",- "description": "Performs a soft delete on a Model Control Protocol (MCP) server, making it unavailable for future use. This operation is reversible in the database but cannot be undone through the API. Any applications or services connected to this server will lose access after deletion.",- "tags": [- "MCP"- ],- "operationId": "deleteMcpById",- "security": [- {- "ApiKeyAuth": []- },- {- "UserApiKeyAuth": []- }- ],- "parameters": [- {- "schema": {- "type": "string",- "description": "Unique identifier of the MCP server to retrieve, update, or delete",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "required": true,- "description": "The ID of the MCP server",- "name": "id",- "in": "path"- }- ],- "responses": {- "200": {- "description": "Successfully deleted MCP server. The server has been soft-deleted and is no longer available for use.",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "id": {- "type": "string",- "description": "Unique identifier of the MCP server to retrieve, update, or delete",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "deleted": {- "type": "boolean",- "description": "Indicates whether the MCP server was successfully deleted",- "example": true- }- },- "required": [- "id",- "deleted"- ],- "description": "Response indicating the success of the delete operation"- }- }- }- },- "400": {- "description": "Bad request. The server ID parameter may be invalid or in an incorrect format.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "403": {- "description": "Forbidden. The authenticated user does not have permission to delete this MCP server.",+ "description": "Not found","content": {"application/json": {"schema": {@@ -11863,19 +11804,8 @@}}},- "404": {- "description": "MCP server not found. No server with the specified ID exists or it has already been deleted.",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {}- }- }- }- },"500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -11887,14 +11817,14 @@}}},- "/api/v3/mcp/app/{appKey}": {+ "/api/v3/mcp/servers": {"get": {- "summary": "List MCP servers for a specific app",- "description": "Retrieves a paginated list of Model Control Protocol (MCP) servers that are configured for a specific application or toolkit. This endpoint allows you to find all MCP server instances that have access to a particular application, such as GitHub, Slack, or Jira.",+ "summary": "List MCP servers with optional filters and pagination",+ "description": "Retrieves a paginated list of MCP servers associated with the authenticated project. Results can be filtered by name, toolkit, or authentication configuration ID. MCP servers are used to provide Model Control Protocol integration points for connecting AI assistants to your applications and services.","tags": ["MCP"],- "operationId": "getMcpAppByAppKey",+ "operationId": "getMcpServers","security": [{"ApiKeyAuth": []@@ -11904,17 +11834,6 @@}],"parameters": [- {- "schema": {- "type": "string",- "description": "Toolkit or application slug identifier to filter MCP servers by",- "example": "github"- },- "required": true,- "description": "The key of the app to find MCP servers for",- "name": "appKey",- "in": "path"- },{"schema": {"type": "string",@@ -12005,7 +11924,7 @@],"responses": {"200": {- "description": "Successfully retrieved MCP servers for the specified application. Returns a paginated list of server configurations including connection details and command instructions.",+ "description": "Successfully retrieved MCP servers. Returns a paginated list of server configurations including connection details and command instructions.","content": {"application/json": {"schema": {@@ -12033,8 +11952,8 @@},"description": "ID references to the auth configurations used by this server","example": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"]},"allowed_tools": {@@ -12044,9 +11963,9 @@},"description": "Array of tool slugs that this MCP server is allowed to use","example": [- "github-issues",- "github-repos",- "github-pull-requests"+ "GITHUB_CREATE_AN_ISSUE",+ "GITHUB_GET_A_REPOSITORY",+ "GITHUB_LIST_PULL_REQUESTS"]},"mcp_url": {@@ -12152,12 +12071,12 @@"id": "550e8400-e29b-41d4-a716-446655440000","name": "GitHub Integration Server","auth_config_ids": [- "auth_cfg_abc123def456",- "auth_cfg_xyz789"+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"],"allowed_tools": [- "github-issues",- "github-repos"+ "GITHUB_CREATE_AN_ISSUE",+ "GITHUB_GET_A_REPOSITORY"],"mcp_url": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john","commands": {@@ -12224,17 +12143,7 @@}},"403": {- "description": "Forbidden. The authenticated user does not have permission to view MCP servers for this application.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "404": {- "description": "Application not found. No application with the specified key exists.",+ "description": "Forbidden. The authenticated user does not have permission to view MCP servers for this project.","content": {"application/json": {"schema": {@@ -12254,16 +12163,14 @@}}}- }- },- "/api/v3/mcp/servers/{serverId}/instances": {- "get": {- "summary": "List all instances for an MCP server",- "description": "Retrieves a paginated list of user instances (user IDs) associated with a specific Model Control Protocol (MCP) server. This endpoint supports pagination to handle servers with many instances.",+ },+ "post": {+ "summary": "Create a new MCP server",+ "description": "Creates a new Model Control Protocol (MCP) server instance for the authenticated project. An MCP server provides a connection point for AI assistants to access your applications and services. The server is configured with specific authentication and tool permissions that determine what actions the connected assistants can perform.","tags": ["MCP"],- "operationId": "getMcpServersByServerIdInstances",+ "operationId": "postMcpServers","security": [{"ApiKeyAuth": []@@ -12272,182 +12179,243 @@"UserApiKeyAuth": []}],- "parameters": [- {- "schema": {- "type": "string",- "description": "UUID of the MCP server to list instances for",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "required": true,- "description": "The ID of the MCP server",- "name": "serverId",- "in": "path"- },- {- "schema": {- "type": "number",- "nullable": true,- "default": 1,- "description": "Page number to retrieve",- "example": 1- },- "required": false,- "description": "Page number for pagination (1-based)",- "name": "page_no",- "in": "query"- },- {- "schema": {- "type": "number",- "nullable": true,- "default": 20,- "description": "Number of instances to return per page",- "example": 20- },- "required": false,- "description": "Number of items per page (default: 20)",- "name": "limit",- "in": "query"- },- {- "schema": {- "type": "string",- "description": "Filter instances by user ID or instance ID (partial match)",- "example": "user_123"- },- "required": false,- "description": "Search instances by user ID/instance ID",- "name": "search",- "in": "query"- },- {- "schema": {- "type": "string",- "enum": [- "created_at",- "updated_at"- ],- "default": "updated_at",- "description": "Field to use for ordering the results",- "example": "updated_at"- },- "required": false,- "description": "Field to order results by",- "name": "order_by",- "in": "query"- },- {- "schema": {- "type": "string",- "enum": [- "asc",- "desc"- ],- "default": "desc",- "description": "Sort direction (ascending or descending)",- "example": "desc"- },- "required": false,- "description": "Direction of ordering",- "name": "order_direction",- "in": "query"+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "name": {+ "type": "string",+ "minLength": 4,+ "maxLength": 30,+ "pattern": "^[a-zA-Z0-9- ]+$",+ "description": "Human-readable name to identify this MCP server instance (4-30 characters, alphanumeric, spaces, and hyphens only)",+ "example": "Production GitHub Integration"+ },+ "auth_config_ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "ID references to existing authentication configurations",+ "example": [+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"+ ]+ },+ "no_auth_apps": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of NO_AUTH apps to enable for this MCP server",+ "example": [+ "exa",+ "codeinterpreter",+ "composio",+ "composio_search"+ ]+ },+ "allowed_tools": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "default": [],+ "description": "List of tool slugs that should be allowed for this server. If not provided, all available tools for the authentication configuration will be enabled.",+ "example": [+ "GITHUB_CREATE_AN_ISSUE",+ "GITHUB_GET_A_REPOSITORY",+ "GITHUB_LIST_PULL_REQUESTS"+ ]+ },+ "managed_auth_via_composio": {+ "type": "boolean",+ "description": "Whether the MCP server is managed by Composio"+ }+ },+ "required": [+ "name",+ "auth_config_ids"+ ],+ "description": "Request parameters for creating a new MCP server with specific authentication configuration"+ },+ "examples": {+ "Basic MCP Server": {+ "value": {+ "name": "GitHub Integration Server",+ "auth_config_ids": [+ "ac_1a2b3c4d5e6f"+ ]+ }+ },+ "Server with Limited Tools": {+ "value": {+ "name": "GitHub Issues Only",+ "auth_config_ids": [+ "ac_1a2b3c4d5e6f"+ ],+ "allowed_tools": [+ "GMAIL_ADD_LABEL_TO_EMAIL"+ ]+ }+ },+ "Server with Expiration": {+ "value": {+ "name": "Temporary Integration Server",+ "auth_config_ids": [+ "ac_1a2b3c4d5e6f"+ ]+ }+ }+ }+ }}- ],+ },"responses": {- "200": {- "description": "Successfully retrieved MCP server instances. Returns the list of user IDs associated with this server.",+ "201": {+ "description": "MCP server created successfully. Returns the complete server configuration including connection details and command instructions.","content": {"application/json": {"schema": {"type": "object","properties": {- "instances": {+ "id": {+ "type": "string",+ "description": "UUID of the MCP server instance",+ "example": "550e8400-e29b-41d4-a716-446655440000"+ },+ "name": {+ "type": "string",+ "description": "User-defined descriptive name for this MCP server",+ "example": "GitHub Integration Server"+ },+ "auth_config_ids": {"type": "array","items": {- "type": "object",- "properties": {- "id": {- "type": "string",- "description": "UUID of the instance record",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "instance_id": {- "type": "string",- "description": "The instance identifier (same as the user_id)",- "example": "user_123456"- },- "mcp_server_id": {- "type": "string",- "description": "UUID of the parent MCP server",- "example": "660e8400-e29b-41d4-a716-446655440001"- },- "created_at": {- "type": "string",- "description": "Date and time when this instance was created",- "example": "2023-06-10T09:15:00.000Z"- },- "updated_at": {- "type": "string",- "description": "Date and time when this instance was last modified",- "example": "2023-06-15T14:30:00.000Z"- }- },- "required": [- "id",- "instance_id",- "mcp_server_id",- "created_at",- "updated_at"- ],- "description": "MCP server instance details"+ "type": "string"},- "description": "List of instance objects associated with this MCP server for the current page",+ "description": "ID references to the auth configurations used by this server","example": [- {- "id": "550e8400-e29b-41d4-a716-446655440000",- "instance_id": "user_123456",- "mcp_server_id": "660e8400-e29b-41d4-a716-446655440001",- "created_at": "2023-06-10T09:15:00.000Z",- "updated_at": "2023-06-15T14:30:00.000Z"- }+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"]},- "server_id": {- "type": "string",- "description": "UUID of the MCP server",- "example": "550e8400-e29b-41d4-a716-446655440000"+ "allowed_tools": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Array of tool slugs that this MCP server is allowed to use",+ "example": [+ "GITHUB_CREATE_AN_ISSUE",+ "GITHUB_GET_A_REPOSITORY",+ "GITHUB_LIST_PULL_REQUESTS"+ ]},- "server_name": {+ "mcp_url": {"type": "string",- "description": "Name of the MCP server",- "example": "Production GitHub Integration"- },- "total_pages": {- "type": "number",- "description": "Total number of pages in the paginated response",- "example": 3+ "description": "[DEPRECATED] Please use the URL with user_id or connected_account_id query param",+ "deprecated": true,+ "example": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"},- "current_page": {- "type": "number",- "description": "Current page number being returned",- "example": 1+ "toolkits": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Array of toolkit slugs that this MCP server is allowed to use",+ "example": [+ "github",+ "jira",+ "slack"+ ]+ },+ "toolkit_icons": {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ },+ "description": "Object mapping each toolkit slug to its icon/logo URL for display purposes",+ "example": {+ "github": "https://assets.composio.dev/logos/github.png",+ "jira": "https://assets.composio.dev/logos/jira.png",+ "slack": "https://assets.composio.dev/logos/slack.png"+ }+ },+ "commands": {+ "type": "object",+ "properties": {+ "cursor": {+ "type": "string",+ "description": "Command line instruction for Cursor client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor"+ },+ "claude": {+ "type": "string",+ "description": "Command line instruction for Claude client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude"+ },+ "windsurf": {+ "type": "string",+ "description": "Command line instruction for Windsurf client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"+ }+ },+ "required": [+ "cursor",+ "claude",+ "windsurf"+ ],+ "description": "Set of command line instructions for connecting various clients to this MCP server",+ "deprecated": true+ },+ "updated_at": {+ "type": "string",+ "description": "Date and time when this server configuration was last modified",+ "example": "2023-06-15T14:30:00.000Z"+ },+ "created_at": {+ "type": "string",+ "description": "Date and time when this server was initially created",+ "example": "2023-06-10T09:15:00.000Z"+ },+ "server_instance_count": {+ "type": "number",+ "description": "Total count of active user instances connected to this server",+ "example": 5+ },+ "managed_auth_via_composio": {+ "type": "boolean",+ "description": "Whether the MCP server is managed by Composio",+ "example": true}},"required": [- "instances",- "server_id",- "server_name",- "total_pages",- "current_page"+ "id",+ "name",+ "auth_config_ids",+ "allowed_tools",+ "mcp_url",+ "toolkits",+ "toolkit_icons",+ "commands",+ "updated_at",+ "created_at",+ "server_instance_count",+ "managed_auth_via_composio"],- "description": "Paginated list of instances for an MCP server"+ "description": "MCP server configuration and connection details"}}}},"400": {- "description": "Bad request. The server ID parameter may be invalid.",+ "description": "Bad request. The request body may be invalid, missing required parameters, or the auth_config_id may not exist.","content": {"application/json": {"schema": {@@ -12466,8 +12434,18 @@}}},+ "403": {+ "description": "Forbidden. The authenticated user does not have permission to create MCP servers for this project.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },"404": {- "description": "MCP server not found. No server with the specified ID exists.",+ "description": "Not Found. The specified auth_config_id does not exist or is not accessible to the authenticated user.","content": {"application/json": {"schema": {@@ -12487,14 +12465,16 @@}}}- },+ }+ },+ "/api/v3/mcp/servers/custom": {"post": {- "summary": "Create a new MCP server instance",- "description": "Creates a new instance for a Model Control Protocol (MCP) server. This endpoint validates that the user has connected accounts for all auth configurations associated with the MCP server before creating the instance.",+ "summary": "Create a new custom MCP server with multiple apps",+ "description": "Creates a new Model Control Protocol (MCP) server instance that can integrate with multiple applications or toolkits simultaneously. This endpoint allows you to create a server that can access tools from different applications, making it suitable for complex workflows that span multiple services.","tags": ["MCP"],- "operationId": "postMcpServersByServerIdInstances",+ "operationId": "postMcpServersCustom","security": [{"ApiKeyAuth": []@@ -12503,41 +12483,96 @@"UserApiKeyAuth": []}],- "parameters": [- {- "schema": {- "type": "string",- "description": "UUID of the MCP server to create an instance for",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "required": true,- "description": "The ID of the MCP server",- "name": "serverId",- "in": "path"- }- ],"requestBody": {"content": {"application/json": {"schema": {"type": "object","properties": {- "user_id": {+ "name": {"type": "string",- "minLength": 1,- "description": "The user ID (entity ID) that will be used as both the user identifier and instance ID",- "example": "user_123456"+ "minLength": 4,+ "maxLength": 30,+ "pattern": "^[a-zA-Z0-9- ]+$",+ "description": "Human-readable name to identify this custom MCP server (4-30 characters, alphanumeric, spaces, and hyphens only)",+ "example": "Multi App Integration Server"+ },+ "auth_config_ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "ID references to existing authentication configurations",+ "example": [+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"+ ]+ },+ "toolkits": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of application/toolkit identifiers to enable for this server",+ "example": [+ "github",+ "jira",+ "slack"+ ]+ },+ "allowed_tools": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Tool identifiers to enable that aren't part of standard toolkits",+ "example": [+ "GITHUB_CREATE_AN_ISSUE",+ "SLACK_SEND_MESSAGE"+ ]+ },+ "custom_tools": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "DEPRECATED: Use allowed_tools instead. Tool identifiers to enable that aren't part of standard toolkits",+ "example": [+ "GITHUB_CREATE_AN_ISSUE",+ "SLACK_SEND_MESSAGE"+ ]+ },+ "managed_auth_via_composio": {+ "type": "boolean",+ "description": "Whether to manage authentication via Composio"}},"required": [- "user_id"+ "name"],- "description": "Parameters for creating a new MCP server instance"+ "description": "Parameters for creating a new custom MCP server with multiple applications"},"examples": {- "Create Instance": {+ "Basic Multi-App Server": {"value": {- "user_id": "user_123456"+ "name": "Development Integration Server",+ "toolkits": [+ "github",+ "jira"+ ]+ }+ },+ "Advanced Multi-App Server": {+ "value": {+ "name": "Complete Workflow Integration",+ "toolkits": [+ "github",+ "jira",+ "slack"+ ],+ "custom_tools": [+ "SLACK_SEND_MESSAGE"+ ]}}}@@ -12546,7 +12581,7 @@},"responses": {"201": {- "description": "Successfully created MCP server instance. Returns the created instance details.",+ "description": "Custom MCP server created successfully. Returns the complete server configuration including connection details and command instructions for all specified applications.","content": {"application/json": {"schema": {@@ -12554,44 +12589,85 @@"properties": {"id": {"type": "string",- "description": "UUID of the instance record",+ "description": "Unique identifier for the newly created custom MCP server","example": "550e8400-e29b-41d4-a716-446655440000"},- "instance_id": {+ "name": {"type": "string",- "description": "The instance identifier (same as the user_id)",- "example": "user_123456"+ "description": "Human-readable name of the custom MCP server",+ "example": "Multi-App Integration Server"},- "mcp_server_id": {- "type": "string",- "description": "UUID of the parent MCP server",- "example": "660e8400-e29b-41d4-a716-446655440001"+ "auth_config_ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "ID references to the auth configurations used by this server",+ "example": [+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"+ ]},- "created_at": {- "type": "string",- "description": "Date and time when this instance was created",- "example": "2023-06-10T09:15:00.000Z"+ "allowed_tools": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of tool identifiers that are enabled for this server",+ "example": [+ "GITHUB_CREATE_AN_ISSUE",+ "JIRA_GET_ISSUE",+ "SLACK_SEND_MESSAGE",+ "GMAIL_SEND_EMAIL"+ ]},- "updated_at": {+ "mcp_url": {"type": "string",- "description": "Date and time when this instance was last modified",- "example": "2023-06-15T14:30:00.000Z"- }- },- "required": [- "id",- "instance_id",- "mcp_server_id",- "created_at",- "updated_at"- ],- "description": "MCP server instance details"- }- }+ "description": "URL endpoint for establishing connection to this MCP server",+ "example": "https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john"+ },+ "commands": {+ "type": "object",+ "properties": {+ "cursor": {+ "type": "string",+ "description": "Command line instruction for Cursor client setup",+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client cursor"+ },+ "claude": {+ "type": "string",+ "description": "Command line instruction for Claude client setup",+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client claude"+ },+ "windsurf": {+ "type": "string",+ "description": "Command line instruction for Windsurf client setup",+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"+ }+ },+ "required": [+ "cursor",+ "claude",+ "windsurf"+ ],+ "description": "Set of command line instructions for connecting various clients to this MCP server"+ }+ },+ "required": [+ "id",+ "name",+ "auth_config_ids",+ "allowed_tools",+ "mcp_url",+ "commands"+ ],+ "description": "Response for a successfully created custom MCP server with multiple applications"+ }+ }}},"400": {- "description": "Bad request. The request parameters may be invalid or the instance ID already exists.",+ "description": "Bad request. The request body may be invalid, missing required parameters, or contain invalid toolkit identifiers.","content": {"application/json": {"schema": {@@ -12611,27 +12687,7 @@}},"403": {- "description": "Forbidden. The user does not have connected accounts for all required auth configurations.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "404": {- "description": "MCP server not found. No server with the specified ID exists.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "409": {- "description": "Conflict. An instance with this ID already exists for the server.",+ "description": "Forbidden. The authenticated user does not have permission to create MCP servers for this project.","content": {"application/json": {"schema": {@@ -12653,14 +12709,14 @@}}},- "/api/v3/mcp/servers/{serverId}/instances/{instanceId}": {- "delete": {- "summary": "Delete an MCP server instance and associated connected accounts",- "description": "Removes a user instance from the MCP server and deletes all connected accounts for that user that are associated with the auth configurations of this specific MCP server. Connected accounts for other auth configurations are not affected.",+ "/api/v3/mcp/servers/generate": {+ "post": {+ "summary": "Generate MCP URL with custom parameters",+ "description": "Generates a Model Control Protocol (MCP) URL for an existing server with custom query parameters. The URL includes user-specific parameters and configuration flags that control the behavior of the MCP connection.","tags": ["MCP"],- "operationId": "deleteMcpServersByServerIdInstancesByInstanceId",+ "operationId": "postMcpServersGenerate","security": [{"ApiKeyAuth": []@@ -12669,55 +12725,131 @@"UserApiKeyAuth": []}],- "parameters": [- {- "schema": {- "type": "string",- "description": "UUID of the MCP server",- "example": "550e8400-e29b-41d4-a716-446655440000"- },- "required": true,- "description": "The ID of the MCP server",- "name": "serverId",- "in": "path"- },- {- "schema": {- "type": "string",- "description": "The user ID to remove from this server",- "example": "user_123456"- },- "required": true,- "description": "The instance ID (user ID) to delete",- "name": "instanceId",- "in": "path"+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "mcp_server_id": {+ "type": "string",+ "description": "Unique identifier of the MCP server to generate URL for",+ "example": "550e8400-e29b-41d4-a716-446655440000"+ },+ "managed_auth_by_composio": {+ "type": "boolean",+ "default": false,+ "description": "Flag indicating if Composio manages authentication",+ "example": true+ },+ "user_ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of user identifiers for whom the URL is generated",+ "example": [+ "user_123456",+ "user_789012"+ ]+ },+ "connected_account_ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of connected account identifiers",+ "example": [+ "ca_1a2b3c4d5e6f",+ "ca_7g8h9i0j1k2l",+ "ca_3m4n5o6p7q8r"+ ]+ }+ },+ "required": [+ "mcp_server_id"+ ],+ "description": "Request parameters for generating an MCP URL"+ },+ "examples": {+ "Basic URL Generation": {+ "value": {+ "mcp_server_id": "550e8400-e29b-41d4-a716-446655440000",+ "user_ids": [+ "user_123456"+ ],+ "connected_account_ids": [+ "ca_1a2b3c4d5e6f",+ "ca_7g8h9i0j1k2l"+ ]+ }+ },+ "Managed Auth Configuration": {+ "value": {+ "mcp_server_id": "550e8400-e29b-41d4-a716-446655440000",+ "user_ids": [+ "user_123456",+ "user_789012"+ ],+ "connected_account_ids": [+ "ca_1a2b3c4d5e6f",+ "ca_7g8h9i0j1k2l",+ "ca_3m4n5o6p7q8r"+ ]+ }+ }+ }+ }}- ],+ },"responses": {"200": {- "description": "Successfully deleted MCP server instance and associated connected accounts.",+ "description": "Successfully generated MCP URL. Returns the complete URL with all specified query parameters.","content": {"application/json": {"schema": {"type": "object","properties": {- "message": {- "type": "string"+ "mcp_url": {+ "type": "string",+ "description": "Base MCP URL without any query parameters",+ "example": "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000"},- "deleted_connected_accounts": {- "type": "number"+ "connected_account_urls": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of URLs generated for each connected account ID",+ "example": [+ "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=ca_1a2b3c4d5e6f&user_id=user_123456,user_789012",+ "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=ca_7g8h9i0j1k2l&user_id=user_123456,user_789012"+ ]+ },+ "user_ids_url": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of URLs generated for each user ID",+ "example": [+ "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=ca_1a2b3c4d5e6f,ca_7g8h9i0j1k2l&user_id=user_123456",+ "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=ca_1a2b3c4d5e6f,ca_7g8h9i0j1k2l&user_id=user_789012"+ ]}},"required": [- "message",- "deleted_connected_accounts"- ]+ "mcp_url",+ "connected_account_urls",+ "user_ids_url"+ ],+ "description": "Response containing the generated MCP URLs"}}}},"400": {- "description": "Bad request. The request parameters may be invalid.",+ "description": "Bad request. The request body may be invalid or missing required parameters.","content": {"application/json": {"schema": {@@ -12736,8 +12868,18 @@}}},+ "403": {+ "description": "Forbidden. The authenticated user does not have permission to access this MCP server.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },"404": {- "description": "MCP server or instance not found.",+ "description": "MCP server not found. No server with the specified ID exists or it has been deleted.","content": {"application/json": {"schema": {@@ -12759,14 +12901,14 @@}}},- "/api/v3/files/list": {+ "/api/v3/mcp/{id}": {"get": {- "summary": "List files with optional app and action filters",- "description": "Retrieves a list of files associated with the authenticated project. Results can be filtered by toolkit and tool slugs.",+ "summary": "Get MCP server details by ID",+ "description": "Retrieves detailed configuration information for a specific Model Control Protocol (MCP) server. The returned data includes connection details, associated applications, enabled tools, and authentication configuration.","tags": [- "Files"+ "MCP"],- "operationId": "getFilesList",+ "operationId": "getMcpById","security": [{"ApiKeyAuth": []@@ -12779,112 +12921,163 @@{"schema": {"type": "string",- "description": "Filter files by app slug. Example: \"file-converter\""- },- "required": false,- "description": "Filter files by app slug. Example: \"file-converter\"",- "name": "toolkit_slug",- "in": "query"- },- {- "schema": {- "type": "string",- "description": "Filter files by action slug. Example: \"convert-to-pdf\""- },- "required": false,- "description": "Filter files by action slug. Example: \"convert-to-pdf\"",- "name": "tool_slug",- "in": "query"- },- {- "schema": {- "type": "number",- "nullable": true+ "description": "Unique identifier of the MCP server to retrieve, update, or delete",+ "example": "550e8400-e29b-41d4-a716-446655440000"},- "required": false,- "description": "Number of items per page, max allowed is 1000",- "name": "limit",- "in": "query"- },- {- "schema": {- "type": "string"- },- "required": false,- "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.",- "name": "cursor",- "in": "query"+ "required": true,+ "description": "The ID of the MCP server",+ "name": "id",+ "in": "path"}],"responses": {"200": {- "description": "Successfully retrieved files",+ "description": "Successfully retrieved MCP server. Returns the complete server configuration including connection details, authentication settings, and available tools.","content": {"application/json": {"schema": {"type": "object","properties": {- "items": {+ "id": {+ "type": "string",+ "description": "UUID of the MCP server instance",+ "example": "550e8400-e29b-41d4-a716-446655440000"+ },+ "name": {+ "type": "string",+ "description": "User-defined descriptive name for this MCP server",+ "example": "GitHub Integration Server"+ },+ "auth_config_ids": {"type": "array","items": {- "type": "object",- "properties": {- "toolkit_slug": {- "type": "string",- "description": "Slug of the app where this file belongs to. Example: \"file-converter\""- },- "tool_slug": {- "type": "string",- "description": "Slug of the action where this file belongs to. Example: \"convert-to-pdf\""- },- "filename": {- "type": "string",- "description": "Name of the original file. Example: \"document.docx\""- },- "mimetype": {- "type": "string",- "description": "Mime type of the original file. Example: \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\""- },- "md5": {- "type": "string",- "description": "MD5 hash of the file for integrity verification. Example: \"d41d8cd98f00b204e9800998ecf8427e\""- }- },- "required": [- "toolkit_slug",- "tool_slug",- "filename",- "mimetype",- "md5"- ]+ "type": "string"+ },+ "description": "ID references to the auth configurations used by this server",+ "example": [+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"+ ]+ },+ "allowed_tools": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Array of tool slugs that this MCP server is allowed to use",+ "example": [+ "GITHUB_CREATE_AN_ISSUE",+ "GITHUB_GET_A_REPOSITORY",+ "GITHUB_LIST_PULL_REQUESTS"+ ]+ },+ "mcp_url": {+ "type": "string",+ "description": "[DEPRECATED] Please use the URL with user_id or connected_account_id query param",+ "deprecated": true,+ "example": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"+ },+ "toolkits": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Array of toolkit slugs that this MCP server is allowed to use",+ "example": [+ "github",+ "jira",+ "slack"+ ]+ },+ "toolkit_icons": {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ },+ "description": "Object mapping each toolkit slug to its icon/logo URL for display purposes",+ "example": {+ "github": "https://assets.composio.dev/logos/github.png",+ "jira": "https://assets.composio.dev/logos/jira.png",+ "slack": "https://assets.composio.dev/logos/slack.png"}},- "next_cursor": {+ "commands": {+ "type": "object",+ "properties": {+ "cursor": {+ "type": "string",+ "description": "Command line instruction for Cursor client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor"+ },+ "claude": {+ "type": "string",+ "description": "Command line instruction for Claude client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude"+ },+ "windsurf": {+ "type": "string",+ "description": "Command line instruction for Windsurf client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"+ }+ },+ "required": [+ "cursor",+ "claude",+ "windsurf"+ ],+ "description": "Set of command line instructions for connecting various clients to this MCP server",+ "deprecated": true+ },+ "updated_at": {"type": "string",- "nullable": true+ "description": "Date and time when this server configuration was last modified",+ "example": "2023-06-15T14:30:00.000Z"},- "total_pages": {- "type": "number"+ "created_at": {+ "type": "string",+ "description": "Date and time when this server was initially created",+ "example": "2023-06-10T09:15:00.000Z"},- "current_page": {- "type": "number"+ "server_instance_count": {+ "type": "number",+ "description": "Total count of active user instances connected to this server",+ "example": 5},- "total_items": {- "type": "number"+ "managed_auth_via_composio": {+ "type": "boolean",+ "description": "Whether the MCP server is managed by Composio",+ "example": true+ },+ "deleted": {+ "type": "boolean",+ "description": "Whether the MCP server is deleted"}},"required": [- "items",- "total_pages",- "current_page",- "total_items"- ]+ "id",+ "name",+ "auth_config_ids",+ "allowed_tools",+ "mcp_url",+ "toolkits",+ "toolkit_icons",+ "commands",+ "updated_at",+ "created_at",+ "server_instance_count",+ "managed_auth_via_composio",+ "deleted"+ ],+ "description": "MCP server configuration and connection details"}}}},"400": {- "description": "Bad request",+ "description": "Bad request. The server ID parameter may be invalid or in an incorrect format.","content": {"application/json": {"schema": {@@ -12894,7 +13087,17 @@}},"401": {- "description": "Unauthorized",+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "403": {+ "description": "Forbidden. The authenticated user does not have permission to view this MCP server.","content": {"application/json": {"schema": {@@ -12904,7 +13107,7 @@}},"404": {- "description": "Not found",+ "description": "MCP server not found. No server with the specified ID exists or it has been deleted.","content": {"application/json": {"schema": {@@ -12914,7 +13117,7 @@}},"500": {- "description": "Internal server error",+ "description": "Internal server error. An unexpected error occurred while processing the request.","content": {"application/json": {"schema": {@@ -12924,16 +13127,14 @@}}}- }- },- "/api/v3/files/upload/request": {- "post": {- "summary": "Create presigned URL for request file upload to S3",- "description": "Generates a presigned URL for uploading a file to S3. This endpoint handles deduplication by checking if a file with the same MD5 hash already exists.",+ },+ "patch": {+ "summary": "Update MCP server configuration",+ "description": "Updates the configuration of an existing Model Control Protocol (MCP) server. You can modify the server name, associated applications, and enabled tools. Only the fields included in the request will be updated.","tags": [- "Files"+ "MCP"],- "operationId": "postFilesUploadRequest",+ "operationId": "patchMcpById","security": [{"ApiKeyAuth": []@@ -12942,85 +13143,128 @@"UserApiKeyAuth": []}],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "description": "Unique identifier of the MCP server to retrieve, update, or delete",+ "example": "550e8400-e29b-41d4-a716-446655440000"+ },+ "required": true,+ "description": "The ID of the MCP server",+ "name": "id",+ "in": "path"+ }+ ],"requestBody": {"content": {"application/json": {"schema": {"type": "object","properties": {- "toolkit_slug": {+ "name": {"type": "string",- "description": "Slug of the app where this file belongs to. Example: \"gmail\", \"slack\", \"github\""+ "description": "Human-readable name to identify this MCP server instance (4-30 characters, alphanumeric, spaces, and hyphens only)",+ "example": "Production GitHub Integration"},- "tool_slug": {- "type": "string",- "description": "Slug of the action where this file belongs to. Example: \"GMAIL_SEND_EMAIL\", \"SLACK_UPLOAD_FILE\""+ "toolkits": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of toolkit slugs this server should be configured to work with.",+ "example": [+ "gmail",+ "notion"+ ]},- "filename": {- "type": "string",- "description": "Name of the original file. Example: \"quarterly_report.pdf\""+ "allowed_tools": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of action identifiers that should be enabled for this server",+ "example": [+ "GMAIL_ADD_LABEL_TO_EMAIL"+ ]},- "mimetype": {- "type": "string",- "description": "Mime type of the original file. Example: \"application/pdf\", \"image/png\""+ "managed_auth_via_composio": {+ "type": "boolean",+ "description": "Whether the MCP server is managed by Composio",+ "example": true},- "md5": {- "type": "string",- "description": "MD5 hash of the file for deduplication and integrity verification. Example: \"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6\""+ "auth_config_ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of auth config IDs to use for this MCP server.",+ "example": [+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"+ ]}},- "required": [- "toolkit_slug",- "tool_slug",- "filename",- "mimetype",- "md5"- ]+ "description": "Parameters for updating an existing MCP server configuration"},"examples": {- "Gmail Email Attachment": {+ "Update Server Name": {"value": {- "toolkit_slug": "gmail",- "tool_slug": "GMAIL_SEND_EMAIL",- "filename": "quarterly_report.pdf",- "mimetype": "application/pdf",- "md5": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"+ "name": "Updated GitHub Integration Server"}},- "Slack File Upload": {+ "Update Single Auth Config": {"value": {- "toolkit_slug": "slack",- "tool_slug": "SLACK_UPLOAD_FILE",- "filename": "meeting_notes.docx",- "mimetype": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",- "md5": "b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7"+ "auth_config_ids": [+ "ac_1a2b3c4d5e6f"+ ],+ "toolkits": [+ "gmail"+ ],+ "allowed_tools": [+ "GMAIL_ADD_LABEL_TO_EMAIL"+ ]}},- "GitHub Issue Screenshot": {+ "Update Multiple Auth Configs": {"value": {- "toolkit_slug": "github",- "tool_slug": "GITHUB_CREATE_ISSUE",- "filename": "bug_screenshot.png",- "mimetype": "image/png",- "md5": "c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8"+ "auth_config_ids": [+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"+ ],+ "toolkits": [+ "gmail",+ "notion"+ ],+ "allowed_tools": [+ "GMAIL_ADD_LABEL_TO_EMAIL",+ "NOTION_CREATE_NOTION_PAGE"+ ]}},- "Notion Page Image": {+ "Update Toolkits Only": {"value": {- "toolkit_slug": "notion",- "tool_slug": "NOTION_ADD_PAGE_CONTENT",- "filename": "diagram.svg",- "mimetype": "image/svg+xml",- "md5": "d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9"+ "toolkits": [+ "gmail",+ "notion"+ ]}},- "Jira Attachment": {+ "Full Update": {"value": {- "toolkit_slug": "jira",- "tool_slug": "JIRA_ADD_ATTACHMENT",- "filename": "error_logs.txt",- "mimetype": "text/plain",- "md5": "e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"+ "name": "Production Multi-App MCP Server",+ "auth_config_ids": [+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"+ ],+ "toolkits": [+ "gmail",+ "notion"+ ],+ "allowed_tools": [+ "GMAIL_ADD_LABEL_TO_EMAIL",+ "NOTION_CREATE_NOTION_PAGE"+ ]}}}@@ -13029,7 +13273,7 @@},"responses": {"200": {- "description": "Successfully created upload URL for request file",+ "description": "Successfully updated MCP server. Returns the complete updated server configuration including connection details, authentication settings, and available tools.","content": {"application/json": {"schema": {@@ -13037,60 +13281,144 @@"properties": {"id": {"type": "string",- "description": "ID of the request file. Example: \"req_file_9mZn4qR8sXwT\""+ "description": "UUID of the MCP server instance",+ "example": "550e8400-e29b-41d4-a716-446655440000"},- "key": {+ "name": {"type": "string",- "description": "Object storage upload location. Example: \"projects/prj_xyz789/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx\""+ "description": "User-defined descriptive name for this MCP server",+ "example": "GitHub Integration Server"},- "new_presigned_url": {- "type": "string",- "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...\""+ "auth_config_ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "ID references to the auth configurations used by this server",+ "example": [+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"+ ]},- "newPresignedUrl": {- "type": "string",- "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...\"",- "deprecated": true+ "allowed_tools": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Array of tool slugs that this MCP server is allowed to use",+ "example": [+ "GITHUB_CREATE_AN_ISSUE",+ "GITHUB_GET_A_REPOSITORY",+ "GITHUB_LIST_PULL_REQUESTS"+ ]},- "type": {+ "mcp_url": {"type": "string",- "enum": [- "new"- ],- "description": "[DEPRECATED] Indicates this is a new file that needs to be uploaded",- "deprecated": true+ "description": "[DEPRECATED] Please use the URL with user_id or connected_account_id query param",+ "deprecated": true,+ "example": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"},- "metadata": {+ "toolkits": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Array of toolkit slugs that this MCP server is allowed to use",+ "example": [+ "github",+ "jira",+ "slack"+ ]+ },+ "toolkit_icons": {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ },+ "description": "Object mapping each toolkit slug to its icon/logo URL for display purposes",+ "example": {+ "github": "https://assets.composio.dev/logos/github.png",+ "jira": "https://assets.composio.dev/logos/jira.png",+ "slack": "https://assets.composio.dev/logos/slack.png"+ }+ },+ "commands": {"type": "object","properties": {- "storage_backend": {+ "cursor": {"type": "string",- "enum": [- "s3",- "azure_blob_storage"- ],- "description": "Storage backend used for the file. If this is azure, use `x-ms-blob-type` header to set the blob type to `BlockBlob` while uploading the file"+ "description": "Command line instruction for Cursor client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor"+ },+ "claude": {+ "type": "string",+ "description": "Command line instruction for Claude client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude"+ },+ "windsurf": {+ "type": "string",+ "description": "Command line instruction for Windsurf client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"}},"required": [- "storage_backend"- ]+ "cursor",+ "claude",+ "windsurf"+ ],+ "description": "Set of command line instructions for connecting various clients to this MCP server",+ "deprecated": true+ },+ "updated_at": {+ "type": "string",+ "description": "Date and time when this server configuration was last modified",+ "example": "2023-06-15T14:30:00.000Z"+ },+ "created_at": {+ "type": "string",+ "description": "Date and time when this server was initially created",+ "example": "2023-06-10T09:15:00.000Z"+ },+ "server_instance_count": {+ "type": "number",+ "description": "Total count of active user instances connected to this server",+ "example": 5+ },+ "managed_auth_via_composio": {+ "type": "boolean",+ "description": "Whether the MCP server is managed by Composio",+ "example": true+ },+ "deleted": {+ "type": "boolean",+ "description": "Whether the MCP server is deleted"}},"required": ["id",- "key",- "new_presigned_url",- "newPresignedUrl",- "type",- "metadata"- ]+ "name",+ "auth_config_ids",+ "allowed_tools",+ "mcp_url",+ "toolkits",+ "toolkit_icons",+ "commands",+ "updated_at",+ "created_at",+ "server_instance_count",+ "managed_auth_via_composio",+ "deleted"+ ],+ "description": "MCP server configuration and connection details"}}}},"400": {- "description": "Bad Request",+ "description": "Bad request. The request parameters may be invalid or in an incorrect format.","content": {"application/json": {"schema": {@@ -13100,7 +13428,7 @@}},"401": {- "description": "Unauthorized",+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.","content": {"application/json": {"schema": {@@ -13110,7 +13438,7 @@}},"403": {- "description": "Forbidden",+ "description": "Forbidden. The authenticated user does not have permission to update this MCP server.","content": {"application/json": {"schema": {@@ -13120,27 +13448,7 @@}},"404": {- "description": "Not Found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "410": {- "description": "Gone",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "429": {- "description": "Too Many Requests",+ "description": "MCP server not found. No server with the specified ID exists or it has been deleted.","content": {"application/json": {"schema": {@@ -13150,17 +13458,7 @@}},"500": {- "description": "Internal Server Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "501": {- "description": "Not Implemented",+ "description": "Internal server error. An unexpected error occurred while processing the request.","content": {"application/json": {"schema": {@@ -13170,16 +13468,14 @@}}}- }- },- "/api/v3/migration/get-nanoid": {- "get": {- "summary": "Get NanoId from UUID",- "description": "Convert a legacy UUID to its corresponding NanoId for migration purposes. This endpoint facilitates the transition from UUID-based identifiers to the more compact NanoId format used in the v3 API.",+ },+ "delete": {+ "summary": "Delete an MCP server",+ "description": "Performs a soft delete on a Model Control Protocol (MCP) server, making it unavailable for future use. This operation is reversible in the database but cannot be undone through the API. Any applications or services connected to this server will lose access after deletion.","tags": [- "Migration"+ "MCP"],- "operationId": "getMigrationGetNanoid",+ "operationId": "deleteMcpById","security": [{"ApiKeyAuth": []@@ -13192,65 +13488,45 @@{"schema": {"type": "string",- "format": "uuid",- "example": "123e4567-e89b-12d3-a456-426614174000"- },- "required": true,- "description": "The legacy UUID that needs to be converted to a NanoId",- "name": "uuid",- "in": "query"- },- {- "schema": {- "type": "string",- "enum": [- "CONNECTED_ACCOUNT",- "AUTH_CONFIG",- "TRIGGER_INSTANCE"- ],- "example": "CONNECTED_ACCOUNT"- },- "required": true,- "description": "The type of resource that the UUID belongs to",- "name": "type",- "in": "query"- },- {- "schema": {- "type": "string",- "description": "Your Composio API key used for authentication",- "example": "sk_123456789abcdef"+ "description": "Unique identifier of the MCP server to retrieve, update, or delete",+ "example": "550e8400-e29b-41d4-a716-446655440000"},"required": true,- "name": "x-api-key",- "in": "header"+ "description": "The ID of the MCP server",+ "name": "id",+ "in": "path"}],"responses": {"200": {- "description": "Successfully retrieved NanoId for the given UUID",+ "description": "Successfully deleted MCP server. The server has been soft-deleted and is no longer available for use.","content": {"application/json": {"schema": {"type": "object","properties": {- "nanoid": {+ "id": {"type": "string",- "minLength": 10,- "maxLength": 10,- "description": "The NanoId corresponding to the provided UUID. This is the new identifier that should be used in place of the legacy UUID.",- "example": "XqXrPalt3v"+ "description": "Unique identifier of the MCP server to retrieve, update, or delete",+ "example": "550e8400-e29b-41d4-a716-446655440000"+ },+ "deleted": {+ "type": "boolean",+ "description": "Indicates whether the MCP server was successfully deleted",+ "example": true}},"required": [- "nanoid"- ]+ "id",+ "deleted"+ ],+ "description": "Response indicating the success of the delete operation"}}}},"400": {- "description": "Bad Request - Invalid UUID or resource not found",+ "description": "Bad request. The server ID parameter may be invalid or in an incorrect format.","content": {"application/json": {"schema": {@@ -13260,7 +13536,7 @@}},"401": {- "description": "Unauthorized - Invalid or missing API key",+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.","content": {"application/json": {"schema": {@@ -13269,8 +13545,8 @@}}},- "404": {- "description": "Not Found - The UUID does not correspond to any resource of the specified type",+ "403": {+ "description": "Forbidden. The authenticated user does not have permission to delete this MCP server.","content": {"application/json": {"schema": {@@ -13279,18 +13555,19 @@}}},- "410": {- "description": "Gone - The UUID does not correspond to any resource of the specified type",+ "404": {+ "description": "MCP server not found. No server with the specified ID exists or it has already been deleted.","content": {"application/json": {"schema": {- "$ref": "#/components/schemas/Error"+ "type": "object",+ "properties": {}}}}},"500": {- "description": "Internal server error - An unexpected error occurred during processing",+ "description": "Internal server error. An unexpected error occurred while processing the request.","content": {"application/json": {"schema": {@@ -13302,14 +13579,14 @@}}},- "/api/v3/tool_router/session": {- "post": {- "summary": "Create a new tool router session",- "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.",+ "/api/v3/mcp/app/{appKey}": {+ "get": {+ "summary": "List MCP servers for a specific app",+ "description": "Retrieves a paginated list of Model Control Protocol (MCP) servers that are configured for a specific application or toolkit. This endpoint allows you to find all MCP server instances that have access to a particular application, such as GitHub, Slack, or Jira.","tags": [- "Tool Router"+ "MCP"],- "operationId": "postToolRouterSession",+ "operationId": "getMcpAppByAppKey","security": [{"ApiKeyAuth": []@@ -13318,1128 +13595,988 @@"UserApiKeyAuth": []}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "user_id": {- "type": "string",- "minLength": 1,- "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",- "example": "user_123456789"- },- "toolkits": {- "anyOf": [- {+ "parameters": [+ {+ "schema": {+ "type": "string",+ "description": "Toolkit or application slug identifier to filter MCP servers by",+ "example": "github"+ },+ "required": true,+ "description": "The key of the app to find MCP servers for",+ "name": "appKey",+ "in": "path"+ },+ {+ "schema": {+ "type": "string",+ "description": "Name substring to filter servers by",+ "example": "github"+ },+ "required": false,+ "description": "Filter MCP servers by name (case-insensitive partial match)",+ "name": "name",+ "in": "query"+ },+ {+ "schema": {+ "type": "string"+ },+ "required": false,+ "description": "Comma-separated list of toolkit slugs to filter servers by",+ "in": "query",+ "name": "toolkits"+ },+ {+ "schema": {+ "type": "string"+ },+ "required": false,+ "description": "Comma-separated list of auth config IDs to filter servers by",+ "in": "query",+ "name": "auth_config_ids"+ },+ {+ "schema": {+ "type": "string",+ "enum": [+ "created_at",+ "updated_at"+ ],+ "default": "updated_at",+ "description": "Field to use for ordering the results",+ "example": "updated_at"+ },+ "required": false,+ "description": "Field to order results by",+ "name": "order_by",+ "in": "query"+ },+ {+ "schema": {+ "type": "string",+ "enum": [+ "asc",+ "desc"+ ],+ "default": "desc",+ "description": "Sort direction (ascending or descending)",+ "example": "desc"+ },+ "required": false,+ "description": "Direction of ordering",+ "name": "order_direction",+ "in": "query"+ },+ {+ "schema": {+ "type": "number",+ "nullable": true,+ "default": 1,+ "description": "Page number to retrieve",+ "example": 1+ },+ "required": false,+ "description": "Page number for pagination (1-based)",+ "name": "page_no",+ "in": "query"+ },+ {+ "schema": {+ "type": "number",+ "nullable": true,+ "default": 10,+ "description": "Number of servers to return per page",+ "example": 10+ },+ "required": false,+ "description": "Number of items per page (default: 10)",+ "name": "limit",+ "in": "query"+ }+ ],+ "responses": {+ "200": {+ "description": "Successfully retrieved MCP servers for the specified application. Returns a paginated list of server configurations including connection details and command instructions.",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "items": {+ "type": "array",+ "items": {"type": "object","properties": {- "enable": {+ "id": {+ "type": "string",+ "description": "UUID of the MCP server instance",+ "example": "550e8400-e29b-41d4-a716-446655440000"+ },+ "name": {+ "type": "string",+ "description": "User-defined descriptive name for this MCP server",+ "example": "GitHub Integration Server"+ },+ "auth_config_ids": {"type": "array","items": {"type": "string"},- "description": "Only these specific toolkits will be enabled",+ "description": "ID references to the auth configurations used by this server","example": [- "gmail",- "slack",- "github"+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"]- }- },- "required": [- "enable"- ],- "additionalProperties": false,- "description": "Enable only specific toolkits (allowlist)"- },- {- "type": "object",- "properties": {- "disable": {+ },+ "allowed_tools": {"type": "array","items": {"type": "string"},- "description": "These specific toolkits will be disabled",+ "description": "Array of tool slugs that this MCP server is allowed to use","example": [- "gmail",+ "GITHUB_CREATE_AN_ISSUE",+ "GITHUB_GET_A_REPOSITORY",+ "GITHUB_LIST_PULL_REQUESTS"+ ]+ },+ "mcp_url": {+ "type": "string",+ "description": "[DEPRECATED] Please use the URL with user_id or connected_account_id query param",+ "deprecated": true,+ "example": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"+ },+ "toolkits": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Array of toolkit slugs that this MCP server is allowed to use",+ "example": [+ "github",+ "jira","slack"]+ },+ "toolkit_icons": {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ },+ "description": "Object mapping each toolkit slug to its icon/logo URL for display purposes",+ "example": {+ "github": "https://assets.composio.dev/logos/github.png",+ "jira": "https://assets.composio.dev/logos/jira.png",+ "slack": "https://assets.composio.dev/logos/slack.png"+ }+ },+ "commands": {+ "type": "object",+ "properties": {+ "cursor": {+ "type": "string",+ "description": "Command line instruction for Cursor client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor"+ },+ "claude": {+ "type": "string",+ "description": "Command line instruction for Claude client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude"+ },+ "windsurf": {+ "type": "string",+ "description": "Command line instruction for Windsurf client setup",+ "deprecated": true,+ "example": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"+ }+ },+ "required": [+ "cursor",+ "claude",+ "windsurf"+ ],+ "description": "Set of command line instructions for connecting various clients to this MCP server",+ "deprecated": true+ },+ "updated_at": {+ "type": "string",+ "description": "Date and time when this server configuration was last modified",+ "example": "2023-06-15T14:30:00.000Z"+ },+ "created_at": {+ "type": "string",+ "description": "Date and time when this server was initially created",+ "example": "2023-06-10T09:15:00.000Z"+ },+ "server_instance_count": {+ "type": "number",+ "description": "Total count of active user instances connected to this server",+ "example": 5+ },+ "managed_auth_via_composio": {+ "type": "boolean",+ "description": "Whether the MCP server is managed by Composio",+ "example": true}},"required": [- "disable"+ "id",+ "name",+ "auth_config_ids",+ "allowed_tools",+ "mcp_url",+ "toolkits",+ "toolkit_icons",+ "commands",+ "updated_at",+ "created_at",+ "server_instance_count",+ "managed_auth_via_composio"],- "additionalProperties": false,- "description": "Disable specific toolkits (denylist)"- }- ],- "description": "Toolkit configuration - specify either enable toolkits (allowlist) or disable toolkits (denylist). Mutually exclusive."- },- "auth_configs": {- "type": "object",- "additionalProperties": {- "type": "string",- "format": "authConfigId"- },- "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",- "example": {- "gmail": "ac_1223434343",- "slack": "ac_23343434343434"- }- },- "connected_accounts": {- "type": "object",- "additionalProperties": {- "type": "string",- "format": "connectedAccountId"- },- "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",- "example": {- "github": "ca_34454545454545"- }- },- "manage_connections": {- "type": "object",- "properties": {- "enable": {- "type": "boolean",- "nullable": true,- "default": true,- "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.",- "example": true- },- "callback_url": {- "type": "string",- "format": "uri",- "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.",- "example": "https://your-app.com/auth/callback"- },- "enable_wait_for_connections": {- "type": "boolean",- "nullable": true,- "default": false,- "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.",- "example": false+ "description": "MCP server configuration and connection details"},- "enable_connection_removal": {- "type": "boolean",- "nullable": true,- "default": true,- "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS to allow deleting connected accounts. Default true."- }- },- "default": {- "enable": true,- "enable_wait_for_connections": false,- "enable_connection_removal": true- },- "additionalProperties": false,- "description": "Configuration for connection management settings"- },- "tools": {- "type": "object",- "additionalProperties": {- "anyOf": [+ "description": "Array of MCP server configurations",+ "example": [{- "type": "object",- "properties": {- "enable": {- "type": "array",- "items": {- "type": "string"- },- "description": "Only these specific tools will be available for this toolkit",- "example": [- "GMAIL_SEND_EMAIL",- "GMAIL_FETCH_EMAILS"- ]- }- },- "required": [- "enable"+ "id": "550e8400-e29b-41d4-a716-446655440000",+ "name": "GitHub Integration Server",+ "auth_config_ids": [+ "ac_1a2b3c4d5e6f",+ "ac_7g8h9i0j1k2l"],- "additionalProperties": false- },- {- "type": "object",- "properties": {- "disable": {- "type": "array",- "items": {- "type": "string"- },- "description": "These specific tools will be disabled for this toolkit",- "example": [- "SLACK_ADD_EMOJI"- ]- }+ "allowed_tools": [+ "GITHUB_CREATE_AN_ISSUE",+ "GITHUB_GET_A_REPOSITORY"+ ],+ "mcp_url": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john",+ "commands": {+ "cursor": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor",+ "claude": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude",+ "windsurf": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"},- "required": [- "disable"+ "toolkits": [+ "github",+ "jira",+ "slack"],- "additionalProperties": false- },- {- "type": "object",- "properties": {- "tags": {- "anyOf": [- {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- }- },- {- "type": "object",- "properties": {- "enable": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must have at least one of"- },- "disable": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must NOT have any of"- }- }- }- ],- "description": "MCP tags to filter tools. Array format is treated as enabled list. Object format supports both enabled and disabled lists.",- "example": {- "enable": [- "openWorldHint"- ],- "disable": [- "destructiveHint"- ]- }- }- },- "required": [- "tags"- ],- "additionalProperties": false- }- ]- },- "description": "Tool-level configuration per toolkit - either specify enable tools (whitelist), disable tools (blacklist), or filter by MCP tags for each toolkit",- "example": {- "gmail": {- "enable": [- "GMAIL_SEND_EMAIL",- "GMAIL_FETCH_EMAILS"- ]- },- "slack": {- "disable": [- "SLACK_ADD_EMOJI"- ]- },- "slack_bot": {- "tags": {- "enable": [- "destructiveHint"- ],- "disable": [- "openWorldHint"- ]- }- }- }- },- "tags": {- "anyOf": [- {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- }- },- {- "type": "object",- "properties": {- "enable": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must have at least one of"+ "toolkit_icons": {+ "github": "https://assets.composio.dev/logos/github.png",+ "jira": "https://assets.composio.dev/logos/jira.png",+ "slack": "https://assets.composio.dev/logos/slack.png"},- "disable": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must NOT have any of"- }+ "updated_at": "2023-06-15T14:30:00.000Z",+ "created_at": "2023-06-10T09:15:00.000Z",+ "server_instance_count": 5,+ "managed_auth_via_composio": true}- }- ],- "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.",- "example": {- "enable": [- "openWorldHint"- ],- "disable": [- "destructiveHint"]- }- },- "workbench": {- "type": "object",- "properties": {- "enable": {- "type": "boolean",- "default": true,- "description": "Set to false to disable the workbench entirely. When disabled, no code execution tools are available in the session.",- "example": true- },- "enable_proxy_execution": {- "type": "boolean",- "default": true,- "description": "Whether proxy execution is enabled. When enabled, workbench can call URLs and APIs directly.",- "example": true- },- "auto_offload_threshold": {- "type": "number",- "minimum": 0,- "exclusiveMinimum": true,- "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.",- "example": 20000- }},- "default": {- "enable": true,- "enable_proxy_execution": true+ "total_pages": {+ "type": "number",+ "description": "Total number of pages in the paginated response",+ "example": 5},- "additionalProperties": false,- "description": "Configuration for workbench behavior"+ "current_page": {+ "type": "number",+ "description": "Current page number being returned",+ "example": 1+ }},- "experimental": {- "type": "object",- "properties": {- "assistive_prompt_config": {- "type": "object",- "properties": {- "user_timezone": {- "type": "string",- "description": "IANA timezone identifier (e.g., 'America/New_York', 'Europe/London'). Used to customize the system prompt with timezone-aware instructions.",- "example": "America/New_York"- }- },- "additionalProperties": false,- "description": "Customize assistive prompt generation (e.g., timezone)."- },- "custom_toolkits": {- "type": "array",- "items": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "minLength": 1,- "pattern": "^[a-zA-Z0-9_-]+$",- "description": "Unique slug for the toolkit. Must not conflict with existing Composio toolkit slugs. Alphanumeric, underscores, and hyphens only.",- "example": "ecommerce"- },- "name": {- "type": "string",- "minLength": 1,- "maxLength": 128,- "description": "Display name shown to the LLM and in search results.",- "example": "E-Commerce API"- },- "description": {- "type": "string",- "minLength": 1,- "maxLength": 2048,- "description": "Used for BM25 search matching and shown in toolkit connection statuses.",- "example": "Internal e-commerce API for order management and fulfillment"- },- "tools": {- "type": "array",- "items": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "minLength": 1,- "pattern": "^[a-zA-Z0-9_-]+$",- "description": "Tool slug. Combined with toolkit slug to form LOCAL_<TOOLKIT>_<TOOL> (max 60 chars total).",- "example": "GET_CUSTOMER_ORDERS"- },- "name": {- "type": "string",- "minLength": 1,- "maxLength": 128,- "description": "Human-readable display name",- "example": "Get Customer Orders"- },- "description": {- "type": "string",- "minLength": 1,- "maxLength": 5120,- "description": "Used for BM25 search matching and shown to the LLM.",- "example": "Fetch recent orders for a customer by their email address"- },- "input_schema": {- "type": "object",- "additionalProperties": {},- "description": "Must have type: \"object\" and a properties field.",- "example": {- "type": "object",- "properties": {- "email": {- "type": "string",- "description": "Customer email"- }- },- "required": [- "email"- ]- }- },- "output_schema": {- "type": "object",- "additionalProperties": {},- "description": "Optional output schema for the tool response."- }- },- "required": [- "slug",- "name",- "description",- "input_schema"- ]- },- "minItems": 1,- "maxItems": 100,- "description": "Tools in this custom toolkit"- }+ "required": [+ "items",+ "total_pages",+ "current_page"+ ],+ "description": "Paginated response containing MCP servers"+ }+ }+ }+ },+ "400": {+ "description": "Bad request. The query parameters may be invalid or in an incorrect format.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "401": {+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "403": {+ "description": "Forbidden. The authenticated user does not have permission to view MCP servers for this application.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "404": {+ "description": "Application not found. No application with the specified key exists.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "500": {+ "description": "Internal server error. An unexpected error occurred while processing the request.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ }+ }+ }+ },+ "/api/v3/mcp/servers/{serverId}/instances": {+ "get": {+ "summary": "List all instances for an MCP server",+ "description": "Retrieves a paginated list of user instances (user IDs) associated with a specific Model Control Protocol (MCP) server. This endpoint supports pagination to handle servers with many instances.",+ "tags": [+ "MCP"+ ],+ "operationId": "getMcpServersByServerIdInstances",+ "security": [+ {+ "ApiKeyAuth": []+ },+ {+ "UserApiKeyAuth": []+ }+ ],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "description": "UUID of the MCP server to list instances for",+ "example": "550e8400-e29b-41d4-a716-446655440000"+ },+ "required": true,+ "description": "The ID of the MCP server",+ "name": "serverId",+ "in": "path"+ },+ {+ "schema": {+ "type": "number",+ "nullable": true,+ "default": 1,+ "description": "Page number to retrieve",+ "example": 1+ },+ "required": false,+ "description": "Page number for pagination (1-based)",+ "name": "page_no",+ "in": "query"+ },+ {+ "schema": {+ "type": "number",+ "nullable": true,+ "default": 20,+ "description": "Number of instances to return per page",+ "example": 20+ },+ "required": false,+ "description": "Number of items per page (default: 20)",+ "name": "limit",+ "in": "query"+ },+ {+ "schema": {+ "type": "string",+ "description": "Filter instances by user ID or instance ID (partial match)",+ "example": "user_123"+ },+ "required": false,+ "description": "Search instances by user ID/instance ID",+ "name": "search",+ "in": "query"+ },+ {+ "schema": {+ "type": "string",+ "enum": [+ "created_at",+ "updated_at"+ ],+ "default": "updated_at",+ "description": "Field to use for ordering the results",+ "example": "updated_at"+ },+ "required": false,+ "description": "Field to order results by",+ "name": "order_by",+ "in": "query"+ },+ {+ "schema": {+ "type": "string",+ "enum": [+ "asc",+ "desc"+ ],+ "default": "desc",+ "description": "Sort direction (ascending or descending)",+ "example": "desc"+ },+ "required": false,+ "description": "Direction of ordering",+ "name": "order_direction",+ "in": "query"+ }+ ],+ "responses": {+ "200": {+ "description": "Successfully retrieved MCP server instances. Returns the list of user IDs associated with this server.",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "instances": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "id": {+ "type": "string",+ "description": "UUID of the instance record",+ "example": "550e8400-e29b-41d4-a716-446655440000"},- "required": [- "slug",- "name",- "description",- "tools"- ]+ "instance_id": {+ "type": "string",+ "description": "The instance identifier (same as the user_id)",+ "example": "user_123456"+ },+ "mcp_server_id": {+ "type": "string",+ "description": "UUID of the parent MCP server",+ "example": "660e8400-e29b-41d4-a716-446655440001"+ },+ "created_at": {+ "type": "string",+ "description": "Date and time when this instance was created",+ "example": "2023-06-10T09:15:00.000Z"+ },+ "updated_at": {+ "type": "string",+ "description": "Date and time when this instance was last modified",+ "example": "2023-06-15T14:30:00.000Z"+ }},- "description": "Custom toolkits with grouped tools. Toolkit slugs must not conflict with existing Composio toolkits. All tools are no-auth."+ "required": [+ "id",+ "instance_id",+ "mcp_server_id",+ "created_at",+ "updated_at"+ ],+ "description": "MCP server instance details"},- "custom_tools": {- "type": "array",- "items": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "minLength": 1,- "pattern": "^[a-zA-Z0-9_-]+$",- "description": "Tool slug. Forms LOCAL_<TOOL> (standalone) or LOCAL_<TOOLKIT>_<TOOL> (extending). Max 60 chars total.",- "example": "GET_IMPORTANT_EMAILS"- },- "name": {- "type": "string",- "minLength": 1,- "maxLength": 128,- "description": "Human-readable display name",- "example": "Get Important Emails"- },- "description": {- "type": "string",- "minLength": 1,- "maxLength": 5120,- "description": "Used for BM25 search matching and shown to the LLM.",- "example": "Fetch emails marked as important from the last 24 hours"- },- "input_schema": {- "type": "object",- "additionalProperties": {},- "description": "Must have type: \"object\" and a properties field.",- "example": {- "type": "object",- "properties": {- "limit": {- "type": "number",- "description": "Max results to return"- }- }- }- },- "output_schema": {- "type": "object",- "additionalProperties": {},- "description": "JSON Schema describing tool output (optional)"- },- "extends_toolkit": {- "type": "string",- "minLength": 1,- "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).",- "example": "gmail"- }- },- "required": [- "slug",- "name",- "description",- "input_schema"- ]- },- "description": "Custom tools to include in search. Standalone tools need no auth. Tools with extends_toolkit inherit the Composio toolkit's connection."- }+ "description": "List of instance objects associated with this MCP server for the current page",+ "example": [+ {+ "id": "550e8400-e29b-41d4-a716-446655440000",+ "instance_id": "user_123456",+ "mcp_server_id": "660e8400-e29b-41d4-a716-446655440001",+ "created_at": "2023-06-10T09:15:00.000Z",+ "updated_at": "2023-06-15T14:30:00.000Z"+ }+ ]},- "additionalProperties": false,- "description": "Experimental features - not stable, may be modified or removed in future versions.",- "x-experimental": true+ "server_id": {+ "type": "string",+ "description": "UUID of the MCP server",+ "example": "550e8400-e29b-41d4-a716-446655440000"+ },+ "server_name": {+ "type": "string",+ "description": "Name of the MCP server",+ "example": "Production GitHub Integration"+ },+ "total_pages": {+ "type": "number",+ "description": "Total number of pages in the paginated response",+ "example": 3+ },+ "current_page": {+ "type": "number",+ "description": "Current page number being returned",+ "example": 1+ }+ },+ "required": [+ "instances",+ "server_id",+ "server_name",+ "total_pages",+ "current_page"+ ],+ "description": "Paginated list of instances for an MCP server"+ }+ }+ }+ },+ "400": {+ "description": "Bad request. The server ID parameter may be invalid.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "401": {+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "404": {+ "description": "MCP server not found. No server with the specified ID exists.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "500": {+ "description": "Internal server error. An unexpected error occurred while processing the request.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ }+ }+ },+ "post": {+ "summary": "Create a new MCP server instance",+ "description": "Creates a new instance for a Model Control Protocol (MCP) server. This endpoint validates that the user has connected accounts for all auth configurations associated with the MCP server before creating the instance.",+ "tags": [+ "MCP"+ ],+ "operationId": "postMcpServersByServerIdInstances",+ "security": [+ {+ "ApiKeyAuth": []+ },+ {+ "UserApiKeyAuth": []+ }+ ],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "description": "UUID of the MCP server to create an instance for",+ "example": "550e8400-e29b-41d4-a716-446655440000"+ },+ "required": true,+ "description": "The ID of the MCP server",+ "name": "serverId",+ "in": "path"+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "user_id": {+ "type": "string",+ "minLength": 1,+ "description": "The user ID (entity ID) that will be used as both the user identifier and instance ID",+ "example": "user_123456"}},"required": ["user_id"- ]+ ],+ "description": "Parameters for creating a new MCP server instance"},"examples": {- "Session with all toolkits": {- "value": {- "user_id": "user_123456789"- }- },- "Session with only specific toolkits": {- "value": {- "user_id": "user_123456789",- "toolkits": {- "enable": [- "gmail",- "slack"- ]- }- }- },- "Session with only specific toolkits disabled": {- "value": {- "user_id": "user_123456789",- "toolkits": {- "disable": [- "gmail",- "slack"- ]- }- }- },- "Session with connection manager enabled": {+ "Create Instance": {"value": {- "user_id": "user_123456789",- "manage_connections": {- "enable": true- }+ "user_id": "user_123456"}- },- "Session with connection manager and specific toolkits": {- "value": {- "user_id": "user_123456789",- "toolkits": {- "enable": [- "gmail",- "slack"- ]+ }+ }+ }+ }+ },+ "responses": {+ "201": {+ "description": "Successfully created MCP server instance. Returns the created instance details.",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "id": {+ "type": "string",+ "description": "UUID of the instance record",+ "example": "550e8400-e29b-41d4-a716-446655440000"},- "manage_connections": {- "enable": true- }- }- },- "Session with custom callback URL": {- "value": {- "user_id": "user_123456789",- "toolkits": {- "enable": [- "github",- "slack"- ]+ "instance_id": {+ "type": "string",+ "description": "The instance identifier (same as the user_id)",+ "example": "user_123456"},- "manage_connections": {- "enable": true,- "callback_url": "https://your-app.com/auth/callback"- }- }- },- "Session with workbench configuration": {- "value": {- "user_id": "user_123456789",- "toolkits": {- "enable": [- "gmail"- ]+ "mcp_server_id": {+ "type": "string",+ "description": "UUID of the parent MCP server",+ "example": "660e8400-e29b-41d4-a716-446655440001"},- "workbench": {- "enable_proxy_execution": true,- "auto_offload_threshold": 10000+ "created_at": {+ "type": "string",+ "description": "Date and time when this instance was created",+ "example": "2023-06-10T09:15:00.000Z"+ },+ "updated_at": {+ "type": "string",+ "description": "Date and time when this instance was last modified",+ "example": "2023-06-15T14:30:00.000Z"}- }- },- "Session with global tags filter": {- "value": {- "user_id": "user_123456789",- "toolkits": {- "enable": [- "gmail",- "slack"- ]- },- "tags": [- "readOnlyHint",- "idempotentHint"- ]- }- },- "Session with auth config overrides": {- "value": {- "user_id": "user_123456789",- "toolkits": {- "enable": [- "gmail",- "slack"- ]- },- "auth_configs": {- "gmail": "ac_1223434343",- "slack": "ac_23343434343434"- }- }- },- "Session with connected account overrides": {- "value": {- "user_id": "user_123456789",- "toolkits": {- "enable": [- "gmail",- "slack"- ]- },- "connected_accounts": {- "gmail": "ca_1223434343",- "slack": "ca_23344434343434"- }- }- },- "Session with comprehensive configuration": {- "value": {- "user_id": "user_123456789",- "toolkits": {- "enable": [- "gmail",- "slack",- "github"- ]- },- "auth_configs": {- "gmail": "ac_1223434343",- "slack": "ac_23343434343434"- },- "connected_accounts": {- "github": "ca_34454545454545"- },- "manage_connections": {- "enable": true,- "callback_url": "https://your-app.com/auth/callback"- },- "tools": {- "gmail": {- "enable": [- "GMAIL_SEND_EMAIL",- "GMAIL_FETCH_EMAILS"- ]- },- "slack": {- "disable": [- "SLACK_ADD_EMOJI"- ]- },- "slack_bot": {- "tags": [- "destructiveHint"- ]- }- },- "tags": [- "destructiveHint",- "idempotentHint"- ],- "workbench": {- "enable_proxy_execution": true,- "auto_offload_threshold": 10000- }- }- },- "Session with disabled toolkits and global tags": {- "value": {- "user_id": "user_123456789",- "toolkits": {- "disable": [- "gmail"- ]- },- "tags": [- "readOnlyHint"- ]- }+ },+ "required": [+ "id",+ "instance_id",+ "mcp_server_id",+ "created_at",+ "updated_at"+ ],+ "description": "MCP server instance details"+ }+ }+ }+ },+ "400": {+ "description": "Bad request. The request parameters may be invalid or the instance ID already exists.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "401": {+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "403": {+ "description": "Forbidden. The user does not have connected accounts for all required auth configurations.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "404": {+ "description": "MCP server not found. No server with the specified ID exists.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "409": {+ "description": "Conflict. An instance with this ID already exists for the server.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "500": {+ "description": "Internal server error. An unexpected error occurred while processing the request.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"}}}}- },+ }+ }+ },+ "/api/v3/mcp/servers/{serverId}/instances/{instanceId}": {+ "delete": {+ "summary": "Delete an MCP server instance and associated connected accounts",+ "description": "Removes a user instance from the MCP server and deletes all connected accounts for that user that are associated with the auth configurations of this specific MCP server. Connected accounts for other auth configurations are not affected.",+ "tags": [+ "MCP"+ ],+ "operationId": "deleteMcpServersByServerIdInstancesByInstanceId",+ "security": [+ {+ "ApiKeyAuth": []+ },+ {+ "UserApiKeyAuth": []+ }+ ],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "description": "UUID of the MCP server",+ "example": "550e8400-e29b-41d4-a716-446655440000"+ },+ "required": true,+ "description": "The ID of the MCP server",+ "name": "serverId",+ "in": "path"+ },+ {+ "schema": {+ "type": "string",+ "description": "The user ID to remove from this server",+ "example": "user_123456"+ },+ "required": true,+ "description": "The instance ID (user ID) to delete",+ "name": "instanceId",+ "in": "path"+ }+ ],"responses": {- "201": {- "description": "Session successfully created. Returns the session ID and MCP server URL for the created session.",+ "200": {+ "description": "Successfully deleted MCP server instance and associated connected accounts.","content": {"application/json": {"schema": {"type": "object","properties": {- "session_id": {- "type": "string",- "format": "toolRouterSessionId",- "description": "The identifier of the session",- "example": "trs_123456789"- },- "mcp": {- "type": "object",- "properties": {- "type": {- "type": "string",- "enum": [- "http"- ],- "description": "The type of the MCP server. Can be http"- },- "url": {- "type": "string",- "format": "uri",- "description": "The URL of the MCP server",- "example": "https://app.composio.dev/tool_router/v3/trs_123456789/mcp"- }- },- "required": [- "type",- "url"- ]- },- "tool_router_tools": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of available tools in this session"+ "message": {+ "type": "string"},- "config": {- "type": "object",- "properties": {- "user_id": {- "type": "string",- "description": "User identifier for this session"- },- "toolkits": {- "anyOf": [- {- "type": "object",- "properties": {- "enabled": {- "type": "array",- "items": {- "type": "string"- }- }- },- "required": [- "enabled"- ],- "additionalProperties": false- },- {- "type": "object",- "properties": {- "disabled": {- "type": "array",- "items": {- "type": "string"- }- }- },- "required": [- "disabled"- ],- "additionalProperties": false- }- ],- "description": "Toolkit configuration - either enabled list or disabled list"- },- "auth_configs": {- "type": "object",- "additionalProperties": {+ "deleted_connected_accounts": {+ "type": "number"+ }+ },+ "required": [+ "message",+ "deleted_connected_accounts"+ ]+ }+ }+ }+ },+ "400": {+ "description": "Bad request. The request parameters may be invalid.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "401": {+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "404": {+ "description": "MCP server or instance not found.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "500": {+ "description": "Internal server error. An unexpected error occurred while processing the request.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ }+ }+ }+ },+ "/api/v3/files/list": {+ "get": {+ "summary": "List files with optional app and action filters",+ "description": "Retrieves a list of files associated with the authenticated project. Results can be filtered by toolkit and tool slugs.",+ "tags": [+ "Files"+ ],+ "operationId": "getFilesList",+ "security": [+ {+ "ApiKeyAuth": []+ },+ {+ "UserApiKeyAuth": []+ }+ ],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "description": "Filter files by app slug. Example: \"file-converter\""+ },+ "required": false,+ "description": "Filter files by app slug. Example: \"file-converter\"",+ "name": "toolkit_slug",+ "in": "query"+ },+ {+ "schema": {+ "type": "string",+ "description": "Filter files by action slug. Example: \"convert-to-pdf\""+ },+ "required": false,+ "description": "Filter files by action slug. Example: \"convert-to-pdf\"",+ "name": "tool_slug",+ "in": "query"+ },+ {+ "schema": {+ "type": "number",+ "nullable": true+ },+ "required": false,+ "description": "Number of items per page, max allowed is 1000",+ "name": "limit",+ "in": "query"+ },+ {+ "schema": {+ "type": "string"+ },+ "required": false,+ "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.",+ "name": "cursor",+ "in": "query"+ }+ ],+ "responses": {+ "200": {+ "description": "Successfully retrieved files",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "items": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "toolkit_slug": {"type": "string",- "format": "authConfigId"+ "description": "Slug of the app where this file belongs to. Example: \"file-converter\""},- "description": "Auth config overrides per toolkit"- },- "connected_accounts": {- "type": "object",- "additionalProperties": {+ "tool_slug": {"type": "string",- "format": "connectedAccountId"+ "description": "Slug of the action where this file belongs to. Example: \"convert-to-pdf\""},- "description": "Connected account overrides per toolkit"- },- "manage_connections": {- "type": "object",- "properties": {- "enabled": {- "type": "boolean",- "default": true,- "description": "Whether to enable the connection manager for automatic connection handling"- },- "callback_url": {- "type": "string",- "format": "uri",- "description": "Custom callback URL for connected account auth flows"- },- "enable_wait_for_connections": {- "type": "boolean",- "default": false,- "description": "Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status. Default false. May not work reliably with GPT models."- },- "enable_connection_removal": {- "type": "boolean",- "default": true,- "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS. Default true."- }+ "filename": {+ "type": "string",+ "description": "Name of the original file. Example: \"document.docx\""},- "description": "Manage connections configuration"+ "mimetype": {+ "type": "string",+ "description": "Mime type of the original file. Example: \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\""+ },+ "md5": {+ "type": "string",+ "description": "MD5 hash of the file for integrity verification. Example: \"d41d8cd98f00b204e9800998ecf8427e\""+ }},- "tools": {- "type": "object",- "additionalProperties": {- "anyOf": [- {- "type": "object",- "properties": {- "enabled": {- "type": "array",- "items": {- "type": "string"- }- }- },- "required": [- "enabled"- ],- "additionalProperties": false- },- {- "type": "object",- "properties": {- "disabled": {- "type": "array",- "items": {- "type": "string"- }- }- },- "required": [- "disabled"- ],- "additionalProperties": false- },- {- "type": "object",- "properties": {- "tags": {- "type": "object",- "properties": {- "enabled": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must have at least one of"- },- "disabled": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must NOT have any of"- }- }- }- },- "required": [- "tags"- ],- "additionalProperties": false- }- ]- },- "description": "Tool-level configuration per toolkit"- },- "tags": {- "type": "object",- "properties": {- "enabled": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must have at least one of"- },- "disabled": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must NOT have any of"- }- },- "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."- },- "workbench": {- "type": "object",- "properties": {- "enable": {- "type": "boolean",- "description": "Whether the workbench (code execution sandbox) is enabled. When false, COMPOSIO_REMOTE_WORKBENCH and COMPOSIO_REMOTE_BASH_TOOL are not exposed."- },- "proxy_execution_enabled": {- "type": "boolean",- "description": "Whether proxy execution is enabled in the workbench"- },- "auto_offload_threshold": {- "type": "number",- "minimum": 0,- "exclusiveMinimum": true,- "description": "Character threshold after which tool execution response are saved to a file in workbench. Default is 20k."- }- },- "default": {- "enable": true,- "proxy_execution_enabled": true- },- "description": "Workbench configuration"- }- },- "required": [- "user_id"- ],- "description": "The session configuration including user, toolkits, and overrides"+ "required": [+ "toolkit_slug",+ "tool_slug",+ "filename",+ "mimetype",+ "md5"+ ]+ }},- "experimental": {- "type": "object",- "properties": {- "assistive_prompt": {- "type": "string",- "description": "The assistive system prompt for the tool router session"- },- "custom_toolkits": {- "type": "array",- "items": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "minLength": 1,- "pattern": "^[a-zA-Z0-9_-]+$"- },- "name": {- "type": "string",- "minLength": 1,- "maxLength": 128- },- "description": {- "type": "string",- "minLength": 1,- "maxLength": 2048- },- "tools": {- "type": "array",- "items": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "description": "Prefixed tool slug (e.g. LOCAL_CRM_FIND_CUSTOMER)"- },- "name": {- "type": "string",- "minLength": 1,- "maxLength": 128- },- "description": {- "type": "string",- "minLength": 1,- "maxLength": 5120- },- "input_schema": {- "type": "object",- "additionalProperties": {}- },- "output_schema": {- "type": "object",- "additionalProperties": {}- },- "original_slug": {- "type": "string",- "description": "Original tool slug as provided by the user"- }- },- "required": [- "slug",- "name",- "description",- "input_schema",- "original_slug"- ]- }- }- },- "required": [- "slug",- "name",- "description",- "tools"- ]- },- "description": "User-defined custom toolkits with grouped tools (no-auth)"- },- "custom_tools": {- "type": "array",- "items": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "description": "Prefixed tool slug (e.g. LOCAL_GMAIL_GET_IMPORTANT_EMAILS)"- },- "name": {- "type": "string",- "minLength": 1,- "maxLength": 128- },- "description": {- "type": "string",- "minLength": 1,- "maxLength": 5120- },- "input_schema": {- "type": "object",- "additionalProperties": {}- },- "output_schema": {- "type": "object",- "additionalProperties": {}- },- "extends_toolkit": {- "type": "string",- "minLength": 1- },- "original_slug": {- "type": "string",- "description": "Original tool slug as provided by the user"- }- },- "required": [- "slug",- "name",- "description",- "input_schema",- "original_slug"- ]- },- "description": "Custom tools — standalone or extending Composio toolkits"- }- },- "description": "Experimental features including the generated system prompt. Only returned on session creation, not on GET.",- "x-experimental": true+ "next_cursor": {+ "type": "string",+ "nullable": true+ },+ "total_pages": {+ "type": "number"+ },+ "current_page": {+ "type": "number"+ },+ "total_items": {+ "type": "number"}},"required": [- "session_id",- "mcp",- "tool_router_tools",- "config"+ "items",+ "total_pages",+ "current_page",+ "total_items"]}}}},"400": {- "description": "Bad request. This may occur if the user_id format is invalid, toolkit names are invalid, or auth_config_id IDs are malformed.",+ "description": "Bad request","content": {"application/json": {"schema": {@@ -14449,7 +14586,7 @@}},"401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -14458,8 +14595,8 @@}}},- "403": {- "description": "Forbidden. The user is not authorized to create a tool router session.",+ "404": {+ "description": "Not found","content": {"application/json": {"schema": {@@ -14469,7 +14606,7 @@}},"500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -14481,37 +14618,20 @@}}},- "/api/v3/tool_router/session/{session_id}/execute": {+ "/api/v3/files/upload/request": {"post": {- "summary": "Execute a tool within a tool router session",- "description": "Executes a specific tool within a tool router session. The toolkit is automatically inferred from the tool slug. The tool must belong to an allowed toolkit and must not be disabled in the session configuration. This endpoint validates permissions, resolves connected accounts, and executes the tool with the session context.",+ "summary": "Create presigned URL for request file upload to S3",+ "description": "Generates a presigned URL for uploading a file to S3. This endpoint handles deduplication by checking if a file with the same MD5 hash already exists.","tags": [- "Tool Router"+ "Files"],- "operationId": "postToolRouterSessionBySessionIdExecute",+ "operationId": "postFilesUploadRequest","security": [{"ApiKeyAuth": []},{"UserApiKeyAuth": []- },- {- "workbench_access_key": []- }- ],- "parameters": [- {- "schema": {- "type": "string",- "format": "toolRouterSessionId",- "description": "The unique identifier of the tool router session. Required for public API endpoints, optional for internal endpoints where it is injected by middleware.",- "example": "trs_LX9uJKBinWWr"- },- "required": false,- "description": "Tool router session ID (required for public API, optional for internal - injected by middleware)",- "name": "session_id",- "in": "path"}],"requestBody": {@@ -14520,78 +14640,149 @@"schema": {"type": "object","properties": {+ "toolkit_slug": {+ "type": "string",+ "description": "Slug of the app where this file belongs to. Example: \"gmail\", \"slack\", \"github\""+ },"tool_slug": {"type": "string",- "minLength": 1,- "description": "The unique slug identifier of the tool to execute",- "example": "GITHUB_CREATE_ISSUE"+ "description": "Slug of the action where this file belongs to. Example: \"GMAIL_SEND_EMAIL\", \"SLACK_UPLOAD_FILE\""},- "arguments": {- "type": "object",- "additionalProperties": {},- "default": {},- "description": "The arguments required by the tool",- "example": {- "repository": "octocat/Hello-World",- "workflow_id": "main.yml",- "ref": "main",- "inputs": {- "environment": "production"- }- }+ "filename": {+ "type": "string",+ "description": "Name of the original file. Example: \"quarterly_report.pdf\""},- "account": {+ "mimetype": {"type": "string",- "description": "Account identifier to specify which connected account to use. 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.",- "example": "coup_hurricane_dal_analytical"+ "description": "Mime type of the original file. Example: \"application/pdf\", \"image/png\""+ },+ "md5": {+ "type": "string",+ "description": "MD5 hash of the file for deduplication and integrity verification. Example: \"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6\""}},"required": [- "tool_slug"+ "toolkit_slug",+ "tool_slug",+ "filename",+ "mimetype",+ "md5"]+ },+ "examples": {+ "Gmail Email Attachment": {+ "value": {+ "toolkit_slug": "gmail",+ "tool_slug": "GMAIL_SEND_EMAIL",+ "filename": "quarterly_report.pdf",+ "mimetype": "application/pdf",+ "md5": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"+ }+ },+ "Slack File Upload": {+ "value": {+ "toolkit_slug": "slack",+ "tool_slug": "SLACK_SEND_MESSAGE",+ "filename": "meeting_notes.docx",+ "mimetype": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",+ "md5": "b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7"+ }+ },+ "GitHub Issue Screenshot": {+ "value": {+ "toolkit_slug": "github",+ "tool_slug": "GITHUB_CREATE_AN_ISSUE",+ "filename": "bug_screenshot.png",+ "mimetype": "image/png",+ "md5": "c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8"+ }+ },+ "Notion Page Image": {+ "value": {+ "toolkit_slug": "notion",+ "tool_slug": "NOTION_ADD_PAGE_CONTENT",+ "filename": "diagram.svg",+ "mimetype": "image/svg+xml",+ "md5": "d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9"+ }+ },+ "Jira Attachment": {+ "value": {+ "toolkit_slug": "jira",+ "tool_slug": "JIRA_ADD_ATTACHMENT",+ "filename": "error_logs.txt",+ "mimetype": "text/plain",+ "md5": "e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"+ }+ }}}}},"responses": {"200": {- "description": "Successfully executed the tool. Returns execution result, logs, and status.",+ "description": "Successfully created upload URL for request file","content": {"application/json": {"schema": {"type": "object","properties": {- "data": {- "type": "object",- "additionalProperties": {},- "description": "The data returned by the tool execution",- "example": {- "message": "Hello, World!",- "status": "success"- }+ "id": {+ "type": "string",+ "description": "ID of the request file. Example: \"req_file_9mZn4qR8sXwT\""},- "error": {+ "key": {"type": "string",- "nullable": true,- "description": "Error message if the execution failed, null otherwise"+ "description": "Object storage upload location. Example: \"projects/prj_xyz789/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx\""},- "log_id": {+ "new_presigned_url": {"type": "string",- "description": "Unique identifier for the execution log",- "example": "log_abc123xyz"+ "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...\""+ },+ "newPresignedUrl": {+ "type": "string",+ "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...\"",+ "deprecated": true+ },+ "type": {+ "type": "string",+ "enum": [+ "new"+ ],+ "description": "[DEPRECATED] Indicates this is a new file that needs to be uploaded",+ "deprecated": true+ },+ "metadata": {+ "type": "object",+ "properties": {+ "storage_backend": {+ "type": "string",+ "enum": [+ "s3",+ "azure_blob_storage"+ ],+ "description": "Storage backend used for the file. If this is azure, use `x-ms-blob-type` header to set the blob type to `BlockBlob` while uploading the file"+ }+ },+ "required": [+ "storage_backend"+ ]}},"required": [- "data",- "error",- "log_id"+ "id",+ "key",+ "new_presigned_url",+ "newPresignedUrl",+ "type",+ "metadata"]}}}},"400": {- "description": "Bad request",+ "description": "Bad Request","content": {"application/json": {"schema": {@@ -14621,7 +14812,7 @@}},"404": {- "description": "Not found",+ "description": "Not Found","content": {"application/json": {"schema": {@@ -14630,8 +14821,18 @@}}},- "413": {- "description": "Payload too large",+ "410": {+ "description": "Gone",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "429": {+ "description": "Too Many Requests","content": {"application/json": {"schema": {@@ -14641,7 +14842,17 @@}},"500": {- "description": "Internal server error",+ "description": "Internal Server Error",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "501": {+ "description": "Not Implemented","content": {"application/json": {"schema": {@@ -14653,14 +14864,14 @@}}},- "/api/v3/tool_router/session/{session_id}/execute_meta": {- "post": {- "summary": "Execute a meta tool within a tool router session",- "description": "Executes a Composio meta tool (COMPOSIO_*) within a tool router session.",+ "/api/v3/migration/get-nanoid": {+ "get": {+ "summary": "Get NanoId from UUID",+ "description": "Convert a legacy UUID to its corresponding NanoId for migration purposes. This endpoint facilitates the transition from UUID-based identifiers to the more compact NanoId format used in the v3 API.","tags": [- "Tool Router"+ "Migration"],- "operationId": "postToolRouterSessionBySessionIdExecuteMeta",+ "operationId": "getMigrationGetNanoid","security": [{"ApiKeyAuth": []@@ -14673,97 +14884,65 @@{"schema": {"type": "string",- "format": "toolRouterSessionId",- "description": "The unique identifier of the tool router session. Required for public API endpoints, optional for internal endpoints where it is injected by middleware.",- "example": "trs_LX9uJKBinWWr"+ "format": "uuid",+ "example": "123e4567-e89b-12d3-a456-426614174000"},- "required": false,- "description": "Tool router session ID (required for public API, optional for internal - injected by middleware)",- "name": "session_id",- "in": "path"- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "enum": [- "COMPOSIO_SEARCH_TOOLS",- "COMPOSIO_MULTI_EXECUTE_TOOL",- "COMPOSIO_MANAGE_CONNECTIONS",- "COMPOSIO_WAIT_FOR_CONNECTIONS",- "COMPOSIO_REMOTE_WORKBENCH",- "COMPOSIO_REMOTE_BASH_TOOL",- "COMPOSIO_GET_TOOL_SCHEMAS",- "COMPOSIO_UPSERT_RECIPE",- "COMPOSIO_GET_RECIPE"- ],- "description": "The unique slug identifier of the meta tool to execute",- "example": "COMPOSIO_MANAGE_CONNECTIONS"- },- "arguments": {- "type": "object",- "additionalProperties": {},- "default": {},- "description": "The arguments required by the meta tool",- "example": {- "toolkits": [- "github"- ],- "reinitiate_all": false- }- }- },- "required": [- "slug"- ]- }- }+ "required": true,+ "description": "The legacy UUID that needs to be converted to a NanoId",+ "name": "uuid",+ "in": "query"+ },+ {+ "schema": {+ "type": "string",+ "enum": [+ "CONNECTED_ACCOUNT",+ "AUTH_CONFIG",+ "TRIGGER_INSTANCE"+ ],+ "example": "CONNECTED_ACCOUNT"+ },+ "required": true,+ "description": "The type of resource that the UUID belongs to",+ "name": "type",+ "in": "query"+ },+ {+ "schema": {+ "type": "string",+ "description": "Your Composio API key used for authentication",+ "example": "sk_123456789abcdef"+ },+ "required": true,+ "name": "x-api-key",+ "in": "header"}- },+ ],"responses": {"200": {- "description": "Successfully executed the meta tool. Returns execution result, logs, and status.",+ "description": "Successfully retrieved NanoId for the given UUID","content": {"application/json": {"schema": {"type": "object","properties": {- "data": {- "type": "object",- "additionalProperties": {},- "description": "The data returned by the tool execution",- "example": {- "message": "Hello, World!",- "status": "success"- }- },- "error": {- "type": "string",- "nullable": true,- "description": "Error message if the execution failed, null otherwise"- },- "log_id": {+ "nanoid": {"type": "string",- "description": "Unique identifier for the execution log",- "example": "log_abc123xyz"+ "minLength": 10,+ "maxLength": 10,+ "description": "The NanoId corresponding to the provided UUID. This is the new identifier that should be used in place of the legacy UUID.",+ "example": "XqXrPalt3v"}},"required": [- "data",- "error",- "log_id"+ "nanoid"]}}}},"400": {- "description": "Bad request",+ "description": "Bad Request - Invalid UUID or resource not found","content": {"application/json": {"schema": {@@ -14773,17 +14952,7 @@}},"401": {- "description": "Unauthorized",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "403": {- "description": "Forbidden",+ "description": "Unauthorized - Invalid or missing API key","content": {"application/json": {"schema": {@@ -14793,7 +14962,7 @@}},"404": {- "description": "Not found",+ "description": "Not Found - The UUID does not correspond to any resource of the specified type","content": {"application/json": {"schema": {@@ -14802,8 +14971,8 @@}}},- "413": {- "description": "Payload too large",+ "410": {+ "description": "Gone - The UUID does not correspond to any resource of the specified type","content": {"application/json": {"schema": {@@ -14813,7 +14982,7 @@}},"500": {- "description": "Internal server error",+ "description": "Internal server error - An unexpected error occurred during processing","content": {"application/json": {"schema": {@@ -14825,14 +14994,14 @@}}},- "/api/v3/tool_router/session/{session_id}": {- "get": {- "summary": "Get a tool router session by ID",- "description": "Retrieves an existing tool router session by its ID. Returns the session configuration, MCP server URL, and available tools.",+ "/api/v3/tool_router/session": {+ "post": {+ "summary": "Create a new tool router session",+ "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.","tags": ["Tool Router"],- "operationId": "getToolRouterSessionBySessionId",+ "operationId": "postToolRouterSession","security": [{"ApiKeyAuth": []@@ -14841,1090 +15010,1152 @@"UserApiKeyAuth": []}],- "parameters": [- {- "schema": {- "type": "string",- "format": "toolRouterSessionId",- "description": "The session ID returned when creating the session",- "example": "trs_123456789"- },- "required": true,- "description": "The unique identifier of the tool router session",- "name": "session_id",- "in": "path"- }- ],- "responses": {- "200": {- "description": "Session successfully retrieved. Returns the session details including configuration.",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "session_id": {- "type": "string",- "format": "toolRouterSessionId",- "description": "The identifier of the session",- "example": "trs_123456789"- },- "mcp": {- "type": "object",- "properties": {- "type": {- "type": "string",- "enum": [- "http"- ],- "description": "The type of the MCP server. Can be http"+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "user_id": {+ "type": "string",+ "minLength": 1,+ "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",+ "example": "user_123456789"+ },+ "toolkits": {+ "anyOf": [+ {+ "type": "object",+ "properties": {+ "enable": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Only these specific toolkits will be enabled",+ "example": [+ "gmail",+ "slack",+ "github"+ ]+ }},- "url": {- "type": "string",- "format": "uri",- "description": "The URL of the MCP server",- "example": "https://app.composio.dev/tool_router/v3/trs_123456789/mcp"- }- },- "required": [- "type",- "url"- ]- },- "tool_router_tools": {- "type": "array",- "items": {- "type": "string"+ "required": [+ "enable"+ ],+ "additionalProperties": false,+ "description": "Enable only specific toolkits (allowlist)"},- "description": "List of available tools in this session"- },- "config": {- "type": "object",- "properties": {- "user_id": {- "type": "string",- "description": "User identifier for this session"- },- "toolkits": {- "anyOf": [- {- "type": "object",- "properties": {- "enabled": {- "type": "array",- "items": {- "type": "string"- }- }- },- "required": [- "enabled"- ],- "additionalProperties": false+ {+ "type": "object",+ "properties": {+ "disable": {+ "type": "array",+ "items": {+ "type": "string"},- {- "type": "object",- "properties": {- "disabled": {- "type": "array",- "items": {- "type": "string"- }- }- },- "required": [- "disabled"- ],- "additionalProperties": false- }- ],- "description": "Toolkit configuration - either enabled list or disabled list"+ "description": "These specific toolkits will be disabled",+ "example": [+ "gmail",+ "slack"+ ]+ }},- "auth_configs": {- "type": "object",- "additionalProperties": {- "type": "string",- "format": "authConfigId"- },- "description": "Auth config overrides per toolkit"- },- "connected_accounts": {+ "required": [+ "disable"+ ],+ "additionalProperties": false,+ "description": "Disable specific toolkits (denylist)"+ }+ ],+ "description": "Toolkit configuration - specify either enable toolkits (allowlist) or disable toolkits (denylist). Mutually exclusive."+ },+ "auth_configs": {+ "type": "object",+ "additionalProperties": {+ "type": "string",+ "format": "authConfigId"+ },+ "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",+ "example": {+ "gmail": "ac_1a2b3c4d5e6f",+ "slack": "ac_7g8h9i0j1k2l"+ }+ },+ "connected_accounts": {+ "type": "object",+ "additionalProperties": {+ "type": "string",+ "format": "connectedAccountId"+ },+ "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",+ "example": {+ "github": "ca_3m4n5o6p7q8r"+ }+ },+ "manage_connections": {+ "type": "object",+ "properties": {+ "enable": {+ "type": "boolean",+ "nullable": true,+ "default": true,+ "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.",+ "example": true+ },+ "callback_url": {+ "type": "string",+ "format": "uri",+ "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.",+ "example": "https://your-app.com/auth/callback"+ },+ "enable_wait_for_connections": {+ "type": "boolean",+ "nullable": true,+ "default": false,+ "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.",+ "example": false+ },+ "enable_connection_removal": {+ "type": "boolean",+ "nullable": true,+ "default": true,+ "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS to allow deleting connected accounts. Default true."+ }+ },+ "default": {+ "enable": true,+ "enable_wait_for_connections": false,+ "enable_connection_removal": true+ },+ "additionalProperties": false,+ "description": "Configuration for connection management settings"+ },+ "tools": {+ "type": "object",+ "additionalProperties": {+ "anyOf": [+ {"type": "object",- "additionalProperties": {- "type": "string",- "format": "connectedAccountId"+ "properties": {+ "enable": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Only these specific tools will be available for this toolkit",+ "example": [+ "GMAIL_SEND_EMAIL",+ "GMAIL_FETCH_EMAILS"+ ]+ }},- "description": "Connected account overrides per toolkit"+ "required": [+ "enable"+ ],+ "additionalProperties": false},- "manage_connections": {+ {"type": "object","properties": {- "enabled": {- "type": "boolean",- "default": true,- "description": "Whether to enable the connection manager for automatic connection handling"- },- "callback_url": {- "type": "string",- "format": "uri",- "description": "Custom callback URL for connected account auth flows"- },- "enable_wait_for_connections": {- "type": "boolean",- "default": false,- "description": "Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status. Default false. May not work reliably with GPT models."- },- "enable_connection_removal": {- "type": "boolean",- "default": true,- "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS. Default true."+ "disable": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "These specific tools will be disabled for this toolkit",+ "example": [+ "SLACK_ADD_EMOJI"+ ]}},- "description": "Manage connections configuration"+ "required": [+ "disable"+ ],+ "additionalProperties": false},- "tools": {+ {"type": "object",- "additionalProperties": {- "anyOf": [- {- "type": "object",- "properties": {- "enabled": {- "type": "array",- "items": {- "type": "string"- }- }- },- "required": [- "enabled"- ],- "additionalProperties": false- },- {- "type": "object",- "properties": {- "disabled": {- "type": "array",- "items": {- "type": "string"- }+ "properties": {+ "tags": {+ "anyOf": [+ {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]}},- "required": [- "disabled"- ],- "additionalProperties": false- },- {- "type": "object",- "properties": {- "tags": {- "type": "object",- "properties": {- "enabled": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must have at least one of"+ {+ "type": "object",+ "properties": {+ "enable": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]},- "disabled": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must NOT have any of"- }+ "description": "Tags that the tool must have at least one of"+ },+ "disable": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]+ },+ "description": "Tags that the tool must NOT have any of"}}- },- "required": [- "tags"+ }+ ],+ "description": "MCP tags to filter tools. Array format is treated as enabled list. Object format supports both enabled and disabled lists.",+ "example": {+ "enable": [+ "openWorldHint"],- "additionalProperties": false+ "disable": [+ "destructiveHint"+ ]}- ]+ }},- "description": "Tool-level configuration per toolkit"- },- "tags": {- "type": "object",- "properties": {- "enabled": {- "type": "array",- "items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"- ]- },- "description": "Tags that the tool must have at least one of"+ "required": [+ "tags"+ ],+ "additionalProperties": false+ }+ ]+ },+ "description": "Tool-level configuration per toolkit - either specify enable tools (whitelist), disable tools (blacklist), or filter by MCP tags for each toolkit",+ "example": {+ "gmail": {+ "enable": [+ "GMAIL_SEND_EMAIL",+ "GMAIL_FETCH_EMAILS"+ ]+ },+ "slack": {+ "disable": [+ "SLACK_ADD_EMOJI"+ ]+ },+ "slack_bot": {+ "tags": {+ "enable": [+ "destructiveHint"+ ],+ "disable": [+ "openWorldHint"+ ]+ }+ }+ }+ },+ "tags": {+ "anyOf": [+ {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]+ }+ },+ {+ "type": "object",+ "properties": {+ "enable": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]},- "disabled": {+ "description": "Tags that the tool must have at least one of"+ },+ "disable": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]+ },+ "description": "Tags that the tool must NOT have any of"+ }+ }+ }+ ],+ "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.",+ "example": {+ "enable": [+ "openWorldHint"+ ],+ "disable": [+ "destructiveHint"+ ]+ }+ },+ "workbench": {+ "type": "object",+ "properties": {+ "enable": {+ "type": "boolean",+ "default": true,+ "description": "Set to false to disable the workbench entirely. When disabled, no code execution tools are available in the session.",+ "example": true+ },+ "enable_proxy_execution": {+ "type": "boolean",+ "default": true,+ "description": "Whether proxy execution is enabled. When enabled, workbench can call URLs and APIs directly.",+ "example": true+ },+ "auto_offload_threshold": {+ "type": "number",+ "minimum": 0,+ "exclusiveMinimum": true,+ "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.",+ "example": 20000+ }+ },+ "default": {+ "enable": true,+ "enable_proxy_execution": true+ },+ "additionalProperties": false,+ "description": "Configuration for workbench behavior"+ },+ "multi_account": {+ "type": "object",+ "properties": {+ "enable": {+ "type": "boolean",+ "description": "When true, enables multi-account mode for this session. When not set, falls back to org/project-level configuration.",+ "example": true+ },+ "max_accounts_per_toolkit": {+ "type": "integer",+ "minimum": 2,+ "maximum": 10,+ "description": "Maximum number of connected accounts allowed per toolkit. Must be between 2 and 10.",+ "example": 5+ },+ "require_explicit_selection": {+ "type": "boolean",+ "description": "When true, the agent must explicitly select which account to use. When false (default), the first/default account is used automatically.",+ "example": false+ }+ },+ "additionalProperties": false,+ "description": "Configure multi-account behavior. When enabled, users can connect multiple accounts per toolkit."+ },+ "experimental": {+ "type": "object",+ "properties": {+ "assistive_prompt_config": {+ "type": "object",+ "properties": {+ "user_timezone": {+ "type": "string",+ "description": "IANA timezone identifier (e.g., 'America/New_York', 'Europe/London'). Used to customize the system prompt with timezone-aware instructions.",+ "example": "America/New_York"+ }+ },+ "additionalProperties": false,+ "description": "Customize assistive prompt generation (e.g., timezone)."+ },+ "custom_toolkits": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "minLength": 1,+ "pattern": "^[a-zA-Z0-9_-]+$",+ "description": "Unique slug for the toolkit. Must not conflict with existing Composio toolkit slugs. Alphanumeric, underscores, and hyphens only.",+ "example": "ecommerce"+ },+ "name": {+ "type": "string",+ "minLength": 1,+ "maxLength": 128,+ "description": "Display name shown to the LLM and in search results.",+ "example": "E-Commerce API"+ },+ "description": {+ "type": "string",+ "minLength": 1,+ "maxLength": 2048,+ "description": "Used for BM25 search matching and shown in toolkit connection statuses.",+ "example": "Internal e-commerce API for order management and fulfillment"+ },+ "tools": {"type": "array","items": {- "type": "string",- "enum": [- "readOnlyHint",- "destructiveHint",- "idempotentHint",- "openWorldHint"+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "minLength": 1,+ "pattern": "^[a-zA-Z0-9_-]+$",+ "description": "Tool slug. Combined with toolkit slug to form LOCAL_<TOOLKIT>_<TOOL> (max 60 chars total).",+ "example": "GET_CUSTOMER_ORDERS"+ },+ "name": {+ "type": "string",+ "minLength": 1,+ "maxLength": 128,+ "description": "Human-readable display name",+ "example": "Get Customer Orders"+ },+ "description": {+ "type": "string",+ "minLength": 1,+ "maxLength": 5120,+ "description": "Used for BM25 search matching and shown to the LLM.",+ "example": "Fetch recent orders for a customer by their email address"+ },+ "input_schema": {+ "type": "object",+ "additionalProperties": {},+ "description": "Must have type: \"object\" and a properties field.",+ "example": {+ "type": "object",+ "properties": {+ "email": {+ "type": "string",+ "description": "Customer email"+ }+ },+ "required": [+ "email"+ ]+ }+ },+ "output_schema": {+ "type": "object",+ "additionalProperties": {},+ "description": "Optional output schema for the tool response."+ }+ },+ "required": [+ "slug",+ "name",+ "description",+ "input_schema"]},- "description": "Tags that the tool must NOT have any of"+ "minItems": 1,+ "maxItems": 100,+ "description": "Tools in this custom toolkit"}},- "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."+ "required": [+ "slug",+ "name",+ "description",+ "tools"+ ]},- "workbench": {+ "description": "Custom toolkits with grouped tools. Toolkit slugs must not conflict with existing Composio toolkits. All tools are no-auth."+ },+ "custom_tools": {+ "type": "array",+ "items": {"type": "object","properties": {- "enable": {- "type": "boolean",- "description": "Whether the workbench (code execution sandbox) is enabled. When false, COMPOSIO_REMOTE_WORKBENCH and COMPOSIO_REMOTE_BASH_TOOL are not exposed."+ "slug": {+ "type": "string",+ "minLength": 1,+ "pattern": "^[a-zA-Z0-9_-]+$",+ "description": "Tool slug. Forms LOCAL_<TOOL> (standalone) or LOCAL_<TOOLKIT>_<TOOL> (extending). Max 60 chars total.",+ "example": "GET_IMPORTANT_EMAILS"},- "proxy_execution_enabled": {- "type": "boolean",- "description": "Whether proxy execution is enabled in the workbench"+ "name": {+ "type": "string",+ "minLength": 1,+ "maxLength": 128,+ "description": "Human-readable display name",+ "example": "Get Important Emails"},- "auto_offload_threshold": {- "type": "number",- "minimum": 0,- "exclusiveMinimum": true,- "description": "Character threshold after which tool execution response are saved to a file in workbench. Default is 20k."- }- },- "default": {- "enable": true,- "proxy_execution_enabled": true- },- "description": "Workbench configuration"- }- },- "required": [- "user_id"- ],- "description": "The session configuration including user, toolkits, and overrides"- },- "experimental": {- "type": "object",- "properties": {- "assistive_prompt": {- "type": "string",- "description": "The assistive system prompt for the tool router session"- },- "custom_toolkits": {- "type": "array",- "items": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "minLength": 1,- "pattern": "^[a-zA-Z0-9_-]+$"- },- "name": {- "type": "string",- "minLength": 1,- "maxLength": 128- },- "description": {- "type": "string",- "minLength": 1,- "maxLength": 2048- },- "tools": {- "type": "array",- "items": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "description": "Prefixed tool slug (e.g. LOCAL_CRM_FIND_CUSTOMER)"- },- "name": {- "type": "string",- "minLength": 1,- "maxLength": 128- },- "description": {- "type": "string",- "minLength": 1,- "maxLength": 5120- },- "input_schema": {- "type": "object",- "additionalProperties": {}- },- "output_schema": {- "type": "object",- "additionalProperties": {}- },- "original_slug": {- "type": "string",- "description": "Original tool slug as provided by the user"- }- },- "required": [- "slug",- "name",- "description",- "input_schema",- "original_slug"- ]- }- }+ "description": {+ "type": "string",+ "minLength": 1,+ "maxLength": 5120,+ "description": "Used for BM25 search matching and shown to the LLM.",+ "example": "Fetch emails marked as important from the last 24 hours"},- "required": [- "slug",- "name",- "description",- "tools"- ]- },- "description": "User-defined custom toolkits with grouped tools (no-auth)"- },- "custom_tools": {- "type": "array",- "items": {- "type": "object",- "properties": {- "slug": {- "type": "string",- "description": "Prefixed tool slug (e.g. LOCAL_GMAIL_GET_IMPORTANT_EMAILS)"- },- "name": {- "type": "string",- "minLength": 1,- "maxLength": 128- },- "description": {- "type": "string",- "minLength": 1,- "maxLength": 5120- },- "input_schema": {- "type": "object",- "additionalProperties": {}- },- "output_schema": {+ "input_schema": {+ "type": "object",+ "additionalProperties": {},+ "description": "Must have type: \"object\" and a properties field.",+ "example": {"type": "object",- "additionalProperties": {}- },- "extends_toolkit": {- "type": "string",- "minLength": 1- },- "original_slug": {- "type": "string",- "description": "Original tool slug as provided by the user"+ "properties": {+ "limit": {+ "type": "number",+ "description": "Max results to return"+ }+ }}},- "required": [- "slug",- "name",- "description",- "input_schema",- "original_slug"- ]+ "output_schema": {+ "type": "object",+ "additionalProperties": {},+ "description": "JSON Schema describing tool output (optional)"+ },+ "extends_toolkit": {+ "type": "string",+ "minLength": 1,+ "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).",+ "example": "gmail"+ }},- "description": "Custom tools — standalone or extending Composio toolkits"- }- },- "description": "Experimental features",- "x-experimental": true+ "required": [+ "slug",+ "name",+ "description",+ "input_schema"+ ]+ },+ "description": "Custom tools to include in search. Standalone tools need no auth. Tools with extends_toolkit inherit the Composio toolkit's connection."+ }+ },+ "additionalProperties": false,+ "description": "Experimental features - not stable, may be modified or removed in future versions.",+ "x-experimental": true+ }+ },+ "required": [+ "user_id"+ ]+ },+ "examples": {+ "Session with all toolkits": {+ "value": {+ "user_id": "user_123456789"+ }+ },+ "Session with only specific toolkits": {+ "value": {+ "user_id": "user_123456789",+ "toolkits": {+ "enable": [+ "gmail",+ "slack"+ ]}- },- "required": [- "session_id",- "mcp",- "tool_router_tools",- "config"- ]- }- }- }- },- "400": {- "description": "Bad request. This may occur if the session_id format is invalid, please pass this in trs_ prefix format",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "404": {- "description": "Not found. The session with the provided ID does not exist or has been deleted.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- }- }- }- },- "/api/v3/tool_router/session/{session_id}/link": {- "post": {- "summary": "Create a link session for a toolkit in a tool router session",- "description": "Initiates an authentication link session for a specific toolkit within a tool router session. Returns a link token and redirect URL that users can use to complete the OAuth flow.",- "tags": [- "Tool Router"- ],- "operationId": "postToolRouterSessionBySessionIdLink",- "security": [- {- "ApiKeyAuth": []- },- {- "UserApiKeyAuth": []- }- ],- "parameters": [- {- "schema": {- "type": "string",- "format": "toolRouterSessionId",- "description": "The session ID returned when creating the session",- "example": "trs_LX9uJKBinWWr"- },- "required": true,- "description": "The unique identifier of the tool router session",- "name": "session_id",- "in": "path"- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "toolkit": {- "type": "string",- "minLength": 1,- "description": "The unique slug identifier of the toolkit to connect",- "example": "github"- },- "callback_url": {- "type": "string",- "format": "uri",- "description": "URL where users will be redirected after completing auth",- "example": "https://myapp.com/callback"}},- "required": [- "toolkit"- ]+ "Session with only specific toolkits disabled": {+ "value": {+ "user_id": "user_123456789",+ "toolkits": {+ "disable": [+ "gmail",+ "slack"+ ]+ }+ }+ },+ "Session with connection manager enabled": {+ "value": {+ "user_id": "user_123456789",+ "manage_connections": {+ "enable": true+ }+ }+ },+ "Session with connection manager and specific toolkits": {+ "value": {+ "user_id": "user_123456789",+ "toolkits": {+ "enable": [+ "gmail",+ "slack"+ ]+ },+ "manage_connections": {+ "enable": true+ }+ }+ },+ "Session with custom callback URL": {+ "value": {+ "user_id": "user_123456789",+ "toolkits": {+ "enable": [+ "github",+ "slack"+ ]+ },+ "manage_connections": {+ "enable": true,+ "callback_url": "https://your-app.com/auth/callback"+ }+ }+ },+ "Session with workbench configuration": {+ "value": {+ "user_id": "user_123456789",+ "toolkits": {+ "enable": [+ "gmail"+ ]+ },+ "workbench": {+ "enable_proxy_execution": true,+ "auto_offload_threshold": 10000+ }+ }+ },+ "Session with global tags filter": {+ "value": {+ "user_id": "user_123456789",+ "toolkits": {+ "enable": [+ "gmail",+ "slack"+ ]+ },+ "tags": [+ "readOnlyHint",+ "idempotentHint"+ ]+ }+ },+ "Session with auth config overrides": {+ "value": {+ "user_id": "user_123456789",+ "toolkits": {+ "enable": [+ "gmail",+ "slack"+ ]+ },+ "auth_configs": {+ "gmail": "ac_1a2b3c4d5e6f",+ "slack": "ac_7g8h9i0j1k2l"+ }+ }+ },+ "Session with connected account overrides": {+ "value": {+ "user_id": "user_123456789",+ "toolkits": {+ "enable": [+ "gmail",+ "slack"+ ]+ },+ "connected_accounts": {+ "gmail": "ca_1a2b3c4d5e6f",+ "slack": "ca_7g8h9i0j1k2l"+ }+ }+ },+ "Session with comprehensive configuration": {+ "value": {+ "user_id": "user_123456789",+ "toolkits": {+ "enable": [+ "gmail",+ "slack",+ "github"+ ]+ },+ "auth_configs": {+ "gmail": "ac_1a2b3c4d5e6f",+ "slack": "ac_7g8h9i0j1k2l"+ },+ "connected_accounts": {+ "github": "ca_3m4n5o6p7q8r"+ },+ "manage_connections": {+ "enable": true,+ "callback_url": "https://your-app.com/auth/callback"+ },+ "tools": {+ "gmail": {+ "enable": [+ "GMAIL_SEND_EMAIL",+ "GMAIL_FETCH_EMAILS"+ ]+ },+ "slack": {+ "disable": [+ "SLACK_ADD_EMOJI"+ ]+ },+ "slack_bot": {+ "tags": [+ "destructiveHint"+ ]+ }+ },+ "tags": [+ "destructiveHint",+ "idempotentHint"+ ],+ "workbench": {+ "enable_proxy_execution": true,+ "auto_offload_threshold": 10000+ }+ }+ },+ "Session with disabled toolkits and global tags": {+ "value": {+ "user_id": "user_123456789",+ "toolkits": {+ "disable": [+ "gmail"+ ]+ },+ "tags": [+ "readOnlyHint"+ ]+ }+ }}}}},"responses": {"201": {- "description": "Successfully created link session. Returns link token, redirect URL, and connected account ID.",+ "description": "Session successfully created. Returns the session ID and MCP server URL for the created session.","content": {"application/json": {"schema": {"type": "object","properties": {- "link_token": {- "type": "string",- "description": "Token used to complete the authentication flow",- "example": "lt_abc123xyz"- },- "redirect_url": {+ "session_id": {"type": "string",- "format": "uri",- "description": "The URL where users should be redirected to complete OAuth",- "example": "https://app.composio.dev/link/lt_abc123xyz"+ "format": "toolRouterSessionId",+ "description": "The identifier of the session",+ "example": "trs_123456789"},- "connected_account_id": {- "type": "string",- "format": "connectedAccountId",- "description": "The unique identifier for the connected account",- "example": "ca_abc123xyz"- }- },- "required": [- "link_token",- "redirect_url",- "connected_account_id"- ]- }- }- }- },- "400": {- "description": "Bad request. This may occur if the toolkit slug is invalid, request parameters are malformed, or a connected account is already defined for this toolkit in the session configuration.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "403": {- "description": "Forbidden. The session does not belong to the authenticated user.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "404": {- "description": "Not found. The session does not exist, toolkit not found, or no auth config exists for the toolkit.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "500": {- "description": "Internal server error. An unexpected error occurred while creating the link session.",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- }- }- }- },- "/api/v3/tool_router/session/{session_id}/proxy_execute": {- "post": {- "summary": "Execute proxy request within a tool router session",- "description": "Execute any native API call on a toolkit with authentication automatically injected from Composio. This endpoint proxies HTTP requests to third-party APIs using connected account credentials resolved from the session context. Provide the toolkit slug, API endpoint, and HTTP method — Composio handles authentication injection, abstracting away credential management. Supports all HTTP methods, custom headers/query parameters, and binary request/response bodies.",- "tags": [- "Tool Router"- ],- "operationId": "postToolRouterSessionBySessionIdProxyExecute",- "security": [- {- "ApiKeyAuth": []- },- {- "UserApiKeyAuth": []- },- {- "workbench_access_key": []- }- ],- "parameters": [- {- "schema": {- "type": "string",- "format": "toolRouterSessionId",- "description": "The unique identifier of the tool router session. Required for public API endpoints, optional for internal endpoints where it is injected by middleware.",- "example": "trs_LX9uJKBinWWr"- },- "required": false,- "description": "Tool router session ID (required for public API, optional for internal - injected by middleware)",- "name": "session_id",- "in": "path"- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "toolkit_slug": {- "type": "string",- "description": "The slug of the toolkit to use for the request",- "example": "gmail"- },- "endpoint": {- "type": "string",- "description": "The API endpoint to call (absolute URL or path relative to base URL of the connected account)",- "example": "/api/v1/resources"- },- "method": {- "type": "string",- "enum": [- "GET",- "POST",- "PUT",- "DELETE",- "PATCH",- "HEAD"- ],- "description": "The HTTP method to use for the request",- "example": "GET"- },- "body": {- "nullable": true,- "description": "The request body (for POST, PUT, and PATCH requests)",- "example": {- "name": "New Resource",- "description": "This is a new resource"- },- "type": "object"- },- "binary_body": {- "anyOf": [- {- "type": "object",- "properties": {- "url": {- "type": "string",- "format": "uri",- "description": "URL to fetch binary content from"- },- "content_type": {- "type": "string",- "description": "Content-Type header to use for the request"- }- },- "required": [- "url"- ]- },- {- "type": "object",- "properties": {- "base64": {- "type": "string",- "minLength": 1,- "description": "Base64-encoded binary data"- },- "content_type": {- "type": "string",- "description": "Content-Type header to use for the request"- }- },- "required": [- "base64"- ]- }- ],- "description": "Binary body to send. For binary upload via URL: use {url: \"https://...\", content_type?: \"...\"}. For binary upload via base64: use {base64: \"...\", content_type?: \"...\"}."- },- "parameters": {- "type": "array",- "items": {+ "mcp": {"type": "object","properties": {- "name": {- "type": "string",- "description": "Parameter name",- "example": "x-api-key"- },- "value": {- "type": "string",- "description": "Parameter value",- "example": "abc123def456"- },"type": {"type": "string","enum": [- "header",- "query"+ "http"],- "description": "Parameter type (header or query)",- "example": "header"+ "description": "The type of the MCP server. Can be http"+ },+ "url": {+ "type": "string",+ "format": "uri",+ "description": "The URL of the MCP server",+ "example": "https://app.composio.dev/tool_router/v3/trs_123456789/mcp"}},"required": [- "name",- "value",- "type"+ "type",+ "url"]},- "description": "Additional HTTP headers or query parameters to include in the request",- "example": [- {- "name": "x-api-key",- "value": "abc123def456",- "type": "header"- },- {- "name": "filter",- "value": "active",- "type": "query"- }- ]- },- "custom_connection_data": {- "type": "object",- "properties": {- "authScheme": {- "type": "string",- "enum": [- "OAUTH2",- "DCR_OAUTH",- "API_KEY",- "BASIC_WITH_JWT",- "BASIC",- "BEARER_TOKEN",- "OAUTH1",- "NO_AUTH",- "SERVICE_ACCOUNT",- "GOOGLE_SERVICE_ACCOUNT",- "S2S_OAUTH2"- ]- },- "toolkitSlug": {+ "tool_router_tools": {+ "type": "array",+ "items": {"type": "string"},- "val": {- "type": "object",- "properties": {- "subdomain": {- "type": "string"- },- "your-domain": {- "type": "string"- },- "region": {- "type": "string"- },- "shop": {- "type": "string"- },- "account_url": {- "type": "string"- },- "COMPANYDOMAIN": {- "type": "string"- },- "extension": {- "type": "string"- },- "form_api_base_url": {- "type": "string"- },- "instanceEndpoint": {- "type": "string"- },- "api_url": {- "type": "string"- },- "borneo_dashboard_url": {- "type": "string"- },- "proxy_username": {- "type": "string"- },- "proxy_password": {- "type": "string"- },- "domain": {- "type": "string"- },- "version": {- "type": "string"- },- "dc": {- "type": "string"- },- "site_name": {- "type": "string"- },- "instanceName": {- "type": "string"- },- "account_id": {- "type": "string"- },- "your_server": {- "type": "string"- },- "server_location": {- "type": "string"- },- "base_url": {- "type": "string"- },- "state_prefix": {+ "description": "List of available tools in this session"+ },+ "config": {+ "type": "object",+ "properties": {+ "user_id": {+ "type": "string",+ "description": "User identifier for this session"+ },+ "toolkits": {+ "anyOf": [+ {+ "type": "object",+ "properties": {+ "enabled": {+ "type": "array",+ "items": {+ "type": "string"+ }+ }+ },+ "required": [+ "enabled"+ ],+ "additionalProperties": false+ },+ {+ "type": "object",+ "properties": {+ "disabled": {+ "type": "array",+ "items": {+ "type": "string"+ }+ }+ },+ "required": [+ "disabled"+ ],+ "additionalProperties": false+ }+ ],+ "description": "Toolkit configuration - either enabled list or disabled list"+ },+ "auth_configs": {+ "type": "object",+ "additionalProperties": {"type": "string",- "maxLength": 40,- "description": "The oauth2 state prefix for the connection"- },- "long_redirect_url": {- "type": "boolean",- "description": "Whether to return the redirect url without shortening"- },- "access_token": {- "type": "string"- },- "id_token": {- "type": "string"- },- "token_type": {- "type": "string"+ "format": "authConfigId"},- "refresh_token": {+ "description": "Auth config overrides per toolkit"+ },+ "connected_accounts": {+ "type": "object",+ "additionalProperties": {"type": "string",- "nullable": true+ "format": "connectedAccountId"},- "expires_in": {+ "description": "Connected account overrides per toolkit"+ },+ "manage_connections": {+ "type": "object",+ "properties": {+ "enabled": {+ "type": "boolean",+ "default": true,+ "description": "Whether to enable the connection manager for automatic connection handling"+ },+ "callback_url": {+ "type": "string",+ "format": "uri",+ "description": "Custom callback URL for connected account auth flows"+ },+ "enable_wait_for_connections": {+ "type": "boolean",+ "default": false,+ "description": "Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status. Default false. May not work reliably with GPT models."+ },+ "enable_connection_removal": {+ "type": "boolean",+ "default": true,+ "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS. Default true."+ }+ },+ "description": "Manage connections configuration"+ },+ "tools": {+ "type": "object",+ "additionalProperties": {"anyOf": [{- "type": "number"+ "type": "object",+ "properties": {+ "enabled": {+ "type": "array",+ "items": {+ "type": "string"+ }+ }+ },+ "required": [+ "enabled"+ ],+ "additionalProperties": false},{- "type": "string"+ "type": "object",+ "properties": {+ "disabled": {+ "type": "array",+ "items": {+ "type": "string"+ }+ }+ },+ "required": [+ "disabled"+ ],+ "additionalProperties": false},{- "nullable": true,- "type": "object"+ "type": "object",+ "properties": {+ "tags": {+ "type": "object",+ "properties": {+ "enabled": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]+ },+ "description": "Tags that the tool must have at least one of"+ },+ "disabled": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]+ },+ "description": "Tags that the tool must NOT have any of"+ }+ }+ }+ },+ "required": [+ "tags"+ ],+ "additionalProperties": false}]},- "scope": {- "anyOf": [- {- "type": "string"+ "description": "Tool-level configuration per toolkit"+ },+ "tags": {+ "type": "object",+ "properties": {+ "enabled": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]},- {- "type": "array",- "items": {- "type": "string"- }+ "description": "Tags that the tool must have at least one of"+ },+ "disabled": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]},- {- "nullable": true,- "type": "object"- }- ]- },- "webhook_signature": {- "type": "string"+ "description": "Tags that the tool must NOT have any of"+ }},- "authed_user": {- "type": "object",- "properties": {- "access_token": {- "type": "string"- },- "scope": {- "type": "string"- }+ "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."+ },+ "workbench": {+ "type": "object",+ "properties": {+ "enable": {+ "type": "boolean",+ "description": "Whether the workbench (code execution sandbox) is enabled. When false, COMPOSIO_REMOTE_WORKBENCH and COMPOSIO_REMOTE_BASH_TOOL are not exposed."},- "description": "for slack user scopes"- },- "client_id": {- "type": "string",- "description": "Dynamically registered client ID"- },- "client_secret": {- "type": "string",- "description": "Dynamically registered client secret"- },- "client_id_issued_at": {- "type": "number"- },- "client_secret_expires_at": {- "type": "number"- },- "generic_api_key": {- "type": "string"- },- "api_key": {- "type": "string"- },- "bearer_token": {- "type": "string"- },- "basic_encoded": {- "type": "string"- },- "username": {- "type": "string"- },- "password": {- "type": "string"- },- "token": {- "type": "string"- },- "oauth_token": {- "type": "string"- },- "oauth_token_secret": {- "type": "string"- },- "oauth_verifier": {- "type": "string"- },- "consumer_key": {- "type": "string"- },- "redirectUrl": {- "type": "string"- },- "callback_url": {- "type": "string"- },- "application_id": {- "type": "string"- },- "installation_id": {- "type": "string"- },- "private_key": {- "type": "string"+ "proxy_execution_enabled": {+ "type": "boolean",+ "description": "Whether proxy execution is enabled in the workbench"+ },+ "auto_offload_threshold": {+ "type": "number",+ "minimum": 0,+ "exclusiveMinimum": true,+ "description": "Character threshold after which tool execution response are saved to a file in workbench. Default is 20k."+ }},- "credentials_json": {- "type": "string"+ "default": {+ "enable": true,+ "proxy_execution_enabled": true},- "expires_at": {- "type": "string"- }- },- "required": [- "access_token"- ],- "additionalProperties": {}- }- },- "required": [- "authScheme",- "toolkitSlug",- "val"- ],- "additionalProperties": true- }- },- "required": [- "toolkit_slug",- "endpoint",- "method"- ]- }- }- }- },- "responses": {- "200": {- "description": "Successfully executed proxy request and received response",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "data": {- "nullable": true,- "description": "The response data returned from the proxied API",- "example": {- "id": "123",- "name": "Resource Name",- "created_at": "2023-01-01T00:00:00Z"+ "description": "Workbench configuration"+ }},- "type": "object"+ "required": [+ "user_id"+ ],+ "description": "The session configuration including user, toolkits, and overrides"},- "binary_data": {+ "experimental": {"type": "object","properties": {- "url": {- "type": "string",- "description": "URL to download binary content"- },- "content_type": {+ "assistive_prompt": {"type": "string",- "description": "Content-Type of the binary data"+ "description": "The assistive system prompt for the tool router session"},- "size": {- "type": "number",- "description": "File size in bytes"+ "custom_toolkits": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "minLength": 1,+ "pattern": "^[a-zA-Z0-9_-]+$"+ },+ "name": {+ "type": "string",+ "minLength": 1,+ "maxLength": 128+ },+ "description": {+ "type": "string",+ "minLength": 1,+ "maxLength": 2048+ },+ "tools": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "description": "Prefixed tool slug (e.g. LOCAL_CRM_FIND_CUSTOMER)"+ },+ "name": {+ "type": "string",+ "minLength": 1,+ "maxLength": 128+ },+ "description": {+ "type": "string",+ "minLength": 1,+ "maxLength": 5120+ },+ "input_schema": {+ "type": "object",+ "additionalProperties": {}+ },+ "output_schema": {+ "type": "object",+ "additionalProperties": {}+ },+ "original_slug": {+ "type": "string",+ "description": "Original tool slug as provided by the user"+ }+ },+ "required": [+ "slug",+ "name",+ "description",+ "input_schema",+ "original_slug"+ ]+ }+ }+ },+ "required": [+ "slug",+ "name",+ "description",+ "tools"+ ]+ },+ "description": "User-defined custom toolkits with grouped tools (no-auth)"},- "expires_at": {- "type": "string",- "description": "ISO 8601 timestamp when the URL expires"- }- },- "required": [- "url",- "content_type",- "size"- ],- "description": "Binary body response data. Present when the response is a binary file."- },- "status": {- "type": "number",- "description": "The HTTP status code returned from the proxied API",- "example": 200- },- "headers": {- "type": "object",- "additionalProperties": {- "type": "string"+ "custom_tools": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "description": "Prefixed tool slug (e.g. LOCAL_GMAIL_GET_IMPORTANT_EMAILS)"+ },+ "name": {+ "type": "string",+ "minLength": 1,+ "maxLength": 128+ },+ "description": {+ "type": "string",+ "minLength": 1,+ "maxLength": 5120+ },+ "input_schema": {+ "type": "object",+ "additionalProperties": {}+ },+ "output_schema": {+ "type": "object",+ "additionalProperties": {}+ },+ "extends_toolkit": {+ "type": "string",+ "minLength": 1+ },+ "original_slug": {+ "type": "string",+ "description": "Original tool slug as provided by the user"+ }+ },+ "required": [+ "slug",+ "name",+ "description",+ "input_schema",+ "original_slug"+ ]+ },+ "description": "Custom tools — standalone or extending Composio toolkits"+ }},- "description": "The HTTP headers returned from the proxied API",- "example": {- "content-type": "application/json",- "cache-control": "no-cache"- }+ "description": "Experimental features including the generated system prompt. Only returned on session creation, not on GET.",+ "x-experimental": true}},"required": [- "status"+ "session_id",+ "mcp",+ "tool_router_tools",+ "config"]}}}},"400": {- "description": "Bad request",+ "description": "Bad request. This may occur if the user_id format is invalid, toolkit names are invalid, or auth_config_id IDs are malformed.","content": {"application/json": {"schema": {@@ -15934,7 +16165,7 @@}},"401": {- "description": "Unauthorized",+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.","content": {"application/json": {"schema": {@@ -15944,27 +16175,7 @@}},"403": {- "description": "Forbidden",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "404": {- "description": "Not found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "413": {- "description": "Payload too large",+ "description": "Forbidden. The user is not authorized to create a tool router session.","content": {"application/json": {"schema": {@@ -15974,7 +16185,7 @@}},"500": {- "description": "Internal server error",+ "description": "Internal server error. An unexpected error occurred while processing the request.","content": {"application/json": {"schema": {@@ -15986,20 +16197,23 @@}}},- "/api/v3/tool_router/session/{session_id}/toolkits": {- "get": {- "summary": "Get toolkits for a tool router session",- "description": "Retrieves a cursor-paginated list of toolkits available in the tool router session. Includes toolkit metadata, composio-managed auth schemes, and connected accounts if available. Optionally filter by specific toolkit slugs.",+ "/api/v3/tool_router/session/{session_id}/execute": {+ "post": {+ "summary": "Execute a tool within a tool router session",+ "description": "Executes a specific tool within a tool router session. The toolkit is automatically inferred from the tool slug. The tool must belong to an allowed toolkit and must not be disabled in the session configuration. This endpoint validates permissions, resolves connected accounts, and executes the tool with the session context.","tags": ["Tool Router"],- "operationId": "getToolRouterSessionBySessionIdToolkits",+ "operationId": "postToolRouterSessionBySessionIdExecute","security": [{"ApiKeyAuth": []},{"UserApiKeyAuth": []+ },+ {+ "workbench_access_key": []}],"parameters": [@@ -16007,86 +16221,93 @@"schema": {"type": "string","format": "toolRouterSessionId",- "description": "The session ID returned when creating the session",- "example": "trs_123456789"+ "description": "The unique identifier of the tool router session. Required for public API endpoints, optional for internal endpoints where it is injected by middleware.",+ "example": "trs_LX9uJKBinWWr"},- "required": true,- "description": "The unique identifier of the tool router session",+ "required": false,+ "description": "Tool router session ID (required for public API, optional for internal - injected by middleware)","name": "session_id","in": "path"- },- {- "schema": {- "type": "integer",- "minimum": 1,- "maximum": 50- },- "required": false,- "description": "Number of items per page, max allowed is 50",- "name": "limit",- "in": "query"- },- {- "schema": {- "type": "string"- },- "required": false,- "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.",- "name": "cursor",- "in": "query"- },- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string"- },- "description": "Filter toolkits by specific slugs (comma-separated). Overrides session toolkit configuration if provided.",- "example": "gmail,slack,github"- },- "required": false,- "description": "Optional comma-separated list of toolkit slugs to filter by. If provided, only these toolkits will be returned, overriding the session configuration.",- "name": "toolkits",- "in": "query"- },- {- "schema": {- "type": "boolean",- "nullable": true,- "default": false,- "description": "Whether to filter by connected toolkits. If provided, only connected toolkits will be returned."- },- "required": false,- "description": "Whether to filter by connected toolkits. If provided, only connected toolkits will be returned.",- "name": "is_connected",- "in": "query"- },- {- "schema": {- "type": "string",- "description": "Search query to filter toolkits by name, slug, or description",- "example": "gmail"- },- "required": false,- "description": "Search query to filter toolkits by name, slug, or description",- "name": "search",- "in": "query"}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "tool_slug": {+ "type": "string",+ "minLength": 1,+ "description": "The unique slug identifier of the tool to execute",+ "example": "GITHUB_CREATE_AN_ISSUE"+ },+ "arguments": {+ "type": "object",+ "additionalProperties": {},+ "default": {},+ "description": "The arguments required by the tool",+ "example": {+ "repository": "octocat/Hello-World",+ "workflow_id": "main.yml",+ "ref": "main",+ "inputs": {+ "environment": "production"+ }+ }+ },+ "account": {+ "type": "string",+ "description": "Account identifier to specify which connected account to use. 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.",+ "example": "coup_hurricane_dal_analytical"+ }+ },+ "required": [+ "tool_slug"+ ]+ }+ }+ }+ },"responses": {"200": {- "description": "Toolkits successfully retrieved. Returns a paginated list of toolkits with their metadata and connected accounts.",+ "description": "Successfully executed the tool. Returns execution result, logs, and status.","content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ToolRouterToolkitsListResponse"+ "type": "object",+ "properties": {+ "data": {+ "type": "object",+ "additionalProperties": {},+ "description": "The data returned by the tool execution",+ "example": {+ "message": "Hello, World!",+ "status": "success"+ }+ },+ "error": {+ "type": "string",+ "nullable": true,+ "description": "Error message if the execution failed, null otherwise"+ },+ "log_id": {+ "type": "string",+ "description": "Unique identifier for the execution log",+ "example": "log_abc123xyz"+ }+ },+ "required": [+ "data",+ "error",+ "log_id"+ ]}}}},"400": {- "description": "Bad request. This may occur if pagination parameters are invalid or the session_id format is incorrect.",+ "description": "Bad request","content": {"application/json": {"schema": {@@ -16096,7 +16317,7 @@}},"401": {- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -16106,7 +16327,7 @@}},"403": {- "description": "Forbidden. The session does not belong to the authenticated user.",+ "description": "Forbidden","content": {"application/json": {"schema": {@@ -16116,7 +16337,17 @@}},"404": {- "description": "Not found. The session with the provided ID does not exist or has been deleted.",+ "description": "Not found",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "413": {+ "description": "Payload too large","content": {"application/json": {"schema": {@@ -16126,7 +16357,7 @@}},"500": {- "description": "Internal server error. An unexpected error occurred while processing the request.",+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -16138,14 +16369,14 @@}}},- "/api/v3/tool_router/session/{session_id}/tools": {- "get": {- "summary": "List meta tools with schemas for a tool router session",- "description": "Returns the meta tools available in a tool router session with their complete schemas. This includes request and response schemas specific to the session context.",+ "/api/v3/tool_router/session/{session_id}/execute_meta": {+ "post": {+ "summary": "Execute a meta tool within a tool router session",+ "description": "Executes a Composio meta tool (COMPOSIO_*) within a tool router session.","tags": ["Tool Router"],- "operationId": "getToolRouterSessionBySessionIdTools",+ "operationId": "postToolRouterSessionBySessionIdExecuteMeta","security": [{"ApiKeyAuth": []@@ -16159,10 +16390,11 @@"schema": {"type": "string","format": "toolRouterSessionId",- "description": "Tool router session ID"+ "description": "The unique identifier of the tool router session. Required for public API endpoints, optional for internal endpoints where it is injected by middleware.",+ "example": "trs_LX9uJKBinWWr"},"required": false,- "description": "Tool router session ID",+ "description": "Tool router session ID (required for public API, optional for internal - injected by middleware)","name": "session_id","in": "path"}@@ -16172,29 +16404,75 @@"application/json": {"schema": {"type": "object",- "properties": {}+ "properties": {+ "slug": {+ "type": "string",+ "enum": [+ "COMPOSIO_SEARCH_TOOLS",+ "COMPOSIO_MULTI_EXECUTE_TOOL",+ "COMPOSIO_MANAGE_CONNECTIONS",+ "COMPOSIO_WAIT_FOR_CONNECTIONS",+ "COMPOSIO_REMOTE_WORKBENCH",+ "COMPOSIO_REMOTE_BASH_TOOL",+ "COMPOSIO_GET_TOOL_SCHEMAS",+ "COMPOSIO_UPSERT_RECIPE",+ "COMPOSIO_GET_RECIPE"+ ],+ "description": "The unique slug identifier of the meta tool to execute",+ "example": "COMPOSIO_MANAGE_CONNECTIONS"+ },+ "arguments": {+ "type": "object",+ "additionalProperties": {},+ "default": {},+ "description": "The arguments required by the meta tool",+ "example": {+ "toolkits": [+ "github"+ ],+ "reinitiate_all": false+ }+ }+ },+ "required": [+ "slug"+ ]}}}},"responses": {"200": {- "description": "Successfully retrieved meta tools with their complete schemas.",+ "description": "Successfully executed the meta tool. Returns execution result, logs, and status.","content": {"application/json": {"schema": {"type": "object","properties": {- "items": {- "type": "array",- "items": {- "$ref": "#/components/schemas/Tool"- },- "description": "List of tools with their complete schemas"+ "data": {+ "type": "object",+ "additionalProperties": {},+ "description": "The data returned by the tool execution",+ "example": {+ "message": "Hello, World!",+ "status": "success"+ }+ },+ "error": {+ "type": "string",+ "nullable": true,+ "description": "Error message if the execution failed, null otherwise"+ },+ "log_id": {+ "type": "string",+ "description": "Unique identifier for the execution log",+ "example": "log_abc123xyz"}},"required": [- "items"+ "data",+ "error",+ "log_id"]}}@@ -16263,14 +16541,14 @@}}},- "/api/v3/tool_router/session/{session_id}/search": {- "post": {- "summary": "Search for tools using a query",- "description": "Search for tools matching a given use case query within a tool router session. Returns matching tool slugs, full tool schemas, toolkit connection statuses, and workflow guidance in a predictable format.",+ "/api/v3/tool_router/session/{session_id}": {+ "get": {+ "summary": "Get a tool router session by ID",+ "description": "Retrieves an existing tool router session by its ID. Returns the session configuration, MCP server URL, and available tools.","tags": ["Tool Router"],- "operationId": "postToolRouterSessionBySessionIdSearch",+ "operationId": "getToolRouterSessionBySessionId","security": [{"ApiKeyAuth": []@@ -16284,422 +16562,423 @@"schema": {"type": "string","format": "toolRouterSessionId",- "description": "Tool router session ID (trs_*)",- "example": "trs_LX9uJKBinWWr"+ "description": "The session ID returned when creating the session",+ "example": "trs_123456789"},"required": true,- "description": "Tool router session ID (trs_*)",+ "description": "The unique identifier of the tool router session","name": "session_id","in": "path"}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "queries": {- "type": "array",- "items": {+ "responses": {+ "200": {+ "description": "Session successfully retrieved. Returns the session details including configuration.",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "session_id": {+ "type": "string",+ "format": "toolRouterSessionId",+ "description": "The identifier of the session",+ "example": "trs_123456789"+ },+ "mcp": {"type": "object","properties": {- "use_case": {+ "type": {"type": "string",- "minLength": 1,- "description": "The task or use case to search tools for. Provide a detailed description to get the best results.",- "example": "Send an email to [email protected] with a summary of my last 5 slack messages"+ "enum": [+ "http"+ ],+ "description": "The type of the MCP server. Can be http"},- "known_fields": {+ "url": {"type": "string",- "description": "Known field hints as key:value pairs (e.g., \"channel_name:general, user_email:[email protected]\")",- "example": "channel_name:general"+ "format": "uri",+ "description": "The URL of the MCP server",+ "example": "https://app.composio.dev/tool_router/v3/trs_123456789/mcp"}},"required": [- "use_case"+ "type",+ "url"]},- "minItems": 1,- "maxItems": 7,- "description": "List of search queries to execute in parallel. Up to 7 queries supported.",- "example": [- {- "use_case": "Send a slack message to a channel"- }- ]- },- "model": {- "type": "string",- "description": "Optional model hint for search/planning behavior (e.g., \"gpt-4o\"). Ignored if invalid.",- "example": "gpt-4o"- }- },- "required": [- "queries"- ]- }- }- }- },- "responses": {- "200": {- "description": "Successfully executed the search. Returns matching tool slugs, schemas, connection statuses, and guidance.",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "success": {- "type": "boolean",- "description": "Whether all searches completed successfully. False if any query failed."- },- "error": {- "type": "string",- "nullable": true,- "description": "Error message if any searches failed, null if all succeeded. Format: \"X out of Y searches failed, reasons: <details>\""- },- "results": {+ "tool_router_tools": {"type": "array","items": {- "type": "object",- "properties": {- "index": {- "type": "number",- "description": "1-based index of the query in the request"- },- "use_case": {- "type": "string",- "description": "The use case that was searched"- },- "execution_guidance": {- "type": "string",- "description": "Guidance message about the search results, particularly when a cached plan is available"- },- "difficulty": {- "type": "string",- "description": "Task difficulty assessment (e.g., \"easy - Simple single-tool operation with known parameters\")"- },- "recommended_plan_steps": {- "type": "array",- "items": {- "type": "string"- },- "description": "Workflow steps from cached plan (only present when cached plan is available)"- },- "known_pitfalls": {- "type": "array",- "items": {- "type": "string"- },- "description": "Common pitfalls and considerations (only present when cached plan is available)"- },- "reference_workbench_snippets": {- "type": "array",- "items": {+ "type": "string"+ },+ "description": "List of available tools in this session"+ },+ "config": {+ "type": "object",+ "properties": {+ "user_id": {+ "type": "string",+ "description": "User identifier for this session"+ },+ "toolkits": {+ "anyOf": [+ {"type": "object","properties": {- "description": {- "type": "string",- "description": "Description of what the code snippet does"- },- "code": {- "type": "string",- "description": "Python code snippet for the workbench"+ "enabled": {+ "type": "array",+ "items": {+ "type": "string"+ }}},"required": [- "description",- "code"- ]- },- "description": "Reference Python code snippets for processing tool responses in the workbench (only present when cached plan is available)"- },- "primary_tool_slugs": {- "type": "array",- "items": {- "type": "string"+ "enabled"+ ],+ "additionalProperties": false},- "description": "List of main tool slugs matching the search criteria"- },- "related_tool_slugs": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of related tool slugs that might be useful"- },- "toolkits": {- "type": "array",- "items": {- "type": "string"- },- "description": "List of unique toolkit slugs used by tools in this query"- },- "plan_id": {- "type": "string",- "description": "ID of cached plan if available"- },- "error": {- "type": "string",- "nullable": true,- "description": "Error message if the search for this query failed, null otherwise. Always present for failed queries."- },- "memory": {- "type": "object",- "additionalProperties": {- "type": "array",- "items": {- "type": "string"- }- },- "description": "Memory data relevant to this query, grouped by app. Only present for non-cached search results."- }- },- "required": [- "index",- "use_case",- "primary_tool_slugs",- "related_tool_slugs",- "toolkits"- ]- },- "description": "Per-query search results with tools, reasoning, and memory. One entry per query in request order."- },- "toolkit_connection_statuses": {- "type": "array",- "items": {- "type": "object",- "properties": {- "toolkit": {- "type": "string",- "description": "The toolkit slug identifier (e.g., \"gmail\", \"slack\")"- },- "description": {- "type": "string",- "description": "Description of what the toolkit does and its capabilities"- },- "has_active_connection": {- "type": "boolean",- "description": "Whether an active connection exists for this toolkit"- },- "connection_details": {- "type": "object",- "additionalProperties": {},- "description": "Connection details including auth config and connected account IDs. Only present when has_active_connection is true."- },- "current_user_info": {- "type": "object",- "additionalProperties": {},- "description": "Information about the currently connected user (email, name, etc.)"- },- "accounts": {- "type": "array",- "items": {+ {"type": "object","properties": {- "id": {- "type": "string",- "description": "Unique identifier for this account"- },- "alias": {- "type": "string",- "description": "User-assigned alias for this account"- },- "user_info": {- "type": "object",- "additionalProperties": {},- "description": "Information about the connected user (email, name, etc.)"- },- "status": {- "type": "string",- "description": "Connection status (e.g., \"active\")"- },- "created_at": {- "type": "string",- "description": "ISO 8601 timestamp of when the account was connected"- },- "is_default": {- "type": "boolean",- "description": "Whether this is the default account for the toolkit"+ "disabled": {+ "type": "array",+ "items": {+ "type": "string"+ }}},"required": [- "id",- "status",- "created_at",- "is_default"- ]- },- "description": "List of connected accounts for this toolkit. Present when multi-account is enabled."- },- "account_selection": {- "type": "string",- "enum": [- "required"- ],- "description": "When \"required\", the agent must specify which account to use. Present only when multiple accounts exist."- },- "status_message": {- "type": "string",- "description": "Human-readable message about the connection status and next steps"- }+ "disabled"+ ],+ "additionalProperties": false+ }+ ],+ "description": "Toolkit configuration - either enabled list or disabled list"},- "required": [- "toolkit",- "description",- "has_active_connection",- "status_message"- ]- },- "description": "Connection status for all toolkits mentioned across all queries, with descriptions merged in."- },- "tool_schemas": {- "type": "object",- "additionalProperties": {- "type": "object",- "properties": {- "toolkit": {- "type": "string",- "description": "The slug of the toolkit that provides this tool"- },- "tool_slug": {+ "auth_configs": {+ "type": "object",+ "additionalProperties": {"type": "string",- "description": "The slug of the tool"+ "format": "authConfigId"},- "description": {+ "description": "Auth config overrides per toolkit"+ },+ "connected_accounts": {+ "type": "object",+ "additionalProperties": {"type": "string",- "description": "Description of the tool"- },- "input_schema": {- "type": "object",- "additionalProperties": {},- "description": "Input schema for the tool (only present when hasFullSchema is true)"- },- "output_schema": {- "type": "object",- "additionalProperties": {},- "description": "Output/response schema for the tool. Only included when include_output_schemas is true."+ "format": "connectedAccountId"},- "hasFullSchema": {- "type": "boolean",- "description": "Whether the full input_schema is included in this response"+ "description": "Connected account overrides per toolkit"+ },+ "manage_connections": {+ "type": "object",+ "properties": {+ "enabled": {+ "type": "boolean",+ "default": true,+ "description": "Whether to enable the connection manager for automatic connection handling"+ },+ "callback_url": {+ "type": "string",+ "format": "uri",+ "description": "Custom callback URL for connected account auth flows"+ },+ "enable_wait_for_connections": {+ "type": "boolean",+ "default": false,+ "description": "Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status. Default false. May not work reliably with GPT models."+ },+ "enable_connection_removal": {+ "type": "boolean",+ "default": true,+ "description": "Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS. Default true."+ }},- "schemaRef": {- "type": "object",- "properties": {- "tool": {- "type": "string",- "enum": [- "COMPOSIO_GET_TOOL_SCHEMAS"+ "description": "Manage connections configuration"+ },+ "tools": {+ "type": "object",+ "additionalProperties": {+ "anyOf": [+ {+ "type": "object",+ "properties": {+ "enabled": {+ "type": "array",+ "items": {+ "type": "string"+ }+ }+ },+ "required": [+ "enabled"],- "description": "Tool to call"+ "additionalProperties": false},- "args": {+ {"type": "object","properties": {- "tool_slugs": {+ "disabled": {"type": "array","items": {"type": "string"- },- "description": "Tool slugs to fetch schemas for"+ }}},"required": [- "tool_slugs"+ "disabled"],- "description": "Arguments to pass to the tool"+ "additionalProperties": false},- "message": {- "type": "string",- "description": "Instruction message for the LLM"- }- },- "required": [- "tool",- "args"- ],- "description": "Reference to fetch full schema when hasFullSchema is false"- }- },- "required": [- "toolkit",- "tool_slug"- ]- },- "description": "Deduplicated tool definitions keyed by tool_slug for O(1) lookup. Each tool appears once even if used in multiple queries."- },- "time_info": {- "type": "object",- "properties": {- "current_time_utc": {- "type": "string",- "description": "Current time in ISO format (UTC)"+ {+ "type": "object",+ "properties": {+ "tags": {+ "type": "object",+ "properties": {+ "enabled": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]+ },+ "description": "Tags that the tool must have at least one of"+ },+ "disabled": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]+ },+ "description": "Tags that the tool must NOT have any of"+ }+ }+ }+ },+ "required": [+ "tags"+ ],+ "additionalProperties": false+ }+ ]+ },+ "description": "Tool-level configuration per toolkit"},- "current_time_utc_epoch_seconds": {- "type": "number",- "description": "Current time as Unix epoch timestamp in seconds"+ "tags": {+ "type": "object",+ "properties": {+ "enabled": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]+ },+ "description": "Tags that the tool must have at least one of"+ },+ "disabled": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "readOnlyHint",+ "destructiveHint",+ "idempotentHint",+ "openWorldHint"+ ]+ },+ "description": "Tags that the tool must NOT have any of"+ }+ },+ "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."},- "message": {- "type": "string",- "description": "Important message about time handling and timezone considerations"+ "workbench": {+ "type": "object",+ "properties": {+ "enable": {+ "type": "boolean",+ "description": "Whether the workbench (code execution sandbox) is enabled. When false, COMPOSIO_REMOTE_WORKBENCH and COMPOSIO_REMOTE_BASH_TOOL are not exposed."+ },+ "proxy_execution_enabled": {+ "type": "boolean",+ "description": "Whether proxy execution is enabled in the workbench"+ },+ "auto_offload_threshold": {+ "type": "number",+ "minimum": 0,+ "exclusiveMinimum": true,+ "description": "Character threshold after which tool execution response are saved to a file in workbench. Default is 20k."+ }+ },+ "default": {+ "enable": true,+ "proxy_execution_enabled": true+ },+ "description": "Workbench configuration"}},"required": [- "current_time_utc",- "current_time_utc_epoch_seconds",- "message"+ "user_id"],- "description": "Time information for the query"+ "description": "The session configuration including user, toolkits, and overrides"},- "session": {+ "experimental": {"type": "object","properties": {- "id": {+ "assistive_prompt": {"type": "string",- "description": "Session identifier to be passed to subsequent meta tool calls as session_id."+ "description": "The assistive system prompt for the tool router session"},- "generate_id": {- "type": "boolean",- "description": "Whether a fresh session id was generated in this call."+ "custom_toolkits": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "minLength": 1,+ "pattern": "^[a-zA-Z0-9_-]+$"+ },+ "name": {+ "type": "string",+ "minLength": 1,+ "maxLength": 128+ },+ "description": {+ "type": "string",+ "minLength": 1,+ "maxLength": 2048+ },+ "tools": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "description": "Prefixed tool slug (e.g. LOCAL_CRM_FIND_CUSTOMER)"+ },+ "name": {+ "type": "string",+ "minLength": 1,+ "maxLength": 128+ },+ "description": {+ "type": "string",+ "minLength": 1,+ "maxLength": 5120+ },+ "input_schema": {+ "type": "object",+ "additionalProperties": {}+ },+ "output_schema": {+ "type": "object",+ "additionalProperties": {}+ },+ "original_slug": {+ "type": "string",+ "description": "Original tool slug as provided by the user"+ }+ },+ "required": [+ "slug",+ "name",+ "description",+ "input_schema",+ "original_slug"+ ]+ }+ }+ },+ "required": [+ "slug",+ "name",+ "description",+ "tools"+ ]+ },+ "description": "User-defined custom toolkits with grouped tools (no-auth)"},- "instructions": {- "type": "string",- "description": "LLM-facing guidance on how to reuse this session id"+ "custom_tools": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "slug": {+ "type": "string",+ "description": "Prefixed tool slug (e.g. LOCAL_GMAIL_GET_IMPORTANT_EMAILS)"+ },+ "name": {+ "type": "string",+ "minLength": 1,+ "maxLength": 128+ },+ "description": {+ "type": "string",+ "minLength": 1,+ "maxLength": 5120+ },+ "input_schema": {+ "type": "object",+ "additionalProperties": {}+ },+ "output_schema": {+ "type": "object",+ "additionalProperties": {}+ },+ "extends_toolkit": {+ "type": "string",+ "minLength": 1+ },+ "original_slug": {+ "type": "string",+ "description": "Original tool slug as provided by the user"+ }+ },+ "required": [+ "slug",+ "name",+ "description",+ "input_schema",+ "original_slug"+ ]+ },+ "description": "Custom tools — standalone or extending Composio toolkits"}},- "required": [- "id",- "generate_id",- "instructions"- ],- "description": "Session info for correlating meta tool calls"- },- "next_steps_guidance": {- "type": "array",- "items": {- "type": "string"- },- "description": "Combined workflow guidance covering connections, planner, and memory usage. Each element is a step instruction."+ "description": "Experimental features",+ "x-experimental": true}},"required": [- "success",- "error",- "results",- "toolkit_connection_statuses",- "tool_schemas",- "time_info",- "session",- "next_steps_guidance"+ "session_id",+ "mcp",+ "tool_router_tools",+ "config"]}}}},"400": {- "description": "Bad request",+ "description": "Bad request. This may occur if the session_id format is invalid, please pass this in trs_ prefix format","content": {"application/json": {"schema": {@@ -16709,17 +16988,7 @@}},"401": {- "description": "Unauthorized",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "403": {- "description": "Forbidden",+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.","content": {"application/json": {"schema": {@@ -16729,17 +16998,7 @@}},"404": {- "description": "Not found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "413": {- "description": "Payload too large",+ "description": "Not found. The session with the provided ID does not exist or has been deleted.","content": {"application/json": {"schema": {@@ -16749,7 +17008,7 @@}},"500": {- "description": "Internal server error",+ "description": "Internal server error. An unexpected error occurred while processing the request.","content": {"application/json": {"schema": {@@ -16761,14 +17020,14 @@}}},- "/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/items": {- "get": {- "summary": "List files in a session mount",- "description": "Lists files in a workbench session storage mount with cursor-based pagination. Use the download_url endpoint with the returned mount_relative_path to get a presigned download URL.",+ "/api/v3/tool_router/session/{session_id}/link": {+ "post": {+ "summary": "Create a link session for a toolkit in a tool router session",+ "description": "Initiates an authentication link session for a specific toolkit within a tool router session. Returns a link token and redirect URL that users can use to complete the OAuth flow.","tags": ["Tool Router"],- "operationId": "getToolRouterSessionBySessionIdMountsByMountIdItems",+ "operationId": "postToolRouterSessionBySessionIdLink","security": [{"ApiKeyAuth": []@@ -16782,115 +17041,82 @@"schema": {"type": "string","format": "toolRouterSessionId",- "description": "The unique identifier of the tool router session",- "example": "trs_123456789"+ "description": "The session ID returned when creating the session",+ "example": "trs_LX9uJKBinWWr"},"required": true,"description": "The unique identifier of the tool router session","name": "session_id","in": "path"- },- {- "schema": {- "type": "string",- "minLength": 1,- "description": "ID of the storage mount",- "example": "files"- },- "required": true,- "description": "ID of the storage mount",- "name": "mount_id",- "in": "path"- },- {- "schema": {- "type": "string",- "description": "Pagination cursor from the previous response next_cursor field"- },- "required": false,- "description": "Pagination cursor from the previous response next_cursor field",- "name": "cursor",- "in": "query"- },- {- "schema": {- "type": "number",- "minimum": 1,- "maximum": 500,- "default": 100,- "description": "Maximum number of files to return per page (1-500)"- },- "required": false,- "description": "Maximum number of files to return per page (1-500)",- "name": "limit",- "in": "query"- },- {- "schema": {- "type": "string",- "minLength": 1,- "description": "Filter results to files under this mount-relative path prefix (e.g. \"data/\" lists only files in the data/ subdirectory)",- "example": "data/"- },- "required": false,- "description": "Relative path prefix within the mount for filtering",- "name": "mount_relative_prefix",- "in": "query"}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "toolkit": {+ "type": "string",+ "minLength": 1,+ "description": "The unique slug identifier of the toolkit to connect",+ "example": "github"+ },+ "alias": {+ "type": "string",+ "description": "A human-readable alias for this connected account. Must be unique per entity and toolkit within the project."+ },+ "callback_url": {+ "type": "string",+ "format": "uri",+ "description": "URL where users will be redirected after completing auth",+ "example": "https://myapp.com/callback"+ }+ },+ "required": [+ "toolkit"+ ]+ }+ }+ }+ },"responses": {- "200": {- "description": "Files listed successfully",+ "201": {+ "description": "Successfully created link session. Returns link token, redirect URL, and connected account ID.","content": {"application/json": {"schema": {"type": "object","properties": {- "items": {- "type": "array",- "items": {- "type": "object",- "properties": {- "mount_relative_path": {- "type": "string",- "description": "Relative file path within the mount (e.g. \"report.pdf\")"- },- "sandbox_mount_prefix": {- "type": "string",- "description": "Absolute mount path inside the sandbox (e.g. /mnt/files)"- },- "size": {- "type": "number",- "description": "File size in bytes"- },- "last_modified": {- "type": "string",- "description": "ISO 8601 timestamp of last modification"- }- },- "required": [- "mount_relative_path",- "sandbox_mount_prefix",- "size",- "last_modified"- ]- },- "description": "List of files in the mount"+ "link_token": {+ "type": "string",+ "description": "Token used to complete the authentication flow",+ "example": "lt_abc123xyz"},- "next_cursor": {+ "redirect_url": {"type": "string",- "description": "Cursor for the next page of results. If absent, there are no more pages."+ "format": "uri",+ "description": "The URL where users should be redirected to complete OAuth",+ "example": "https://app.composio.dev/link/lt_abc123xyz"+ },+ "connected_account_id": {+ "type": "string",+ "format": "connectedAccountId",+ "description": "The unique identifier for the connected account",+ "example": "ca_abc123xyz"}},"required": [- "items"+ "link_token",+ "redirect_url",+ "connected_account_id"]}}}},"400": {- "description": "Bad request",+ "description": "Bad request. This may occur if the toolkit slug is invalid, request parameters are malformed, or a connected account is already defined for this toolkit in the session configuration.","content": {"application/json": {"schema": {@@ -16900,7 +17126,17 @@}},"401": {- "description": "Unauthorized",+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "403": {+ "description": "Forbidden. The session does not belong to the authenticated user.","content": {"application/json": {"schema": {@@ -16910,7 +17146,7 @@}},"404": {- "description": "Session or mount not found",+ "description": "Not found. The session does not exist, toolkit not found, or no auth config exists for the toolkit.","content": {"application/json": {"schema": {@@ -16920,7 +17156,7 @@}},"500": {- "description": "Internal server error",+ "description": "Internal server error. An unexpected error occurred while creating the link session.","content": {"application/json": {"schema": {@@ -16932,20 +17168,23 @@}}},- "/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/download_url": {+ "/api/v3/tool_router/session/{session_id}/proxy_execute": {"post": {- "summary": "Create a presigned download URL for a mount file",- "description": "Generates a presigned download URL for a file in a workbench session mount. Accepts a relative path within the mount.",+ "summary": "Execute proxy request within a tool router session",+ "description": "Execute any native API call on a toolkit with authentication automatically injected from Composio. This endpoint proxies HTTP requests to third-party APIs using connected account credentials resolved from the session context. Provide the toolkit slug, API endpoint, and HTTP method — Composio handles authentication injection, abstracting away credential management. Supports all HTTP methods, custom headers/query parameters, and binary request/response bodies.","tags": ["Tool Router"],- "operationId": "postToolRouterSessionBySessionIdMountsByMountIdDownloadUrl",+ "operationId": "postToolRouterSessionBySessionIdProxyExecute","security": [{"ApiKeyAuth": []},{"UserApiKeyAuth": []+ },+ {+ "workbench_access_key": []}],"parameters": [@@ -16953,25 +17192,13 @@"schema": {"type": "string","format": "toolRouterSessionId",- "description": "The unique identifier of the tool router session",- "example": "trs_123456789"+ "description": "The unique identifier of the tool router session. Required for public API endpoints, optional for internal endpoints where it is injected by middleware.",+ "example": "trs_LX9uJKBinWWr"},- "required": true,- "description": "The unique identifier of the tool router session",+ "required": false,+ "description": "Tool router session ID (required for public API, optional for internal - injected by middleware)","name": "session_id","in": "path"- },- {- "schema": {- "type": "string",- "minLength": 1,- "description": "ID of the storage mount",- "example": "files"- },- "required": true,- "description": "ID of the storage mount",- "name": "mount_id",- "in": "path"}],"requestBody": {@@ -16980,301 +17207,368 @@"schema": {"type": "object","properties": {- "mount_relative_path": {+ "toolkit_slug": {"type": "string",- "minLength": 1,- "description": "Relative file path within the mount",- "example": "report.pdf"- }- },- "required": [- "mount_relative_path"- ]- }- }- }- },- "responses": {- "201": {- "description": "Download URL created successfully",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "download_url": {- "type": "string",- "description": "Presigned download URL for the file"- },- "mount_relative_path": {- "type": "string",- "description": "Relative file path within the mount (e.g. \"report.pdf\")"- },- "sandbox_mount_prefix": {- "type": "string",- "description": "Absolute mount path inside the sandbox (e.g. /mnt/files)"- },- "expires_at": {- "type": "string",- "description": "ISO 8601 timestamp when the download URL expires"- }+ "description": "The slug of the toolkit to use for the request",+ "example": "gmail"},- "required": [- "download_url",- "mount_relative_path",- "sandbox_mount_prefix",- "expires_at"- ]- }- }- }- },- "400": {- "description": "Bad request",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "401": {- "description": "Unauthorized",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "404": {- "description": "Session or mount not found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "500": {- "description": "Internal server error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- }- }- }- },- "/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/upload_url": {- "post": {- "summary": "Create a presigned upload URL for a mount file",- "description": "Generates a presigned upload URL for uploading a file to a workbench session mount. The caller should PUT the file content directly to the returned URL.",- "tags": [- "Tool Router"- ],- "operationId": "postToolRouterSessionBySessionIdMountsByMountIdUploadUrl",- "security": [- {- "ApiKeyAuth": []- },- {- "UserApiKeyAuth": []- }- ],- "parameters": [- {- "schema": {- "type": "string",- "format": "toolRouterSessionId",- "description": "The unique identifier of the tool router session",- "example": "trs_123456789"- },- "required": true,- "description": "The unique identifier of the tool router session",- "name": "session_id",- "in": "path"- },- {- "schema": {- "type": "string",- "minLength": 1,- "description": "ID of the storage mount",- "example": "files"- },- "required": true,- "description": "ID of the storage mount",- "name": "mount_id",- "in": "path"- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "mount_relative_path": {+ "endpoint": {"type": "string",- "minLength": 1,- "description": "Supports subdirectories (e.g. \"data/output.csv\", \"images/charts/chart.png\")",- "example": "report.pdf"+ "description": "The API endpoint to call (absolute URL or path relative to base URL of the connected account)",+ "example": "/api/v1/resources"},- "mimetype": {+ "method": {"type": "string",- "minLength": 1,- "description": "MIME type of the file being uploaded",- "example": "application/pdf"- }- },- "required": [- "mount_relative_path"- ]- }- }- }- },- "responses": {- "201": {- "description": "Upload URL created successfully",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "upload_url": {- "type": "string",- "description": "Presigned upload URL — PUT the file content here"- },- "mount_relative_path": {- "type": "string",- "description": "Relative file path within the mount (e.g. \"report.pdf\")"- },- "sandbox_mount_prefix": {- "type": "string",- "description": "Absolute mount path inside the sandbox (e.g. /mnt/files)"+ "enum": [+ "GET",+ "POST",+ "PUT",+ "DELETE",+ "PATCH",+ "HEAD"+ ],+ "description": "The HTTP method to use for the request",+ "example": "GET"+ },+ "body": {+ "nullable": true,+ "description": "The request body (for POST, PUT, and PATCH requests)",+ "example": {+ "name": "New Resource",+ "description": "This is a new resource"},- "expires_at": {- "type": "string",- "description": "ISO 8601 timestamp when the upload URL expires"- }+ "type": "object"},- "required": [- "upload_url",- "mount_relative_path",- "sandbox_mount_prefix",- "expires_at"- ]- }- }- }- },- "400": {- "description": "Bad request",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "401": {- "description": "Unauthorized",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "404": {- "description": "Session or mount not found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "500": {- "description": "Internal server error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- }- }- }- },- "/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/delete": {- "post": {- "summary": "Delete a file from a session mount",- "description": "Deletes a file from a workbench session storage mount. S3 delete is idempotent — deleting a non-existent file succeeds silently.",- "tags": [- "Tool Router"- ],- "operationId": "postToolRouterSessionBySessionIdMountsByMountIdDelete",- "security": [- {- "ApiKeyAuth": []- },- {- "UserApiKeyAuth": []- }- ],- "parameters": [- {- "schema": {- "type": "string",- "format": "toolRouterSessionId",- "description": "The unique identifier of the tool router session",- "example": "trs_123456789"- },- "required": true,- "description": "The unique identifier of the tool router session",- "name": "session_id",- "in": "path"- },- {- "schema": {- "type": "string",- "minLength": 1,- "description": "ID of the storage mount",- "example": "files"- },- "required": true,- "description": "ID of the storage mount",- "name": "mount_id",- "in": "path"- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "mount_relative_path": {- "type": "string",- "minLength": 1,- "description": "Relative file path within the mount",- "example": "report.pdf"+ "binary_body": {+ "anyOf": [+ {+ "type": "object",+ "properties": {+ "url": {+ "type": "string",+ "format": "uri",+ "description": "URL to fetch binary content from"+ },+ "content_type": {+ "type": "string",+ "description": "Content-Type header to use for the request"+ }+ },+ "required": [+ "url"+ ]+ },+ {+ "type": "object",+ "properties": {+ "base64": {+ "type": "string",+ "minLength": 1,+ "description": "Base64-encoded binary data"+ },+ "content_type": {+ "type": "string",+ "description": "Content-Type header to use for the request"+ }+ },+ "required": [+ "base64"+ ]+ }+ ],+ "description": "Binary body to send. For binary upload via URL: use {url: \"https://...\", content_type?: \"...\"}. For binary upload via base64: use {base64: \"...\", content_type?: \"...\"}."+ },+ "parameters": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "name": {+ "type": "string",+ "description": "Parameter name",+ "example": "x-api-key"+ },+ "value": {+ "type": "string",+ "description": "Parameter value",+ "example": "abc123def456"+ },+ "type": {+ "type": "string",+ "enum": [+ "header",+ "query"+ ],+ "description": "Parameter type (header or query)",+ "example": "header"+ }+ },+ "required": [+ "name",+ "value",+ "type"+ ]+ },+ "description": "Additional HTTP headers or query parameters to include in the request",+ "example": [+ {+ "name": "x-api-key",+ "value": "abc123def456",+ "type": "header"+ },+ {+ "name": "filter",+ "value": "active",+ "type": "query"+ }+ ]+ },+ "custom_connection_data": {+ "type": "object",+ "properties": {+ "authScheme": {+ "type": "string",+ "enum": [+ "OAUTH2",+ "DCR_OAUTH",+ "API_KEY",+ "BASIC_WITH_JWT",+ "BASIC",+ "BEARER_TOKEN",+ "OAUTH1",+ "NO_AUTH",+ "SERVICE_ACCOUNT",+ "GOOGLE_SERVICE_ACCOUNT",+ "S2S_OAUTH2"+ ]+ },+ "toolkitSlug": {+ "type": "string"+ },+ "val": {+ "type": "object",+ "properties": {+ "subdomain": {+ "type": "string"+ },+ "your-domain": {+ "type": "string"+ },+ "region": {+ "type": "string"+ },+ "shop": {+ "type": "string"+ },+ "account_url": {+ "type": "string"+ },+ "COMPANYDOMAIN": {+ "type": "string"+ },+ "extension": {+ "type": "string"+ },+ "form_api_base_url": {+ "type": "string"+ },+ "instanceEndpoint": {+ "type": "string"+ },+ "api_url": {+ "type": "string"+ },+ "borneo_dashboard_url": {+ "type": "string"+ },+ "proxy_username": {+ "type": "string"+ },+ "proxy_password": {+ "type": "string"+ },+ "domain": {+ "type": "string"+ },+ "version": {+ "type": "string"+ },+ "dc": {+ "type": "string"+ },+ "site_name": {+ "type": "string"+ },+ "instanceName": {+ "type": "string"+ },+ "account_id": {+ "type": "string"+ },+ "your_server": {+ "type": "string"+ },+ "server_location": {+ "type": "string"+ },+ "base_url": {+ "type": "string"+ },+ "state_prefix": {+ "type": "string",+ "maxLength": 40,+ "description": "The oauth2 state prefix for the connection"+ },+ "long_redirect_url": {+ "type": "boolean",+ "description": "Whether to return the redirect url without shortening"+ },+ "access_token": {+ "type": "string"+ },+ "id_token": {+ "type": "string"+ },+ "token_type": {+ "type": "string"+ },+ "refresh_token": {+ "type": "string",+ "nullable": true+ },+ "expires_in": {+ "anyOf": [+ {+ "type": "number"+ },+ {+ "type": "string"+ },+ {+ "nullable": true,+ "type": "object"+ }+ ]+ },+ "scope": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ {+ "nullable": true,+ "type": "object"+ }+ ]+ },+ "webhook_signature": {+ "type": "string"+ },+ "authed_user": {+ "type": "object",+ "properties": {+ "access_token": {+ "type": "string"+ },+ "scope": {+ "type": "string"+ }+ },+ "description": "for slack user scopes"+ },+ "client_id": {+ "type": "string",+ "description": "Dynamically registered client ID"+ },+ "client_secret": {+ "type": "string",+ "description": "Dynamically registered client secret"+ },+ "client_id_issued_at": {+ "type": "number"+ },+ "client_secret_expires_at": {+ "type": "number"+ },+ "generic_api_key": {+ "type": "string"+ },+ "api_key": {+ "type": "string"+ },+ "bearer_token": {+ "type": "string"+ },+ "basic_encoded": {+ "type": "string"+ },+ "username": {+ "type": "string"+ },+ "password": {+ "type": "string"+ },+ "token": {+ "type": "string"+ },+ "oauth_token": {+ "type": "string"+ },+ "oauth_token_secret": {+ "type": "string"+ },+ "oauth_verifier": {+ "type": "string"+ },+ "consumer_key": {+ "type": "string"+ },+ "redirectUrl": {+ "type": "string"+ },+ "callback_url": {+ "type": "string"+ },+ "application_id": {+ "type": "string"+ },+ "installation_id": {+ "type": "string"+ },+ "private_key": {+ "type": "string"+ },+ "credentials_json": {+ "type": "string"+ },+ "expires_at": {+ "type": "string"+ }+ },+ "required": [+ "access_token"+ ],+ "additionalProperties": {}+ }+ },+ "required": [+ "authScheme",+ "toolkitSlug",+ "val"+ ],+ "additionalProperties": true}},"required": [- "mount_relative_path"+ "toolkit_slug",+ "endpoint",+ "method"]}}@@ -17282,264 +17576,75 @@},"responses": {"200": {- "description": "File deleted successfully",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "mount_relative_path": {- "type": "string",- "description": "Relative file path that was deleted"- },- "sandbox_mount_prefix": {- "type": "string",- "description": "Absolute mount path inside the sandbox (e.g. /mnt/files)"- }- },- "required": [- "mount_relative_path",- "sandbox_mount_prefix"- ]- }- }- }- },- "400": {- "description": "Bad request",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "401": {- "description": "Unauthorized",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "404": {- "description": "Session or mount not found",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "500": {- "description": "Internal server error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- }- }- }- },- "/api/v3.1/tools": {- "get": {- "summary": "List available tools",- "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.",- "tags": [- "Tools"- ],- "operationId": "getV3_1Tools",- "security": [- {- "ApiKeyAuth": []- },- {- "UserApiKeyAuth": []- }- ],- "parameters": [- {- "schema": {- "type": "string"- },- "required": false,- "description": "The slug of the toolkit to filter by",- "in": "query",- "name": "toolkit_slug"- },- {- "schema": {- "type": "string"- },- "required": false,- "description": "Comma-separated list of specific tool slugs to retrieve (overrides other filters)",- "in": "query",- "name": "tool_slugs"- },- {- "schema": {- "oneOf": [- {- "type": "string"- },- {- "type": "array",- "items": {- "type": "string"- }- }- ]- },- "required": false,- "description": "Comma-separated list of auth config IDs to filter tools by",- "in": "query",- "name": "auth_config_ids"- },- {- "schema": {- "type": "string",- "enum": [- "true",- "false"- ]- },- "required": false,- "description": "Filter to only show important/featured tools (set to \"true\" to enable)",- "in": "query",- "name": "important"- },- {- "schema": {- "type": "array",- "items": {- "type": "string"- }- },- "required": false,- "description": "Filter tools by one or more tags (can be specified multiple times)",- "in": "query",- "name": "tags"- },- {- "schema": {- "type": "array",- "nullable": true,- "items": {- "type": "string"- },- "description": "Filter tools by one or more scopes (can be specified multiple times)"- },- "required": false,- "description": "Array of scopes to filter tools by)",- "name": "scopes",- "in": "query"- },- {- "schema": {- "type": "string"- },- "required": false,- "description": "Full-text search query to filter tools by name, slug, or description. Applied as a soft filter on top of other filters.",- "in": "query",- "name": "query"- },- {- "schema": {- "type": "string"- },- "required": false,- "description": "Deprecated: use \"query\" instead. Free-text search query to find tools by name, description, or functionality.",- "in": "query",- "name": "search",- "deprecated": true- },- {- "schema": {- "type": "boolean",- "default": true- },- "required": false,- "description": "Include deprecated tools in the response",- "in": "query",- "name": "include_deprecated"- },- {- "schema": {- "oneOf": [- {- "type": "null"- },- {- "type": "string"- },- {- "type": "object",- "additionalProperties": {- "type": "string"- },- "description": "Object representation of parsed bracket notation"- }- ]- },- "required": false,- "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",- "in": "query",- "name": "toolkit_versions",- "examples": {- "latest_version": {- "summary": "Latest version for all toolkits",- "value": "latest"- },- "bracket_notation": {- "summary": "Specific versions using bracket notation",- "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"- },- "null_value": {- "summary": "No version specified (uses 00000000_00)",- "value": null- }- }- },- {- "schema": {- "type": "number",- "nullable": true- },- "required": false,- "description": "Number of items per page, max allowed is 1000",- "name": "limit",- "in": "query"- },- {- "schema": {- "type": "string"- },- "required": false,- "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.",- "name": "cursor",- "in": "query"- }- ],- "responses": {- "200": {- "description": "Successfully retrieved tools list with pagination information",+ "description": "Successfully executed proxy request and received response","content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ToolsPaginated"+ "type": "object",+ "properties": {+ "data": {+ "nullable": true,+ "description": "The response data returned from the proxied API",+ "example": {+ "id": "123",+ "name": "Resource Name",+ "created_at": "2023-01-01T00:00:00Z"+ },+ "type": "object"+ },+ "binary_data": {+ "type": "object",+ "properties": {+ "url": {+ "type": "string",+ "description": "URL to download binary content"+ },+ "content_type": {+ "type": "string",+ "description": "Content-Type of the binary data"+ },+ "size": {+ "type": "number",+ "description": "File size in bytes"+ },+ "expires_at": {+ "type": "string",+ "description": "ISO 8601 timestamp when the URL expires"+ }+ },+ "required": [+ "url",+ "content_type",+ "size"+ ],+ "description": "Binary body response data. Present when the response is a binary file."+ },+ "status": {+ "type": "number",+ "description": "The HTTP status code returned from the proxied API",+ "example": 200+ },+ "headers": {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ },+ "description": "The HTTP headers returned from the proxied API",+ "example": {+ "content-type": "application/json",+ "cache-control": "no-cache"+ }+ }+ },+ "required": [+ "status"+ ]}}}},"400": {- "description": "Bad request - Invalid query parameters",+ "description": "Bad request","content": {"application/json": {"schema": {@@ -17549,7 +17654,7 @@}},"401": {- "description": "Unauthorized - Authentication credentials are missing or invalid",+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -17559,7 +17664,7 @@}},"403": {- "description": "Forbidden - User does not have permission to access tools",+ "description": "Forbidden","content": {"application/json": {"schema": {@@ -17569,7 +17674,7 @@}},"404": {- "description": "Not found - The requested resource was not found",+ "description": "Not found","content": {"application/json": {"schema": {@@ -17578,8 +17683,8 @@}}},- "429": {- "description": "Too many requests - Rate limit exceeded",+ "413": {+ "description": "Payload too large","content": {"application/json": {"schema": {@@ -17589,7 +17694,7 @@}},"500": {- "description": "Internal server error - Something went wrong on the server",+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -17601,14 +17706,14 @@}}},- "/api/v3.1/tools/enum": {+ "/api/v3/tool_router/session/{session_id}/toolkits": {"get": {- "summary": "Get tool enum list",- "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.",+ "summary": "Get toolkits for a tool router session",+ "description": "Retrieves a cursor-paginated list of toolkits available in the tool router session. Includes toolkit metadata, composio-managed auth schemes, and connected accounts if available. Optionally filter by specific toolkit slugs.","tags": [- "Tools"+ "Tool Router"],- "operationId": "getV3_1ToolsEnum",+ "operationId": "getToolRouterSessionBySessionIdToolkits","security": [{"ApiKeyAuth": []@@ -17617,23 +17722,91 @@"UserApiKeyAuth": []}],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "format": "toolRouterSessionId",+ "description": "The session ID returned when creating the session",+ "example": "trs_123456789"+ },+ "required": true,+ "description": "The unique identifier of the tool router session",+ "name": "session_id",+ "in": "path"+ },+ {+ "schema": {+ "type": "integer",+ "minimum": 1,+ "maximum": 50+ },+ "required": false,+ "description": "Number of items per page, max allowed is 50",+ "name": "limit",+ "in": "query"+ },+ {+ "schema": {+ "type": "string"+ },+ "required": false,+ "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.",+ "name": "cursor",+ "in": "query"+ },+ {+ "schema": {+ "type": "array",+ "nullable": true,+ "items": {+ "type": "string"+ },+ "description": "Filter toolkits by specific slugs (comma-separated). Overrides session toolkit configuration if provided.",+ "example": "gmail,slack,github"+ },+ "required": false,+ "description": "Optional comma-separated list of toolkit slugs to filter by. If provided, only these toolkits will be returned, overriding the session configuration.",+ "name": "toolkits",+ "in": "query"+ },+ {+ "schema": {+ "type": "boolean",+ "nullable": true,+ "default": false,+ "description": "Whether to filter by connected toolkits. If provided, only connected toolkits will be returned."+ },+ "required": false,+ "description": "Whether to filter by connected toolkits. If provided, only connected toolkits will be returned.",+ "name": "is_connected",+ "in": "query"+ },+ {+ "schema": {+ "type": "string",+ "description": "Search query to filter toolkits by name, slug, or description",+ "example": "gmail"+ },+ "required": false,+ "description": "Search query to filter toolkits by name, slug, or description",+ "name": "search",+ "in": "query"+ }+ ],"responses": {"200": {- "description": "Successfully retrieved tool enum list",+ "description": "Toolkits successfully retrieved. Returns a paginated list of toolkits with their metadata and connected accounts.","content": {"application/json": {"schema": {- "type": "array",- "items": {- "type": "string"- },- "description": "JSON string containing all tool enum values from latest version of each toolkit"+ "$ref": "#/components/schemas/ToolRouterToolkitsListResponse"}}}},"400": {- "description": "Bad request - Invalid request parameters",+ "description": "Bad request. This may occur if pagination parameters are invalid or the session_id format is incorrect.","content": {"application/json": {"schema": {@@ -17643,7 +17816,7 @@}},"401": {- "description": "Unauthorized - Authentication credentials are missing or invalid",+ "description": "Unauthorized. Authentication is required or the provided credentials are invalid.","content": {"application/json": {"schema": {@@ -17653,7 +17826,7 @@}},"403": {- "description": "Forbidden - User does not have permission to access tool enums",+ "description": "Forbidden. The session does not belong to the authenticated user.","content": {"application/json": {"schema": {@@ -17663,7 +17836,7 @@}},"404": {- "description": "Not found - Tool enum list not found",+ "description": "Not found. The session with the provided ID does not exist or has been deleted.","content": {"application/json": {"schema": {@@ -17673,7 +17846,7 @@}},"500": {- "description": "Internal server error - Something went wrong on the server",+ "description": "Internal server error. An unexpected error occurred while processing the request.","content": {"application/json": {"schema": {@@ -17685,14 +17858,14 @@}}},- "/api/v3.1/tools/{tool_slug}": {+ "/api/v3/tool_router/session/{session_id}/tools": {"get": {- "summary": "Get tool by slug",- "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.",+ "summary": "List meta tools with schemas for a tool router session",+ "description": "Returns the meta tools available in a tool router session with their complete schemas. This includes request and response schemas specific to the session context.","tags": [- "Tools"+ "Tool Router"],- "operationId": "getV3_1ToolsByToolSlug",+ "operationId": "getToolRouterSessionBySessionIdTools","security": [{"ApiKeyAuth": []@@ -17704,73 +17877,61 @@"parameters": [{"schema": {- "type": "string"- },- "required": true,- "description": "The unique slug identifier of the tool",- "name": "tool_slug",- "in": "path"- },- {- "schema": {- "type": "string"+ "type": "string",+ "format": "toolRouterSessionId",+ "description": "Tool router session ID"},"required": false,- "description": "Optional version of the tool to retrieve",- "name": "version",- "in": "query"- },- {- "schema": {- "oneOf": [- {- "type": "null"- },- {- "type": "string"- },- {+ "description": "Tool router session ID",+ "name": "session_id",+ "in": "path"+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {}+ }+ }+ }+ },+ "responses": {+ "200": {+ "description": "Successfully retrieved meta tools with their complete schemas.",+ "content": {+ "application/json": {+ "schema": {"type": "object",- "additionalProperties": {- "type": "string"- },- "description": "Object representation of parsed bracket notation"- }- ]- },- "required": false,- "description": "Toolkit version specification. Use \"latest\" for latest versions or bracket notation for specific versions per toolkit.",- "in": "query",- "name": "toolkit_versions",- "examples": {- "latest_version": {- "summary": "Latest version for all toolkits",- "value": "latest"- },- "bracket_notation": {- "summary": "Specific versions using bracket notation",- "value": "Use: toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00"- },- "null_value": {- "summary": "No version specified (uses 00000000_00)",- "value": null+ "properties": {+ "items": {+ "type": "array",+ "items": {+ "$ref": "#/components/schemas/Tool"+ },+ "description": "List of tools with their complete schemas"+ }+ },+ "required": [+ "items"+ ]+ }}}- }- ],- "responses": {- "200": {- "description": "Successfully retrieved tool details",+ },+ "400": {+ "description": "Bad request","content": {"application/json": {"schema": {- "$ref": "#/components/schemas/Tool"+ "$ref": "#/components/schemas/Error"}}}},- "400": {- "description": "Bad request - Invalid tool slug format",+ "401": {+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -17779,8 +17940,8 @@}}},- "401": {- "description": "Unauthorized - Authentication credentials are missing or invalid",+ "403": {+ "description": "Forbidden","content": {"application/json": {"schema": {@@ -17790,7 +17951,17 @@}},"404": {- "description": "Not found - Tool with the specified slug does not exist",+ "description": "Not found",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "413": {+ "description": "Payload too large","content": {"application/json": {"schema": {@@ -17800,7 +17971,7 @@}},"500": {- "description": "Internal server error - Something went wrong on the server",+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -17812,14 +17983,14 @@}}},- "/api/v3.1/tools/execute/{tool_slug}": {+ "/api/v3/tool_router/session/{session_id}/search": {"post": {- "summary": "Execute tool",- "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.",+ "summary": "Search for tools using a query",+ "description": "Search for tools matching a given use case query within a tool router session. Returns matching tool slugs, full tool schemas, toolkit connection statuses, and workflow guidance in a predictable format.","tags": [- "Tools"+ "Tool Router"],- "operationId": "postV3_1ToolsExecuteByToolSlug",+ "operationId": "postToolRouterSessionBySessionIdSearch","security": [{"ApiKeyAuth": []@@ -17831,22 +18002,15 @@"parameters": [{"schema": {- "type": "string"+ "type": "string",+ "format": "toolRouterSessionId",+ "description": "Tool router session ID (trs_*)",+ "example": "trs_LX9uJKBinWWr"},"required": true,- "description": "The tool slug to execute",- "name": "tool_slug",+ "description": "Tool router session ID (trs_*)",+ "name": "session_id","in": "path"- },- {- "schema": {- "type": "string",- "description": "JSON object containing custom headers to pass to LLM providers (OpenAI, Bedrock, etc.)",- "example": "{\"x-custom-header\": \"value\", \"authorization\": \"Bearer token\"}"- },- "required": false,- "name": "x-llm-gateway-headers",- "in": "header"}],"requestBody": {@@ -17855,422 +18019,407 @@"schema": {"type": "object","properties": {- "connected_account_id": {- "type": "string",- "description": "Unique identifier for the connected account to use for authentication",- "example": "ca_1a2b3c4d5e6f"- },- "entity_id": {- "type": "string",- "description": "Deprecated: please use user_id instead. Entity identifier for multi-entity connected accounts (e.g. multiple repositories, organizations)",- "example": "repo-123",- "deprecated": true- },- "user_id": {- "type": "string",- "description": "User id for multi-user connected accounts (e.g. multiple users, organizations)",- "example": "user-123"- },- "version": {- "type": "string",- "description": "Tool version to execute (defaults to \"00000000_00\" if not specified)",- "example": "latest"- },- "custom_auth_params": {- "type": "object",- "properties": {- "base_url": {- "type": "string",- "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'"- },- "parameters": {- "type": "array",- "items": {- "type": "object",- "properties": {- "name": {- "type": "string",- "description": "The name of the parameter. For example, 'x-api-key', 'Content-Type', etc."- },- "in": {- "type": "string",- "enum": [- "query",- "header"- ],- "description": "The location of the parameter. Can be 'query' or 'header'."- },- "value": {- "anyOf": [- {- "type": "string"- },- {- "type": "number"- }- ],- "description": "The value of the parameter. For example, '1234567890', 'application/json', etc."- }- },- "required": [- "name",- "in",- "value"- ]+ "queries": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "use_case": {+ "type": "string",+ "minLength": 1,+ "description": "The task or use case to search tools for. Provide a detailed description to get the best results.",+ "example": "Send an email to [email protected] with a summary of my last 5 slack messages"+ },+ "known_fields": {+ "type": "string",+ "description": "Known field hints as key:value pairs (e.g., \"channel_name:general, user_email:[email protected]\")",+ "example": "channel_name:general"}},- "body": {- "type": "object",- "additionalProperties": {},- "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."- }- },- "description": "Custom authentication parameters for tools that support parameterized authentication",- "example": {- "base_url": "https://api.example.com",- "parameters": [- {- "name": "x-api-key",- "value": "secret-key",- "in": "header"- }+ "required": [+ "use_case"]- }- },- "custom_connection_data": {- "description": "Custom connection data for tools that support custom connection data",- "example": {- "authScheme": "OAUTH2",- "toolkitSlug": "github",- "val": {- "access_token": "secret-token"- }},- "type": "object",- "properties": {- "authScheme": {- "type": "string",- "enum": [- "OAUTH2",- "DCR_OAUTH",- "API_KEY",- "BASIC_WITH_JWT",- "BASIC",- "BEARER_TOKEN",- "OAUTH1",- "NO_AUTH",- "SERVICE_ACCOUNT",- "GOOGLE_SERVICE_ACCOUNT",- "S2S_OAUTH2"- ]- },- "toolkitSlug": {- "type": "string"- },- "val": {- "type": "object",- "properties": {- "subdomain": {- "type": "string"- },- "your-domain": {- "type": "string"- },- "region": {- "type": "string"- },- "shop": {- "type": "string"- },- "account_url": {- "type": "string"- },- "COMPANYDOMAIN": {- "type": "string"- },- "extension": {- "type": "string"- },- "form_api_base_url": {- "type": "string"- },- "instanceEndpoint": {- "type": "string"- },- "api_url": {- "type": "string"- },- "borneo_dashboard_url": {- "type": "string"- },- "proxy_username": {- "type": "string"- },- "proxy_password": {- "type": "string"+ "minItems": 1,+ "maxItems": 7,+ "description": "List of search queries to execute in parallel. Up to 7 queries supported.",+ "example": [+ {+ "use_case": "Send a slack message to a channel"+ }+ ]+ },+ "model": {+ "type": "string",+ "description": "Optional model hint for search/planning behavior (e.g., \"gpt-4o\"). Ignored if invalid.",+ "example": "gpt-4o"+ }+ },+ "required": [+ "queries"+ ]+ }+ }+ }+ },+ "responses": {+ "200": {+ "description": "Successfully executed the search. Returns matching tool slugs, schemas, connection statuses, and guidance.",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "success": {+ "type": "boolean",+ "description": "Whether all searches completed successfully. False if any query failed."+ },+ "error": {+ "type": "string",+ "nullable": true,+ "description": "Error message if any searches failed, null if all succeeded. Format: \"X out of Y searches failed, reasons: <details>\""+ },+ "results": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "index": {+ "type": "number",+ "description": "1-based index of the query in the request"},- "domain": {- "type": "string"+ "use_case": {+ "type": "string",+ "description": "The use case that was searched"},- "version": {- "type": "string"+ "execution_guidance": {+ "type": "string",+ "description": "Guidance message about the search results, particularly when a cached plan is available"},- "dc": {- "type": "string"+ "difficulty": {+ "type": "string",+ "description": "Task difficulty assessment (e.g., \"easy - Simple single-tool operation with known parameters\")"},- "site_name": {- "type": "string"+ "recommended_plan_steps": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Workflow steps from cached plan (only present when cached plan is available)"},- "instanceName": {- "type": "string"+ "known_pitfalls": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Common pitfalls and considerations (only present when cached plan is available)"},- "account_id": {- "type": "string"+ "reference_workbench_snippets": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "description": {+ "type": "string",+ "description": "Description of what the code snippet does"+ },+ "code": {+ "type": "string",+ "description": "Python code snippet for the workbench"+ }+ },+ "required": [+ "description",+ "code"+ ]+ },+ "description": "Reference Python code snippets for processing tool responses in the workbench (only present when cached plan is available)"},- "your_server": {- "type": "string"+ "primary_tool_slugs": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of main tool slugs matching the search criteria"},- "server_location": {- "type": "string"+ "related_tool_slugs": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of related tool slugs that might be useful"},- "base_url": {- "type": "string"+ "toolkits": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "List of unique toolkit slugs used by tools in this query"},- "state_prefix": {+ "plan_id": {"type": "string",- "maxLength": 40,- "description": "The oauth2 state prefix for the connection"- },- "long_redirect_url": {- "type": "boolean",- "description": "Whether to return the redirect url without shortening"- },- "access_token": {- "type": "string"- },- "id_token": {- "type": "string"- },- "token_type": {- "type": "string"+ "description": "ID of cached plan if available"},- "refresh_token": {+ "error": {"type": "string",- "nullable": true- },- "expires_in": {- "anyOf": [- {- "type": "number"- },- {- "type": "string"- },- {- "nullable": true,- "type": "object"- }- ]- },- "scope": {- "anyOf": [- {- "type": "string"- },- {- "type": "array",- "items": {- "type": "string"- }- },- {- "nullable": true,- "type": "object"- }- ]- },- "webhook_signature": {- "type": "string"+ "nullable": true,+ "description": "Error message if the search for this query failed, null otherwise. Always present for failed queries."},- "authed_user": {+ "memory": {"type": "object",- "properties": {- "access_token": {- "type": "string"- },- "scope": {+ "additionalProperties": {+ "type": "array",+ "items": {"type": "string"}},- "description": "for slack user scopes"- },- "client_id": {+ "description": "Memory data relevant to this query, grouped by app. Only present for non-cached search results."+ }+ },+ "required": [+ "index",+ "use_case",+ "primary_tool_slugs",+ "related_tool_slugs",+ "toolkits"+ ]+ },+ "description": "Per-query search results with tools, reasoning, and memory. One entry per query in request order."+ },+ "toolkit_connection_statuses": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "toolkit": {"type": "string",- "description": "Dynamically registered client ID"+ "description": "The toolkit slug identifier (e.g., \"gmail\", \"slack\")"},- "client_secret": {+ "description": {"type": "string",- "description": "Dynamically registered client secret"- },- "client_id_issued_at": {- "type": "number"- },- "client_secret_expires_at": {- "type": "number"- },- "generic_api_key": {- "type": "string"- },- "api_key": {- "type": "string"- },- "bearer_token": {- "type": "string"- },- "basic_encoded": {- "type": "string"- },- "username": {- "type": "string"- },- "password": {- "type": "string"+ "description": "Description of what the toolkit does and its capabilities"},- "token": {- "type": "string"+ "has_active_connection": {+ "type": "boolean",+ "description": "Whether an active connection exists for this toolkit"},- "oauth_token": {- "type": "string"+ "connection_details": {+ "type": "object",+ "additionalProperties": {},+ "description": "Connection details including auth config and connected account IDs. Only present when has_active_connection is true."},- "oauth_token_secret": {- "type": "string"+ "current_user_info": {+ "type": "object",+ "additionalProperties": {},+ "description": "Information about the currently connected user (email, name, etc.)"},- "oauth_verifier": {- "type": "string"+ "accounts": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "id": {+ "type": "string",+ "description": "Unique identifier for this account"+ },+ "alias": {+ "type": "string",+ "description": "User-assigned alias for this account"+ },+ "user_info": {+ "type": "object",+ "additionalProperties": {},+ "description": "Information about the connected user (email, name, etc.)"+ },+ "status": {+ "type": "string",+ "description": "Connection status (e.g., \"active\")"+ },+ "created_at": {+ "type": "string",+ "description": "ISO 8601 timestamp of when the account was connected"+ },+ "is_default": {+ "type": "boolean",+ "description": "Whether this is the default account for the toolkit"+ }+ },+ "required": [+ "id",+ "status",+ "created_at",+ "is_default"+ ]+ },+ "description": "List of connected accounts for this toolkit. Present when multi-account is enabled."},- "consumer_key": {- "type": "string"+ "account_selection": {+ "type": "string",+ "enum": [+ "required"+ ],+ "description": "When \"required\", the agent must specify which account to use. Present only when multiple accounts exist."},- "redirectUrl": {- "type": "string"+ "status_message": {+ "type": "string",+ "description": "Human-readable message about the connection status and next steps"+ }+ },+ "required": [+ "toolkit",+ "description",+ "has_active_connection",+ "status_message"+ ]+ },+ "description": "Connection status for all toolkits mentioned across all queries, with descriptions merged in."+ },+ "tool_schemas": {+ "type": "object",+ "additionalProperties": {+ "type": "object",+ "properties": {+ "toolkit": {+ "type": "string",+ "description": "The slug of the toolkit that provides this tool"},- "callback_url": {- "type": "string"+ "tool_slug": {+ "type": "string",+ "description": "The slug of the tool"},- "application_id": {- "type": "string"+ "description": {+ "type": "string",+ "description": "Description of the tool"},- "installation_id": {- "type": "string"+ "input_schema": {+ "type": "object",+ "additionalProperties": {},+ "description": "Input schema for the tool (only present when hasFullSchema is true)"},- "private_key": {- "type": "string"+ "output_schema": {+ "type": "object",+ "additionalProperties": {},+ "description": "Output/response schema for the tool. Only included when include_output_schemas is true."},- "credentials_json": {- "type": "string"+ "hasFullSchema": {+ "type": "boolean",+ "description": "Whether the full input_schema is included in this response"},- "expires_at": {- "type": "string"+ "schemaRef": {+ "type": "object",+ "properties": {+ "tool": {+ "type": "string",+ "enum": [+ "COMPOSIO_GET_TOOL_SCHEMAS"+ ],+ "description": "Tool to call"+ },+ "args": {+ "type": "object",+ "properties": {+ "tool_slugs": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Tool slugs to fetch schemas for"+ }+ },+ "required": [+ "tool_slugs"+ ],+ "description": "Arguments to pass to the tool"+ },+ "message": {+ "type": "string",+ "description": "Instruction message for the LLM"+ }+ },+ "required": [+ "tool",+ "args"+ ],+ "description": "Reference to fetch full schema when hasFullSchema is false"}},"required": [- "access_token"- ],- "additionalProperties": {}- }+ "toolkit",+ "tool_slug"+ ]+ },+ "description": "Deduplicated tool definitions keyed by tool_slug for O(1) lookup. Each tool appears once even if used in multiple queries."},- "required": [- "authScheme",- "toolkitSlug",- "val"- ],- "additionalProperties": true- },- "arguments": {- "type": "object",- "additionalProperties": {},- "description": "Key-value pairs of arguments required by the tool (mutually exclusive with text)",- "example": {- "repository": "octocat/Hello-World",- "workflow_id": "main.yml",- "ref": "main",- "inputs": {- "environment": "production"- }- }- },- "text": {- "type": "string",- "description": "Natural language description of the task to perform (mutually exclusive with arguments)",- "example": "Trigger the main workflow in the octocat/Hello-World repository on the main branch for the production environment"- },- "allow_tracing": {- "type": "boolean",- "nullable": true,- "description": "Deprecated. Enable debug tracing for tool execution (useful for debugging)",- "deprecated": true,- "example": false- }- }- }- }- }- },- "responses": {- "200": {- "description": "Successfully executed action and received response",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "data": {+ "time_info": {"type": "object",- "additionalProperties": {},- "description": "Tool execution output data that varies based on the specific tool",- "example": {- "run_id": 12345678,- "status": "queued",- "created_at": "2023-01-01T12:00:00Z",- "html_url": "https://github.com/octocat/Hello-World/actions/runs/12345678"- }- },- "error": {- "type": "string",- "nullable": true,- "description": "Error message if the tool execution was not successful (null if successful)"- },- "successful": {- "type": "boolean",- "description": "Indicates if the tool execution was successful",- "example": true+ "properties": {+ "current_time_utc": {+ "type": "string",+ "description": "Current time in ISO format (UTC)"+ },+ "current_time_utc_epoch_seconds": {+ "type": "number",+ "description": "Current time as Unix epoch timestamp in seconds"+ },+ "message": {+ "type": "string",+ "description": "Important message about time handling and timezone considerations"+ }+ },+ "required": [+ "current_time_utc",+ "current_time_utc_epoch_seconds",+ "message"+ ],+ "description": "Time information for the query"},- "session_info": {- "nullable": true,- "description": "Optional session information for tools that return session context",- "example": {- "session_id": "session-12345",- "expires_at": "2023-01-01T13:00:00Z"+ "session": {+ "type": "object",+ "properties": {+ "id": {+ "type": "string",+ "description": "Session identifier to be passed to subsequent meta tool calls as session_id."+ },+ "generate_id": {+ "type": "boolean",+ "description": "Whether a fresh session id was generated in this call."+ },+ "instructions": {+ "type": "string",+ "description": "LLM-facing guidance on how to reuse this session id"+ }},- "type": "object"+ "required": [+ "id",+ "generate_id",+ "instructions"+ ],+ "description": "Session info for correlating meta tool calls"},- "log_id": {- "type": "string",- "description": "Unique identifier for the execution log (useful for debugging and support)",- "example": "log_abc123def456"+ "next_steps_guidance": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Combined workflow guidance covering connections, planner, and memory usage. Each element is a step instruction."}},"required": [- "data",+ "success","error",- "successful"+ "results",+ "toolkit_connection_statuses",+ "tool_schemas",+ "time_info",+ "session",+ "next_steps_guidance"]}}}},"400": {- "description": "Bad request - Invalid request parameters, missing required arguments, or conflicting parameters",+ "description": "Bad request","content": {"application/json": {"schema": {@@ -18280,7 +18429,7 @@}},"401": {- "description": "Unauthorized - Authentication credentials are missing or invalid",+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -18290,7 +18439,7 @@}},"403": {- "description": "Forbidden - Connected account does not have permission to execute this tool or access the requested resource",+ "description": "Forbidden","content": {"application/json": {"schema": {@@ -18300,7 +18449,7 @@}},"404": {- "description": "Not found - Tool or connected account not found",+ "description": "Not found","content": {"application/json": {"schema": {@@ -18309,8 +18458,8 @@}}},- "408": {- "description": "Request timeout - Tool execution exceeded the maximum allowed time",+ "413": {+ "description": "Payload too large","content": {"application/json": {"schema": {@@ -18319,8 +18468,8 @@}}},- "410": {- "description": "Gone - Tool has been deprecated and is no longer available",+ "500": {+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -18328,9 +18477,140 @@}}}+ }+ }+ }+ },+ "/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/items": {+ "get": {+ "summary": "List files in a session mount",+ "description": "Lists files in a workbench session storage mount with cursor-based pagination. Use the download_url endpoint with the returned mount_relative_path to get a presigned download URL.",+ "tags": [+ "Tool Router"+ ],+ "operationId": "getToolRouterSessionBySessionIdMountsByMountIdItems",+ "security": [+ {+ "ApiKeyAuth": []},- "413": {- "description": "Payload too large - Request or response payload exceeds size limits",+ {+ "UserApiKeyAuth": []+ }+ ],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "format": "toolRouterSessionId",+ "description": "The unique identifier of the tool router session",+ "example": "trs_123456789"+ },+ "required": true,+ "description": "The unique identifier of the tool router session",+ "name": "session_id",+ "in": "path"+ },+ {+ "schema": {+ "type": "string",+ "minLength": 1,+ "description": "ID of the storage mount",+ "example": "files"+ },+ "required": true,+ "description": "ID of the storage mount",+ "name": "mount_id",+ "in": "path"+ },+ {+ "schema": {+ "type": "string",+ "description": "Pagination cursor from the previous response next_cursor field"+ },+ "required": false,+ "description": "Pagination cursor from the previous response next_cursor field",+ "name": "cursor",+ "in": "query"+ },+ {+ "schema": {+ "type": "number",+ "minimum": 1,+ "maximum": 500,+ "default": 100,+ "description": "Maximum number of files to return per page (1-500)"+ },+ "required": false,+ "description": "Maximum number of files to return per page (1-500)",+ "name": "limit",+ "in": "query"+ },+ {+ "schema": {+ "type": "string",+ "minLength": 1,+ "description": "Filter results to files under this mount-relative path prefix (e.g. \"data/\" lists only files in the data/ subdirectory)",+ "example": "data/"+ },+ "required": false,+ "description": "Relative path prefix within the mount for filtering",+ "name": "mount_relative_prefix",+ "in": "query"+ }+ ],+ "responses": {+ "200": {+ "description": "Files listed successfully",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "items": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "mount_relative_path": {+ "type": "string",+ "description": "Relative file path within the mount (e.g. \"report.pdf\")"+ },+ "sandbox_mount_prefix": {+ "type": "string",+ "description": "Absolute mount path inside the sandbox (e.g. /mnt/files)"+ },+ "size": {+ "type": "number",+ "description": "File size in bytes"+ },+ "last_modified": {+ "type": "string",+ "description": "ISO 8601 timestamp of last modification"+ }+ },+ "required": [+ "mount_relative_path",+ "sandbox_mount_prefix",+ "size",+ "last_modified"+ ]+ },+ "description": "List of files in the mount"+ },+ "next_cursor": {+ "type": "string",+ "description": "Cursor for the next page of results. If absent, there are no more pages."+ }+ },+ "required": [+ "items"+ ]+ }+ }+ }+ },+ "400": {+ "description": "Bad request","content": {"application/json": {"schema": {@@ -18339,8 +18619,8 @@}}},- "422": {- "description": "Unprocessable entity - Invalid state of the connected account",+ "401": {+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -18349,8 +18629,18 @@}}},- "429": {- "description": "Rate limit exceeded - Too many requests to the tool or underlying API",+ "404": {+ "description": "Session or mount not found",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/Error"+ }+ }+ }+ },+ "500": {+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -18358,9 +18648,109 @@}}}+ }+ }+ }+ },+ "/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/download_url": {+ "post": {+ "summary": "Create a presigned download URL for a mount file",+ "description": "Generates a presigned download URL for a file in a workbench session mount. Accepts a relative path within the mount.",+ "tags": [+ "Tool Router"+ ],+ "operationId": "postToolRouterSessionBySessionIdMountsByMountIdDownloadUrl",+ "security": [+ {+ "ApiKeyAuth": []+ },+ {+ "UserApiKeyAuth": []+ }+ ],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "format": "toolRouterSessionId",+ "description": "The unique identifier of the tool router session",+ "example": "trs_123456789"+ },+ "required": true,+ "description": "The unique identifier of the tool router session",+ "name": "session_id",+ "in": "path"+ },+ {+ "schema": {+ "type": "string",+ "minLength": 1,+ "description": "ID of the storage mount",+ "example": "files"+ },+ "required": true,+ "description": "ID of the storage mount",+ "name": "mount_id",+ "in": "path"+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "mount_relative_path": {+ "type": "string",+ "minLength": 1,+ "description": "Relative file path within the mount",+ "example": "report.pdf"+ }+ },+ "required": [+ "mount_relative_path"+ ]+ }+ }+ }+ },+ "responses": {+ "201": {+ "description": "Download URL created successfully",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "download_url": {+ "type": "string",+ "description": "Presigned download URL for the file"+ },+ "mount_relative_path": {+ "type": "string",+ "description": "Relative file path within the mount (e.g. \"report.pdf\")"+ },+ "sandbox_mount_prefix": {+ "type": "string",+ "description": "Absolute mount path inside the sandbox (e.g. /mnt/files)"+ },+ "expires_at": {+ "type": "string",+ "description": "ISO 8601 timestamp when the download URL expires"+ }+ },+ "required": [+ "download_url",+ "mount_relative_path",+ "sandbox_mount_prefix",+ "expires_at"+ ]+ }+ }+ }},- "500": {- "description": "Internal server error - Something went wrong on the server",+ "400": {+ "description": "Bad request","content": {"application/json": {"schema": {@@ -18369,8 +18759,8 @@}}},- "501": {- "description": "Not implemented",+ "401": {+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -18379,8 +18769,8 @@}}},- "502": {- "description": "Bad gateway - Error communicating with the tool provider API",+ "404": {+ "description": "Session or mount not found","content": {"application/json": {"schema": {@@ -18389,8 +18779,8 @@}}},- "503": {- "description": "Upstream service unavailable - Tool provider API is currently down or unavailable",+ "500": {+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -18402,14 +18792,14 @@}}},- "/api/v3.1/tools/execute/{tool_slug}/input": {+ "/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/upload_url": {"post": {- "summary": "Generate tool inputs from natural language",- "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.",+ "summary": "Create a presigned upload URL for a mount file",+ "description": "Generates a presigned upload URL for uploading a file to a workbench session mount. The caller should PUT the file content directly to the returned URL.","tags": [- "Tools"+ "Tool Router"],- "operationId": "postV3_1ToolsExecuteByToolSlugInput",+ "operationId": "postToolRouterSessionBySessionIdMountsByMountIdUploadUrl","security": [{"ApiKeyAuth": []@@ -18421,11 +18811,26 @@"parameters": [{"schema": {- "type": "string"+ "type": "string",+ "format": "toolRouterSessionId",+ "description": "The unique identifier of the tool router session",+ "example": "trs_123456789"},"required": true,- "description": "The tool slug to generate inputs for",- "name": "tool_slug",+ "description": "The unique identifier of the tool router session",+ "name": "session_id",+ "in": "path"+ },+ {+ "schema": {+ "type": "string",+ "minLength": 1,+ "description": "ID of the storage mount",+ "example": "files"+ },+ "required": true,+ "description": "ID of the storage mount",+ "name": "mount_id","in": "path"}],@@ -18435,67 +18840,63 @@"schema": {"type": "object","properties": {- "text": {- "type": "string",- "description": "Natural language description of what you want to accomplish with this tool",- "example": "I need to trigger the main workflow in the octocat/Hello-World repository to deploy to production"- },- "custom_description": {- "type": "string",- "description": "Custom description of the tool to help guide the LLM in generating more accurate inputs",- "example": "This tool triggers GitHub Actions workflows in a repository. It requires the repository name, workflow ID, and optional input parameters."- },- "system_prompt": {+ "mount_relative_path": {"type": "string",- "description": "System prompt to control and guide the behavior of the LLM when generating inputs",- "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."+ "minLength": 1,+ "description": "Supports subdirectories (e.g. \"data/output.csv\", \"images/charts/chart.png\")",+ "example": "report.pdf"},- "version": {+ "mimetype": {"type": "string",- "description": "Tool version to use when generating inputs (defaults to \"latest\" if not specified)",- "example": "latest"+ "minLength": 1,+ "description": "MIME type of the file being uploaded",+ "example": "application/pdf"}},"required": [- "text"+ "mount_relative_path"]}}}},"responses": {- "200": {- "description": "Successfully generated structured inputs for the action based on natural language description",+ "201": {+ "description": "Upload URL created successfully","content": {"application/json": {"schema": {"type": "object","properties": {- "arguments": {- "type": "object",- "additionalProperties": {},- "description": "Key-value pairs of arguments required by the tool to accomplish the described task",- "example": {- "repository": "octocat/Hello-World",- "workflow_id": "main.yml",- "ref": "main",- "inputs": {- "environment": "production"- }- }+ "upload_url": {+ "type": "string",+ "description": "Presigned upload URL — PUT the file content here"},- "error": {+ "mount_relative_path": {"type": "string",- "description": "Error message if the arguments could not be generated (null if successful)",- "example": "Unable to determine the repository name from the provided description"+ "description": "Relative file path within the mount (e.g. \"report.pdf\")"+ },+ "sandbox_mount_prefix": {+ "type": "string",+ "description": "Absolute mount path inside the sandbox (e.g. /mnt/files)"+ },+ "expires_at": {+ "type": "string",+ "description": "ISO 8601 timestamp when the upload URL expires"}- }+ },+ "required": [+ "upload_url",+ "mount_relative_path",+ "sandbox_mount_prefix",+ "expires_at"+ ]}}}},"400": {- "description": "Bad request - Invalid input parameters or insufficient description to generate tool arguments",+ "description": "Bad request","content": {"application/json": {"schema": {@@ -18505,7 +18906,7 @@}},"401": {- "description": "Unauthorized - Authentication credentials are missing or invalid",+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -18515,27 +18916,7 @@}},"404": {- "description": "Not found - The specified tool does not exist",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "422": {- "description": "Unprocessable entity - Invalid state of the connected account",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Error"- }- }- }- },- "429": {- "description": "Too many requests - Rate limit exceeded for natural language processing",+ "description": "Session or mount not found","content": {"application/json": {"schema": {@@ -18545,7 +18926,7 @@}},"500": {- "description": "Internal server error - AI processing failed or other server error occurred",+ "description": "Internal server error","content": {"application/json": {"schema": {@@ -18557,14 +18938,14 @@}}},- "/api/v3.1/tools/scopes/required": {+ "/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/delete": {"post": {- "summary": "Get required scopes for tools",- "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.",+ "summary": "Delete a file from a session mount",+ "description": "Deletes a file from a workbench session storage mount. S3 delete is idempotent — deleting a non-existent file succeeds silently.","tags": [- "Tools"+ "Tool Router"],- "operationId": "postV3_1ToolsScopesRequired",+ "operationId": "postToolRouterSessionBySessionIdMountsByMountIdDelete","security": [{"ApiKeyAuth": []@@ -18573,32 +18954,47 @@"UserApiKeyAuth": []}],+ "parameters": [+ {+ "schema": {+ "type": "string",+ "format": "toolRouterSessionId",+ "description": "The unique identifier of the tool router session",+ "example": "trs_123456789"+ },+ "required": true,+ "description": "The unique identifier of the tool router session",+ "name": "session_id",+ "in": "path"+ },+ {+ "schema": {+ "type": "string",+ "minLength": 1,+ "description": "ID of the storage mount",+ "example": "files"+ },+ "required": true,+ "description": "ID of the storage mount",+ "name": "mount_id",+ "in": "path"+ }+ ],"requestBody": {"content": {"application/json": {"schema": {"type": "object","properties": {- "tools": {- "type": "array",- "items": {- "type": "string"- },- "minItems": 1,- "description": "Tool slugs to resolve scopes for. All tools must belong to the same toolkit.",- "example": [- "gmail_view_email",- "gmail_send_email"- ]- },- "version": {+ "mount_relative_path": {"type": "string",- "description": "Toolkit version to resolve scopes against for the requested toolkit. Defaults to the pinned HTTP version when omitted.",- "example": "latest"+ "minLength": 1,+ "description": "Relative file path within the mount",+ "example": "report.pdf"}},"required": [- "tools"+ "mount_relative_path"]}}@@ -18606,87 +19002,31 @@},"responses": {"200": {- "description": "Successfully retrieved scopes for the specified tools",+ "description": "File deleted successfully","content": {"application/json": {"schema": {"type": "object","properties": {- "scopes_required": {- "type": "array",- "items": {- "type": "string"- },- "description": "A combined list of all unique scopes required by the specified tools",- "example": [- "channels:read",- "chat:write",- "https://www.googleapis.com/auth/gmail.modify",- "repo",- "user:email"- ]+ "mount_relative_path": {+ "type": "string",+ "description": "Relative file path that was deleted"},- "per_tool_requirements": {- "type": "array",- "items": {- "type": "object",- "properties": {- "tool": {- "type": "string"- },- "scope_requirements": {- "type": "object",- "nullable": true,- "properties": {- "all_of": {- "type": "array",- "items": {- "anyOf": [- {- "type": "string"- },- {- "type": "object",- "properties": {- "any_of": {- "type": "array",- "items": {- "type": "string"- },- "minItems": 1- }- },- "required": [- "any_of"- ]- }- ]- }- }- },- "required": [- "all_of"- ]- }- },- "required": [- "tool",- "scope_requirements"- ]- },- "description": "Per-tool structured scope requirements. Null scope_requirements marks unmigrated legacy tools."+ "sandbox_mount_prefix": {+ "type": "string",+ "description": "Absolute mount path inside the sandbox (e.g. /mnt/files)"}},"required": [- "scopes_required",- "per_tool_requirements"+ "mount_relative_path",+ "sandbox_mount_prefix"]}}}},"400": {- "description": "Bad request - Invalid body parameters or tools from different toolkits",+ "description": "Bad request","content": {"application/json": {"schema": {@@ -18696,7 +19036,7 @@}},"401": {- "description": "Unauthorized - Authentication credentials are missing or invalid",+ "description": "Unauthorized","content": {"application/json": {"schema": {@@ -18706,7 +19046,7 @@}},"404": {- "description": "Not found - One or more tools could not be resolved for the requested version",+ "description": "Session or mount not found","content": {"application/json": {"schema": {@@ -18716,7 +19056,7 @@}},"500": {- "description": "Internal server error - Something went wrong on the server",+ "description": "Internal server error","content": {"application/json": {"schema": {