Your Composio project API key. Create or copy it from the Composio dashboard.
Path Parameters
session_id
string<toolRouterSessionId>
required
The unique identifier of the tool router session
Example:
"trs_1a2b3c4d5e6f"
Body
application/json
experimental
object
Inline custom tools and toolkits for this request. v3.1 sessions do not persist customs — pass them on every request that needs them.
Show child attributes
Response
Session successfully attached. Returns the session payload.
session_id
string<toolRouterSessionId>
required
The identifier of the session
Example:
"trs_1a2b3c4d5e6f"
mcp
object
required
Show child attributes
tool_router_tools
string[]
required
List of available tools in this session
config
object
required
The configuration used to create this session
Show child attributes
config_version
integer
required
Monotonic version of the config. Incremented on each PATCH. Use for optimistic concurrency control.
experimental
object
Experimental v3.1 features
Show child attributes
warnings
object[]
Advisory list — the session exists and is usable, but the listed issues may warrant attention.
Show child attributes
Example:
[ { "code": "PRELOAD_TOOLS_HIGH_CONTEXT_USAGE", "message": "Session preloads 25 tools; each preloaded tool adds to the agent context window. Consider keeping the list at or under ~20 tools." } ]
Attach to an existing tool router session (v3.1)
import requestsurl = "https://backend.composio.dev/api/v3.1/tool_router/session/{session_id}/attach"payload = { "experimental": { "custom_toolkits": [ { "slug": "ecommerce", "name": "E-Commerce API", "description": "Internal e-commerce API for order management and fulfillment", "tools": [ { "slug": "GET_CUSTOMER_ORDERS", "name": "Get Customer Orders", "description": "Fetch recent orders for a customer by their email address", "input_schema": { "type": "object", "properties": { "email": { "type": "string", "description": "Customer email" } }, "required": ["email"] }, "output_schema": {}, "preload": True } ], "preload": True } ], "custom_tools": [ { "slug": "GET_IMPORTANT_EMAILS", "name": "Get Important Emails", "description": "Fetch emails marked as important from the last 24 hours", "input_schema": { "type": "object", "properties": { "limit": { "type": "number", "description": "Max results to return" } } }, "output_schema": {}, "extends_toolkit": "gmail", "preload": True } ] } }headers = { "x-api-key": "<api-key>", "Content-Type": "application/json"}response = requests.post(url, json=payload, headers=headers)print(response.text)
const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
experimental: {
custom_toolkits: [
{
slug: 'ecommerce',
name: 'E-Commerce API',
description: 'Internal e-commerce API for order management and fulfillment',
tools: [
{
slug: 'GET_CUSTOMER_ORDERS',
name: 'Get Customer Orders',
description: 'Fetch recent orders for a customer by their email address',
input_schema: {
type: 'object',
properties: {email: {type: 'string', description: 'Customer email'}},
required: ['email']
},
output_schema: {},
preload: true
}
],
preload: true
}
],
custom_tools: [
{
slug: 'GET_IMPORTANT_EMAILS',
name: 'Get Important Emails',
description: 'Fetch emails marked as important from the last 24 hours',
input_schema: {
type: 'object',
properties: {limit: {type: 'number', description: 'Max results to return'}}
},
output_schema: {},
extends_toolkit: 'gmail',
preload: true
}
]
}
})
};
fetch('https://backend.composio.dev/api/v3.1/tool_router/session/{session_id}/attach', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
curl --request POST \
--url https://backend.composio.dev/api/v3.1/tool_router/session/{session_id}/attach \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"experimental": {
"custom_toolkits": [
{
"slug": "ecommerce",
"name": "E-Commerce API",
"description": "Internal e-commerce API for order management and fulfillment",
"tools": [
{
"slug": "GET_CUSTOMER_ORDERS",
"name": "Get Customer Orders",
"description": "Fetch recent orders for a customer by their email address",
"input_schema": {
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Customer email"
}
},
"required": [
"email"
]
},
"output_schema": {},
"preload": true
}
],
"preload": true
}
],
"custom_tools": [
{
"slug": "GET_IMPORTANT_EMAILS",
"name": "Get Important Emails",
"description": "Fetch emails marked as important from the last 24 hours",
"input_schema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Max results to return"
}
}
},
"output_schema": {},
"extends_toolkit": "gmail",
"preload": true
}
]
}
}
'
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://backend.composio.dev/api/v3.1/tool_router/session/{session_id}/attach"
payload := strings.NewReader("{\n \"experimental\": {\n \"custom_toolkits\": [\n {\n \"slug\": \"ecommerce\",\n \"name\": \"E-Commerce API\",\n \"description\": \"Internal e-commerce API for order management and fulfillment\",\n \"tools\": [\n {\n \"slug\": \"GET_CUSTOMER_ORDERS\",\n \"name\": \"Get Customer Orders\",\n \"description\": \"Fetch recent orders for a customer by their email address\",\n \"input_schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"email\": {\n \"type\": \"string\",\n \"description\": \"Customer email\"\n }\n },\n \"required\": [\n \"email\"\n ]\n },\n \"output_schema\": {},\n \"preload\": true\n }\n ],\n \"preload\": true\n }\n ],\n \"custom_tools\": [\n {\n \"slug\": \"GET_IMPORTANT_EMAILS\",\n \"name\": \"Get Important Emails\",\n \"description\": \"Fetch emails marked as important from the last 24 hours\",\n \"input_schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"limit\": {\n \"type\": \"number\",\n \"description\": \"Max results to return\"\n }\n }\n },\n \"output_schema\": {},\n \"extends_toolkit\": \"gmail\",\n \"preload\": true\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.post("https://backend.composio.dev/api/v3.1/tool_router/session/{session_id}/attach")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"experimental\": {\n \"custom_toolkits\": [\n {\n \"slug\": \"ecommerce\",\n \"name\": \"E-Commerce API\",\n \"description\": \"Internal e-commerce API for order management and fulfillment\",\n \"tools\": [\n {\n \"slug\": \"GET_CUSTOMER_ORDERS\",\n \"name\": \"Get Customer Orders\",\n \"description\": \"Fetch recent orders for a customer by their email address\",\n \"input_schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"email\": {\n \"type\": \"string\",\n \"description\": \"Customer email\"\n }\n },\n \"required\": [\n \"email\"\n ]\n },\n \"output_schema\": {},\n \"preload\": true\n }\n ],\n \"preload\": true\n }\n ],\n \"custom_tools\": [\n {\n \"slug\": \"GET_IMPORTANT_EMAILS\",\n \"name\": \"Get Important Emails\",\n \"description\": \"Fetch emails marked as important from the last 24 hours\",\n \"input_schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"limit\": {\n \"type\": \"number\",\n \"description\": \"Max results to return\"\n }\n }\n },\n \"output_schema\": {},\n \"extends_toolkit\": \"gmail\",\n \"preload\": true\n }\n ]\n }\n}")
.asString();
using RestSharp;
var options = new RestClientOptions("https://backend.composio.dev/api/v3.1/tool_router/session/{session_id}/attach");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-api-key", "<api-key>");
request.AddJsonBody("{\n \"experimental\": {\n \"custom_toolkits\": [\n {\n \"slug\": \"ecommerce\",\n \"name\": \"E-Commerce API\",\n \"description\": \"Internal e-commerce API for order management and fulfillment\",\n \"tools\": [\n {\n \"slug\": \"GET_CUSTOMER_ORDERS\",\n \"name\": \"Get Customer Orders\",\n \"description\": \"Fetch recent orders for a customer by their email address\",\n \"input_schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"email\": {\n \"type\": \"string\",\n \"description\": \"Customer email\"\n }\n },\n \"required\": [\n \"email\"\n ]\n },\n \"output_schema\": {},\n \"preload\": true\n }\n ],\n \"preload\": true\n }\n ],\n \"custom_tools\": [\n {\n \"slug\": \"GET_IMPORTANT_EMAILS\",\n \"name\": \"Get Important Emails\",\n \"description\": \"Fetch emails marked as important from the last 24 hours\",\n \"input_schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"limit\": {\n \"type\": \"number\",\n \"description\": \"Max results to return\"\n }\n }\n },\n \"output_schema\": {},\n \"extends_toolkit\": \"gmail\",\n \"preload\": true\n }\n ]\n }\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Composio Docs","description":"Build AI agents with 1,700+ apps. Connect LLMs to external services like GitHub, Slack, Gmail, and more.","colors":{"primary":"#0007CD","light":"#5B8BF0","dark":"#5B8BF0"},"logo":{"light":"https://mintcdn.com/composio-preview/cL3pOAF8H-TYHF1S/Composio%20Logo.svg?fit=max\u0026auto=format\u0026n=cL3pOAF8H-TYHF1S\u0026q=85\u0026s=c959b1b97e22caccd03fe5d3d71ab52b","dark":"https://mintcdn.com/composio-preview/cL3pOAF8H-TYHF1S/Composio%20Logo%20Dark.svg?fit=max\u0026auto=format\u0026n=cL3pOAF8H-TYHF1S\u0026q=85\u0026s=1b31206b6350aa17315c7ea06c829de5","href":"/docs"},"favicon":{"light":"https://mintcdn.com/composio-preview/cL3pOAF8H-TYHF1S/favicon.ico?fit=max\u0026auto=format\u0026n=cL3pOAF8H-TYHF1S\u0026q=85\u0026s=1e12b5b301d9c338a1c87e58589a4e99","dark":"https://mintcdn.com/composio-preview/cL3pOAF8H-TYHF1S/favicon.ico?fit=max\u0026auto=format\u0026n=cL3pOAF8H-TYHF1S\u0026q=85\u0026s=1e12b5b301d9c338a1c87e58589a4e99"},"api":{"playground":{"display":"interactive"},"examples":{"languages":["python","typescript","bash","go","java","csharp","rust"]}},"appearance":{"default":"dark"},"navbar":{"links":[{"icon":{"style":"brands","name":"github","library":"fontawesome"},"href":"https://github.com/composiohq/composio","type":"github"},{"icon":{"style":"brands","name":"x-twitter","library":"fontawesome"},"href":"https://x.com/composiodevs","label":""}],"primary":{"type":"button","label":"Playground","href":"https://dashboard.composio.dev/~/project/playground?utm_source=docs\u0026utm_medium=navbar\u0026utm_campaign=playground"}},"seo":{"metatags":{"og:site_name":"Composio Docs","robots":"noindex"},"indexing":"all"},"fonts":{"family":"ABC Diatype","weight":400,"source":"fonts/ABCDiatype-Regular.woff2","format":"woff2"},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","mcp","download-spec"],"display":"header"},"interaction":{"drilldown":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"composio-preview","hasAudioNarration":false,"actualSubdomain":"composio-preview","customDomains":[],"gitSource":{"type":"github","owner":"mintlify-onboarding","repo":"composio-preview","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aee717af538f2c21575e5ef","clientVersion":"0.0.4128","searchFilterCounts":[{"language":"default","tag":"Reference","count":403},{"language":"default","tag":"API Reference","count":180},{"language":"default","tag":"Docs","count":80},{"language":"default","tag":"Platform","count":77},{"language":"default","tag":"Toolkits","count":48},{"language":"default","tag":"MCP","count":44},{"language":"default","tag":"Connected Accounts","count":36},{"language":"default","tag":"Triggers","count":34},{"language":"default","tag":"Sessions (prev Tool Router)","count":33},{"language":"default","tag":"Sessions (Prev Tool Router)","count":33}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":":root{--composio-brand: #0007cd}.dark{--composio-brand: #5b8bf0}.hero-agent-demo{--hero-demo-brand: #0007cd;min-height:420px}.dark .hero-agent-demo{--hero-demo-brand: #5b8bf0}.hero-layout{grid-template-columns:minmax(0, 1fr)}@media (min-width: 1024px){.hero-layout{grid-template-columns:minmax(0, 1.05fr) minmax(0, 0.95fr)}}.hero-agent-window{position:absolute;inset-block:0;right:0;display:flex;width:100%;max-width:340px;flex-direction:column;overflow:hidden;border:1px solid rgb(0 7 205 / 22%);background:rgb(255 255 255 / 88%);box-shadow:0 1px 0 rgb(15 15 15 / 4%);backdrop-filter:blur(16px)}.dark .hero-agent-window{border-color:rgb(91 139 240 / 32%);background:rgb(15 23 42 / 92%)}.hero-agent-dot,.hero-agent-send,.hero-running-dot,.hero-running-ping{background:var(--hero-demo-brand)}.hero-agent-header{animation:hero-header-in 9.5s ease-in-out infinite}.hero-agent-message{animation:hero-message-cycle 9.5s cubic-bezier(0.4, 0, 0.2, 1) infinite;transform-origin:center}.hero-agent-thinking{animation:hero-thinking-cycle 9.5s ease-in-out infinite}.hero-agent-thinking span{width:6px;height:6px;animation:hero-pulse-dot 1.4s ease-in-out infinite;background:var(--hero-demo-brand)}.hero-agent-thinking span:nth-child(2){animation-delay:180ms}.hero-agent-thinking span:nth-child(3){animation-delay:360ms}.hero-tool-call{animation:hero-tool-call-cycle 9.5s cubic-bezier(0.4, 0, 0.2, 1) infinite,\n hero-shimmer-text 2s ease-in-out infinite}.hero-tool-shimmer{color:transparent;background-image:linear-gradient(\n 90deg,\n rgb(15 15 15 / 35%) 0%,\n rgb(15 15 15 / 70%) 40%,\n rgb(15 15 15) 50%,\n rgb(15 15 15 / 70%) 60%,\n rgb(15 15 15 / 35%) 100%\n );background-size:200% 100%;background-clip:text}.dark .hero-tool-shimmer{background-image:linear-gradient(\n 90deg,\n rgb(245 245 247 / 35%) 0%,\n rgb(245 245 247 / 70%) 40%,\n rgb(245 245 247) 50%,\n rgb(245 245 247 / 70%) 60%,\n rgb(245 245 247 / 35%) 100%\n )}.hero-agent-connector{position:absolute;z-index:5;top:32%;right:340px;width:60px;height:10%;overflow:visible;color:var(--hero-demo-brand);pointer-events:none}.hero-agent-connector-glow,.hero-agent-connector-line{stroke-dasharray:1;stroke-dashoffset:1;animation:hero-connector-cycle 9.5s cubic-bezier(0.4, 0, 0.2, 1) infinite}.hero-agent-connector-glow{opacity:0;filter:drop-shadow(0 0 6px var(--hero-demo-brand))}.hero-agent-connector-line{opacity:0}.hero-tool-panel{position:absolute;bottom:24px;left:175px;z-index:10;display:flex;width:320px;max-height:60%;flex-direction:column;overflow:hidden;border:1px solid rgb(226 232 240);background:rgb(255 255 255 / 96%);font-family:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;box-shadow:0 24px 48px -18px rgb(15 15 15 / 32%);transform:translateX(-46%);animation:hero-panel-cycle 9.5s cubic-bezier(0.4, 0, 0.2, 1) infinite}.dark .hero-tool-panel{border-color:rgb(51 65 85);background:rgb(15 23 42 / 96%);box-shadow:0 24px 48px -18px rgb(0 0 0 / 62%)}.hero-tool-running{color:var(--hero-demo-brand)}.hero-running-ping{animation:hero-running-ping 1s cubic-bezier(0, 0, 0.2, 1) infinite;opacity:0.6}.hero-tool-results{flex:1;overflow:hidden}.hero-tool-result-row{display:flex;align-items:center;gap:8px;border:1px solid rgb(226 232 240);background:white;padding:6px 8px}.dark .hero-tool-result-row{border-color:rgb(51 65 85);background:rgb(2 6 23)}@keyframes hero-header-in{0%,3%{opacity:0;transform:translateY(6px)}7%,92%{opacity:1;transform:translateY(0)}100%{opacity:0;transform:translateY(-6px)}}@keyframes hero-message-cycle{0%,5%{opacity:0;transform:translateY(8px) scale(0.97)}10%,18%{opacity:1;transform:translateY(0) scale(1)}24%,92%{opacity:0.45;transform:translateY(0) scale(1)}100%{opacity:0;transform:scale(0.97)}}@keyframes hero-thinking-cycle{0%,11%,24%,100%{opacity:0;transform:translateY(6px)}14%,21%{opacity:1;transform:translateY(0)}}@keyframes hero-tool-call-cycle{0%,20%{opacity:0;transform:translateY(8px) scale(0.97)}27%,92%{opacity:1;transform:translateY(0) scale(1)}100%{opacity:0;transform:scale(0.97)}}@keyframes hero-panel-cycle{0%,22%{opacity:0;transform:translateX(-46%) translateX(-8px)}29%,92%{opacity:1;transform:translateX(-46%) translateX(0)}100%{opacity:0;transform:translateX(-46%) translateX(-8px)}}@keyframes hero-connector-cycle{0%,22%{opacity:0;stroke-dashoffset:1}29%,36%{opacity:1;stroke-dashoffset:0}52%,100%{opacity:0;stroke-dashoffset:0}}@keyframes hero-shimmer-text{from{background-position:100% 0}to{background-position:-100% 0}}@keyframes hero-pulse-dot{0%,100%{opacity:1}50%{opacity:0.3}}@keyframes hero-running-ping{75%,100%{opacity:0;transform:scale(2)}}@media (prefers-reduced-motion: reduce){.hero-agent-header,.hero-agent-message,.hero-agent-thinking,.hero-tool-call,.hero-agent-connector-glow,.hero-agent-connector-line,.hero-tool-panel,.hero-running-ping{animation:none!important}.hero-agent-header,.hero-agent-message,.hero-tool-call,.hero-tool-panel{opacity:1}.hero-agent-thinking,.hero-agent-connector-glow,.hero-agent-connector-line{opacity:0}}"}],"page":{"pagePath":"reference/api-reference/tool-router/posttoolroutersessionbysessionidattach","slug":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach","pageMetadata":{"title":"Attach to an existing tool router session (v3.1)","description":"Fetch an existing tool router session by ID.","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidattach","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/attach","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Fetch an existing tool router session by ID.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Attach to an existing tool router session (v3.1)","description":"Fetch an existing tool router session by ID.","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidattach","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/attach","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/composio-preview/3e74df7724d07010/pixelated-circle-worklet.js"],"openApiReferenceData":{"operation":{"summary":"Attach to an existing tool router session (v3.1)","description":"Fetch an existing tool router session by ID.","tags":["Tool Router"],"operationId":"postToolRouterSessionBySessionIdAttach","security":["6b8ded1b-8506-4b14-ad0f-8a3dbe2d220a"],"parameters":["ef9dbc87-ee1f-4cff-bc42-0485fff3168f"],"requestBody":"c6f9426f-a9e4-4037-b5c9-9b94853496bf","responses":{"200":"993ac67c-6fa4-470d-aacc-b51d45ec9333","400":"2e3176b4-e5a8-401f-910a-c10b8cf30e40","401":"393939b2-efde-4f1a-a2d4-63ef76df47fa","404":"3780afb3-d99a-4665-b745-e99ead25b37d","500":"6a603881-035a-415d-8d6a-b9860eb1eff4"},"x-api-version":"3.1","x-mint":{"metadata":{"title":"Attach to an existing tool router session (v3.1)","description":"Fetch an existing tool router session by ID.","deprecated":false},"content":"","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdAttach"},"method":"post","type":"path","servers":["88115a90-88a8-44fd-bf64-8d389b2a91c2"],"path":"/api/v3.1/tool_router/session/{session_id}/attach","baseUrlOptions":["https://backend.composio.dev"],"title":"Attach to an existing tool router session (v3.1)","codeSamples":[],"requestExampleLanguages":["python","typescript","bash","go","java","csharp","rust"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ef9dbc87-ee1f-4cff-bc42-0485fff3168f":{"schema":{"type":"string","format":"toolRouterSessionId","description":"The unique identifier of the tool router session","example":"trs_1a2b3c4d5e6f","isRequired":true,"uniqueKey":"","typeLabel":"string\u003ctoolRouterSessionId>"},"required":true,"description":"The unique identifier of the tool router session","name":"session_id","in":"path"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"experimental":{"type":"object","properties":{"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","isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].slug","typeLabel":"string"},"name":{"type":"string","minLength":1,"maxLength":128,"description":"Display name shown to the LLM and in search results.","example":"E-Commerce API","isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].name","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].description","typeLabel":"string"},"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_\u003cTOOLKIT>_\u003cTOOL> (max 60 chars total).","example":"GET_CUSTOMER_ORDERS","isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].slug","typeLabel":"string"},"name":{"type":"string","minLength":1,"maxLength":128,"description":"Human-readable display name","example":"Get Customer Orders","isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].name","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].description","typeLabel":"string"},"input_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].input_schema.additionalProperties","typeLabel":"any"},"description":"Must have type: \"object\" and a properties field.","example":{"type":"object","properties":{"email":{"type":"string","description":"Customer email"}},"required":["email"]},"isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].input_schema","typeLabel":"object"},"output_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].output_schema.additionalProperties","typeLabel":"any"},"description":"Optional output schema for the tool response.","uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].output_schema","typeLabel":"object"},"preload":{"type":"boolean","description":"SDK hint for direct custom-tool exposure. Not stored in session config; echoed in create/attach responses for inline custom definitions.","uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].preload","typeLabel":"boolean"}},"required":["slug","name","description","input_schema"],"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX]","typeLabel":"object"},"minItems":1,"maxItems":100,"description":"Tools in this custom toolkit","isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools","typeLabel":"object[]"},"preload":{"type":"boolean","description":"SDK hint for direct custom-tool exposure. Not stored in session config; echoed in create/attach responses for inline custom definitions.","uniqueKey":"experimental.custom_toolkits.items.[INDEX].preload","typeLabel":"boolean"}},"required":["slug","name","description","tools"],"uniqueKey":"experimental.custom_toolkits.items.[INDEX]","typeLabel":"object"},"description":"Custom toolkits with grouped tools. Toolkit slugs must not conflict with existing Composio toolkits. All tools are no-auth.","uniqueKey":"experimental.custom_toolkits","typeLabel":"object[]"},"custom_tools":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","minLength":1,"pattern":"^[a-zA-Z0-9_-]+$","description":"Tool slug. Forms LOCAL_\u003cTOOL> (standalone) or LOCAL_\u003cTOOLKIT>_\u003cTOOL> (extending). Max 60 chars total.","example":"GET_IMPORTANT_EMAILS","isRequired":true,"uniqueKey":"experimental.custom_tools.items.[INDEX].slug","typeLabel":"string"},"name":{"type":"string","minLength":1,"maxLength":128,"description":"Human-readable display name","example":"Get Important Emails","isRequired":true,"uniqueKey":"experimental.custom_tools.items.[INDEX].name","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"experimental.custom_tools.items.[INDEX].description","typeLabel":"string"},"input_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"experimental.custom_tools.items.[INDEX].input_schema.additionalProperties","typeLabel":"any"},"description":"Must have type: \"object\" and a properties field.","example":{"type":"object","properties":{"limit":{"type":"number","description":"Max results to return"}}},"isRequired":true,"uniqueKey":"experimental.custom_tools.items.[INDEX].input_schema","typeLabel":"object"},"output_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"experimental.custom_tools.items.[INDEX].output_schema.additionalProperties","typeLabel":"any"},"description":"JSON Schema describing tool output (optional)","uniqueKey":"experimental.custom_tools.items.[INDEX].output_schema","typeLabel":"object"},"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","uniqueKey":"experimental.custom_tools.items.[INDEX].extends_toolkit","typeLabel":"string"},"preload":{"type":"boolean","description":"SDK hint for direct custom-tool exposure. Not stored in session config; echoed in create/attach responses for inline custom definitions.","uniqueKey":"experimental.custom_tools.items.[INDEX].preload","typeLabel":"boolean"}},"required":["slug","name","description","input_schema"],"uniqueKey":"experimental.custom_tools.items.[INDEX]","typeLabel":"object"},"description":"Custom tools to include in search. Standalone tools need no auth. Tools with extends_toolkit inherit the Composio toolkit's connection.","uniqueKey":"experimental.custom_tools","typeLabel":"object[]"}},"additionalProperties":false,"description":"Inline custom tools and toolkits for this request. v3.1 sessions do not persist customs — pass them on every request that needs them.","uniqueKey":"experimental","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"experimental":{"custom_toolkits":[{"slug":"ecommerce","name":"E-Commerce API","description":"Internal e-commerce API for order management and fulfillment","tools":[{"slug":"GET_CUSTOMER_ORDERS","name":"Get Customer Orders","description":"Fetch recent orders for a customer by their email address","input_schema":{"type":"object","properties":{"email":{"type":"string","description":"Customer email"}},"required":["email"]},"output_schema":{},"preload":true}],"preload":true}],"custom_tools":[{"slug":"GET_IMPORTANT_EMAILS","name":"Get Important Emails","description":"Fetch emails marked as important from the last 24 hours","input_schema":{"type":"object","properties":{"limit":{"type":"number","description":"Max results to return"}}},"output_schema":{},"extends_toolkit":"gmail","preload":true}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"993ac67c-6fa4-470d-aacc-b51d45ec9333":{"description":"Session successfully attached. Returns the session payload.","content":{"application/json":{"schema":{"type":"object","properties":{"session_id":{"type":"string","format":"toolRouterSessionId","description":"The identifier of the session","example":"trs_1a2b3c4d5e6f","isRequired":true,"uniqueKey":"session_id","typeLabel":"string\u003ctoolRouterSessionId>"},"mcp":{"type":"object","properties":{"type":{"type":"string","enum":["http"],"description":"The type of the MCP server. Can be http","isRequired":true,"uniqueKey":"mcp.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","description":"The URL of the MCP server","example":"https://app.composio.dev/tool_router/v3/trs_1a2b3c4d5e6f/mcp","isRequired":true,"uniqueKey":"mcp.url","typeLabel":"string\u003curi>"}},"required":["type","url"],"isRequired":true,"uniqueKey":"mcp","typeLabel":"object"},"tool_router_tools":{"type":"array","items":{"type":"string","uniqueKey":"tool_router_tools.items.[INDEX]","typeLabel":"string"},"description":"List of available tools in this session","isRequired":true,"uniqueKey":"tool_router_tools","typeLabel":"string[]"},"config":{"type":"object","properties":{"user_id":{"type":"string","description":"User identifier for this session","isRequired":true,"uniqueKey":"config.user_id","typeLabel":"string"},"instant":{"oneOf":[{"type":"boolean","description":"Instant usage settings. False disables instant usage; an object permits it subject to project permission and session toolkit and tool restrictions.","enum":[false],"isRequired":true,"uniqueKey":"config.instant.oneOf.0","typeLabel":"enum\u003cboolean>"},{"type":"object","description":"Instant usage settings. False disables instant usage; an object permits it subject to project permission and session toolkit and tool restrictions.","required":["return_instant_charge","return_prices_in_search"],"properties":{"return_instant_charge":{"type":"boolean","description":"Whether session tool responses return a top-level instant_charge when a charge is available. Defaults to false; controls response visibility only.","isRequired":true,"uniqueKey":"config.instant.oneOf.1.return_instant_charge","typeLabel":"boolean"},"return_prices_in_search":{"type":"boolean","description":"Experimental. Whether tool search results show each instant tool's price, under instant_account.prices. Defaults to false.","x-experimental":true,"isRequired":true,"uniqueKey":"config.instant.oneOf.1.return_prices_in_search","typeLabel":"boolean"},"toolkits":{"oneOf":[{"type":"object","description":"Toolkits eligible for instant usage, as an enabled or disabled list. If absent, no additional toolkit restriction applies.","required":["enabled"],"properties":{"enabled":{"type":"array","items":{"type":"string","uniqueKey":"config.instant.oneOf.1.toolkits.oneOf.0.enabled.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"config.instant.oneOf.1.toolkits.oneOf.0.enabled","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.instant.oneOf.1.toolkits.oneOf.0","typeLabel":"object"},{"type":"object","description":"Toolkits eligible for instant usage, as an enabled or disabled list. If absent, no additional toolkit restriction applies.","required":["disabled"],"properties":{"disabled":{"type":"array","items":{"type":"string","uniqueKey":"config.instant.oneOf.1.toolkits.oneOf.1.disabled.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"config.instant.oneOf.1.toolkits.oneOf.1.disabled","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.instant.oneOf.1.toolkits.oneOf.1","typeLabel":"object"}],"uniqueKey":"config.instant.oneOf.1.toolkits","typeLabel":"object"},"tools":{"type":"object","additionalProperties":{"oneOf":[{"type":"object","required":["enabled"],"properties":{"enabled":{"type":"array","items":{"type":"string","uniqueKey":"config.instant.oneOf.1.tools.additionalProperties.oneOf.0.enabled.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"config.instant.oneOf.1.tools.additionalProperties.oneOf.0.enabled","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.instant.oneOf.1.tools.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["disabled"],"properties":{"disabled":{"type":"array","items":{"type":"string","uniqueKey":"config.instant.oneOf.1.tools.additionalProperties.oneOf.1.disabled.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"config.instant.oneOf.1.tools.additionalProperties.oneOf.1.disabled","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.instant.oneOf.1.tools.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"config.instant.oneOf.1.tools.additionalProperties","typeLabel":"object"},"description":"Per-toolkit enabled or disabled lists that restrict instant usage. Toolkits absent from this map have no additional tool restriction.","uniqueKey":"config.instant.oneOf.1.tools","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"config.instant.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"config.instant","typeLabel":"enum\u003cboolean> | object"},"preload":{"type":"object","properties":{"tools":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"config.preload.tools.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Explicit preloaded tool slugs, or \"all\" when the session dynamically exposes all app tools allowed by its filters.","isRequired":true,"uniqueKey":"config.preload.tools.oneOf.0","typeLabel":"string[]"},{"type":"string","description":"Explicit preloaded tool slugs, or \"all\" when the session dynamically exposes all app tools allowed by its filters.","enum":["all"],"isRequired":true,"uniqueKey":"config.preload.tools.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"config.preload.tools","typeLabel":"string[] | enum\u003cstring>"}},"required":["tools"],"additionalProperties":false,"description":"Preload configuration. Explicit slugs are returned as an array; dynamic preload is returned as \"all\".","isRequired":true,"uniqueKey":"config.preload","typeLabel":"object"},"search":{"type":"object","properties":{"enable":{"type":"boolean","default":true,"uniqueKey":"config.search.enable","typeLabel":"boolean"}},"description":"Search helper configuration","isRequired":true,"uniqueKey":"config.search","typeLabel":"object"},"execute":{"type":"object","properties":{"enable_multi_execute":{"type":"boolean","default":true,"uniqueKey":"config.execute.enable_multi_execute","typeLabel":"boolean"}},"description":"Execute helper configuration","isRequired":true,"uniqueKey":"config.execute","typeLabel":"object"},"toolkits":{"oneOf":[{"type":"object","description":"Toolkit configuration - either enabled list or disabled list, or toolkits whose tools need approval","required":["enabled"],"properties":{"enabled":{"type":"array","items":{"type":"string","uniqueKey":"config.toolkits.oneOf.0.enabled.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"config.toolkits.oneOf.0.enabled","typeLabel":"string[]"},"require_approval":{"type":"array","items":{"type":"string","uniqueKey":"config.toolkits.oneOf.0.require_approval.items.[INDEX]","typeLabel":"string"},"description":"Tool calls matched here pause until the user approves them.","x-experimental":true,"uniqueKey":"config.toolkits.oneOf.0.require_approval","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.toolkits.oneOf.0","typeLabel":"object"},{"type":"object","description":"Toolkit configuration - either enabled list or disabled list, or toolkits whose tools need approval","required":["disabled"],"properties":{"disabled":{"type":"array","items":{"type":"string","uniqueKey":"config.toolkits.oneOf.1.disabled.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"config.toolkits.oneOf.1.disabled","typeLabel":"string[]"},"require_approval":{"type":"array","items":{"type":"string","uniqueKey":"config.toolkits.oneOf.1.require_approval.items.[INDEX]","typeLabel":"string"},"description":"Tool calls matched here pause until the user approves them.","x-experimental":true,"uniqueKey":"config.toolkits.oneOf.1.require_approval","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.toolkits.oneOf.1","typeLabel":"object"},{"type":"object","description":"Toolkit configuration - either enabled list or disabled list, or toolkits whose tools need approval","required":["require_approval"],"properties":{"require_approval":{"type":"array","items":{"type":"string","uniqueKey":"config.toolkits.oneOf.2.require_approval.items.[INDEX]","typeLabel":"string"},"description":"Tool calls matched here pause until the user approves them.","x-experimental":true,"isRequired":true,"uniqueKey":"config.toolkits.oneOf.2.require_approval","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.toolkits.oneOf.2","typeLabel":"object"}],"uniqueKey":"config.toolkits","typeLabel":"object"},"auth_configs":{"type":"object","additionalProperties":{"type":"string","format":"authConfigId","uniqueKey":"config.auth_configs.additionalProperties","typeLabel":"string\u003cauthConfigId>"},"description":"Auth config overrides per toolkit","uniqueKey":"config.auth_configs","typeLabel":"object"},"manage_connections":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether to enable the connection manager for automatic connection handling","uniqueKey":"config.manage_connections.enabled","typeLabel":"boolean"},"callback_url":{"type":"string","format":"uri","description":"Custom callback URL for connected account auth flows","uniqueKey":"config.manage_connections.callback_url","typeLabel":"string\u003curi>"},"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.","uniqueKey":"config.manage_connections.enable_wait_for_connections","typeLabel":"boolean"},"enable_connection_removal":{"type":"boolean","default":true,"description":"Enable the \"remove\" action in COMPOSIO_MANAGE_CONNECTIONS. Default true.","uniqueKey":"config.manage_connections.enable_connection_removal","typeLabel":"boolean"}},"description":"Manage connections configuration","uniqueKey":"config.manage_connections","typeLabel":"object"},"tools":{"type":"object","additionalProperties":{"oneOf":[{"type":"object","required":["enabled"],"properties":{"enabled":{"type":"array","items":{"type":"string","uniqueKey":"config.tools.additionalProperties.oneOf.0.enabled.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"config.tools.additionalProperties.oneOf.0.enabled","typeLabel":"string[]"},"require_approval":{"type":"array","items":{"type":"string","uniqueKey":"config.tools.additionalProperties.oneOf.0.require_approval.items.[INDEX]","typeLabel":"string"},"description":"Tool calls matched here pause until the user approves them.","x-experimental":true,"uniqueKey":"config.tools.additionalProperties.oneOf.0.require_approval","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.tools.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["disabled"],"properties":{"disabled":{"type":"array","items":{"type":"string","uniqueKey":"config.tools.additionalProperties.oneOf.1.disabled.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"config.tools.additionalProperties.oneOf.1.disabled","typeLabel":"string[]"},"require_approval":{"type":"array","items":{"type":"string","uniqueKey":"config.tools.additionalProperties.oneOf.1.require_approval.items.[INDEX]","typeLabel":"string"},"description":"Tool calls matched here pause until the user approves them.","x-experimental":true,"uniqueKey":"config.tools.additionalProperties.oneOf.1.require_approval","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.tools.additionalProperties.oneOf.1","typeLabel":"object"},{"type":"object","required":["tags"],"properties":{"tags":{"type":"object","properties":{"enabled":{"type":"array","items":{"type":"string","enum":["readOnlyHint","createHint","updateHint","destructiveHint","idempotentHint","openWorldHint"],"uniqueKey":"config.tools.additionalProperties.oneOf.2.tags.enabled.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Tags that the tool must have at least one of","uniqueKey":"config.tools.additionalProperties.oneOf.2.tags.enabled","typeLabel":"enum\u003cstring>[]"},"disabled":{"type":"array","items":{"type":"string","enum":["readOnlyHint","createHint","updateHint","destructiveHint","idempotentHint","openWorldHint"],"uniqueKey":"config.tools.additionalProperties.oneOf.2.tags.disabled.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Tags that the tool must NOT have any of","uniqueKey":"config.tools.additionalProperties.oneOf.2.tags.disabled","typeLabel":"enum\u003cstring>[]"},"require_approval":{"type":"array","items":{"type":"string","enum":["readOnlyHint","createHint","updateHint","destructiveHint","idempotentHint","openWorldHint"],"uniqueKey":"config.tools.additionalProperties.oneOf.2.tags.require_approval.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Tool calls matched here pause until the user approves them.","x-experimental":true,"uniqueKey":"config.tools.additionalProperties.oneOf.2.tags.require_approval","typeLabel":"enum\u003cstring>[]"}},"isRequired":true,"uniqueKey":"config.tools.additionalProperties.oneOf.2.tags","typeLabel":"object"},"require_approval":{"type":"array","items":{"type":"string","uniqueKey":"config.tools.additionalProperties.oneOf.2.require_approval.items.[INDEX]","typeLabel":"string"},"description":"Tool calls matched here pause until the user approves them.","x-experimental":true,"uniqueKey":"config.tools.additionalProperties.oneOf.2.require_approval","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.tools.additionalProperties.oneOf.2","typeLabel":"object"},{"type":"object","required":["require_approval"],"properties":{"require_approval":{"type":"array","items":{"type":"string","uniqueKey":"config.tools.additionalProperties.oneOf.3.require_approval.items.[INDEX]","typeLabel":"string"},"description":"Tool calls matched here pause until the user approves them.","x-experimental":true,"isRequired":true,"uniqueKey":"config.tools.additionalProperties.oneOf.3.require_approval","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"config.tools.additionalProperties.oneOf.3","typeLabel":"object"}],"uniqueKey":"config.tools.additionalProperties","typeLabel":"object"},"description":"Tool-level configuration per toolkit: tools to enable or disable, or tools that need approval","uniqueKey":"config.tools","typeLabel":"object"},"tags":{"type":"object","properties":{"enabled":{"type":"array","items":{"type":"string","enum":["readOnlyHint","createHint","updateHint","destructiveHint","idempotentHint","openWorldHint"],"uniqueKey":"config.tags.enabled.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Tags that the tool must have at least one of","uniqueKey":"config.tags.enabled","typeLabel":"enum\u003cstring>[]"},"disabled":{"type":"array","items":{"type":"string","enum":["readOnlyHint","createHint","updateHint","destructiveHint","idempotentHint","openWorldHint"],"uniqueKey":"config.tags.disabled.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Tags that the tool must NOT have any of","uniqueKey":"config.tags.disabled","typeLabel":"enum\u003cstring>[]"},"require_approval":{"type":"array","items":{"type":"string","enum":["readOnlyHint","createHint","updateHint","destructiveHint","idempotentHint","openWorldHint"],"uniqueKey":"config.tags.require_approval.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Tool calls matched here pause until the user approves them.","x-experimental":true,"uniqueKey":"config.tags.require_approval","typeLabel":"enum\u003cstring>[]"}},"description":"MCP tool annotation hints for filtering tools with enabled/disabled support, and experimentally the tags whose tools need approval. 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.","uniqueKey":"config.tags","typeLabel":"object"},"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.","uniqueKey":"config.workbench.enable","typeLabel":"boolean"},"tool_execution_enabled":{"type":"boolean","description":"Whether tool execution is enabled in the workbench","uniqueKey":"config.workbench.tool_execution_enabled","typeLabel":"boolean"},"proxy_execution_enabled":{"type":"boolean","description":"Whether proxy execution is enabled in the workbench","uniqueKey":"config.workbench.proxy_execution_enabled","typeLabel":"boolean"},"auto_offload_threshold":{"type":"number","description":"Character threshold after which tool execution response are saved to a file in workbench. Default is 20k.","exclusiveMinimum":0,"uniqueKey":"config.workbench.auto_offload_threshold","typeLabel":"number"},"sandbox_size":{"type":"string","enum":["standard","medium","large","xlarge"],"description":"Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4 vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard.","uniqueKey":"config.workbench.sandbox_size","typeLabel":"enum\u003cstring>"}},"default":{"enable":true,"proxy_execution_enabled":true},"description":"Workbench configuration","uniqueKey":"config.workbench","typeLabel":"object"},"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.","uniqueKey":"config.multi_account.enable","typeLabel":"boolean"},"max_accounts_per_toolkit":{"type":"integer","description":"Maximum number of connected accounts allowed per toolkit. Defaults to 5 when multi-account is enabled.","uniqueKey":"config.multi_account.max_accounts_per_toolkit","typeLabel":"integer"},"require_explicit_selection":{"type":"boolean","description":"When true, require explicit account selection when multiple accounts are connected. When false (default), use the first/default account.","uniqueKey":"config.multi_account.require_explicit_selection","typeLabel":"boolean"}},"description":"Multi-account configuration for this session.","uniqueKey":"config.multi_account","typeLabel":"object"},"proxy_execute":{"type":"object","properties":{"enable":{"type":"boolean","description":"When true, enables proxy execute outside the workbench. When false, also disables proxy execution inside the workbench.","isRequired":true,"uniqueKey":"config.proxy_execute.enable","typeLabel":"boolean"}},"required":["enable"],"description":"Proxy execute configuration for this session. Omitted when not set.","uniqueKey":"config.proxy_execute","typeLabel":"object"},"hooks":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","id","applies_to","handler"],"properties":{"type":{"type":"string","enum":["before_execute"],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","pattern":"^[a-z0-9_-]{1,64}$","description":"Unique within the session. Shows up in results and logs.","isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.id","typeLabel":"string"},"applies_to":{"oneOf":[{"type":"string","description":"Which tools the hook covers: \"all\" for all of them, or only the listed toolkits.","enum":["all"],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.applies_to.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"Which tools the hook covers: \"all\" for all of them, or only the listed toolkits.","required":["toolkits"],"properties":{"toolkits":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.applies_to.oneOf.1.toolkits.items.[INDEX]","typeLabel":"string"},"minItems":1,"description":"Toolkit slugs","isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.applies_to.oneOf.1.toolkits","typeLabel":"string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.applies_to.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.applies_to","typeLabel":"enum\u003cstring> | object"},"handler":{"type":"object","properties":{"type":{"type":"string","enum":["condition_check"],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.handler.type","typeLabel":"enum\u003cstring>"},"condition":{"type":"string","minLength":1,"maxLength":2000,"description":"What to block, written as a plain sentence. For example: \"Sending email to anyone outside example.org\".","isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.handler.condition","typeLabel":"string"},"action":{"type":"string","enum":["block"],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.handler.action","typeLabel":"enum\u003cstring>"}},"required":["type","condition","action"],"additionalProperties":false,"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0.handler","typeLabel":"object"},"name":{"type":"string","minLength":1,"maxLength":120,"description":"A readable name. The agent sees it when this hook blocks a call.","uniqueKey":"config.hooks.items.[INDEX].oneOf.0.name","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"config.hooks.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","id","applies_to","handler"],"properties":{"type":{"type":"string","enum":["after_execute"],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","pattern":"^[a-z0-9_-]{1,64}$","description":"Unique within the session. Shows up in results and logs.","isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.id","typeLabel":"string"},"applies_to":{"oneOf":[{"type":"string","description":"Which tools the hook covers: \"all\" for all of them, or only the listed toolkits.","enum":["all"],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.applies_to.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"Which tools the hook covers: \"all\" for all of them, or only the listed toolkits.","required":["toolkits"],"properties":{"toolkits":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.applies_to.oneOf.1.toolkits.items.[INDEX]","typeLabel":"string"},"minItems":1,"description":"Toolkit slugs","isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.applies_to.oneOf.1.toolkits","typeLabel":"string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.applies_to.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.applies_to","typeLabel":"enum\u003cstring> | object"},"handler":{"oneOf":[{"type":"object","required":["type","condition","action"],"properties":{"type":{"type":"string","enum":["condition_check"],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.handler.oneOf.0.type","typeLabel":"enum\u003cstring>"},"condition":{"type":"string","minLength":1,"maxLength":2000,"description":"What to block, written as a plain sentence. For example: \"Sending email to anyone outside example.org\".","isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.handler.oneOf.0.condition","typeLabel":"string"},"action":{"type":"string","enum":["block"],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.handler.oneOf.0.action","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.handler.oneOf.0","typeLabel":"object"},{"type":"object","description":"Blocks a tool response that tries to manipulate the agent: override its instructions, change its role, or make it take actions the user didn't ask for.","required":["type","action"],"properties":{"type":{"type":"string","enum":["prompt_injection_check"],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.handler.oneOf.1.type","typeLabel":"enum\u003cstring>"},"action":{"type":"string","enum":["block"],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.handler.oneOf.1.action","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.handler.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1.handler","typeLabel":"object"},"name":{"type":"string","minLength":1,"maxLength":120,"description":"A readable name. The agent sees it when this hook blocks a call.","uniqueKey":"config.hooks.items.[INDEX].oneOf.1.name","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"config.hooks.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"config.hooks.items.[INDEX]","typeLabel":"object"},"maxItems":20,"description":"Hooks that run on this session's tool calls.","uniqueKey":"config.hooks","typeLabel":"object[]"},"connected_accounts":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","format":"connectedAccountId","uniqueKey":"config.connected_accounts.additionalProperties.items.[INDEX]","typeLabel":"string\u003cconnectedAccountId>"},"minItems":1,"uniqueKey":"config.connected_accounts.additionalProperties","typeLabel":"string\u003cconnectedAccountId>[]"},"description":"Per-toolkit connected account overrides (array of nano-IDs). Multi-account sessions can pin more than one account per toolkit; otherwise length is 1.","uniqueKey":"config.connected_accounts","typeLabel":"object"}},"required":["user_id","instant","preload","search","execute"],"description":"The configuration used to create this session","isRequired":true,"uniqueKey":"config","typeLabel":"object"},"config_version":{"type":"integer","description":"Monotonic version of the config. Incremented on each PATCH. Use for optimistic concurrency control.","isRequired":true,"uniqueKey":"config_version","typeLabel":"integer"},"experimental":{"type":"object","properties":{"assistive_prompt":{"type":"string","description":"The assistive system prompt for the tool router session","uniqueKey":"experimental.assistive_prompt","typeLabel":"string"},"custom_toolkits":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","minLength":1,"pattern":"^[a-zA-Z0-9_-]+$","isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].slug","typeLabel":"string"},"name":{"type":"string","minLength":1,"maxLength":128,"isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","minLength":1,"maxLength":2048,"isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].description","typeLabel":"string"},"tools":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","description":"Prefixed tool slug (e.g. LOCAL_CRM_FIND_CUSTOMER)","isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].slug","typeLabel":"string"},"name":{"type":"string","minLength":1,"maxLength":128,"isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","minLength":1,"maxLength":5120,"isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].description","typeLabel":"string"},"input_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].input_schema.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].input_schema","typeLabel":"object"},"original_slug":{"type":"string","description":"Original tool slug as provided by the user","isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].original_slug","typeLabel":"string"},"output_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].output_schema.additionalProperties","typeLabel":"any"},"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].output_schema","typeLabel":"object"},"preload":{"type":"boolean","description":"Echoes the SDK-local preload hint provided for this tool","uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX].preload","typeLabel":"boolean"}},"required":["slug","name","description","input_schema","original_slug"],"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"experimental.custom_toolkits.items.[INDEX].tools","typeLabel":"object[]"},"preload":{"type":"boolean","description":"Echoes the SDK-local preload hint provided for this toolkit","uniqueKey":"experimental.custom_toolkits.items.[INDEX].preload","typeLabel":"boolean"}},"required":["slug","name","description","tools"],"uniqueKey":"experimental.custom_toolkits.items.[INDEX]","typeLabel":"object"},"description":"User-defined custom toolkits with grouped tools (no-auth)","uniqueKey":"experimental.custom_toolkits","typeLabel":"object[]"},"custom_tools":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","description":"Prefixed tool slug (e.g. LOCAL_GMAIL_GET_IMPORTANT_EMAILS)","isRequired":true,"uniqueKey":"experimental.custom_tools.items.[INDEX].slug","typeLabel":"string"},"name":{"type":"string","minLength":1,"maxLength":128,"isRequired":true,"uniqueKey":"experimental.custom_tools.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","minLength":1,"maxLength":5120,"isRequired":true,"uniqueKey":"experimental.custom_tools.items.[INDEX].description","typeLabel":"string"},"input_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"experimental.custom_tools.items.[INDEX].input_schema.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"experimental.custom_tools.items.[INDEX].input_schema","typeLabel":"object"},"original_slug":{"type":"string","description":"Original tool slug as provided by the user","isRequired":true,"uniqueKey":"experimental.custom_tools.items.[INDEX].original_slug","typeLabel":"string"},"output_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"experimental.custom_tools.items.[INDEX].output_schema.additionalProperties","typeLabel":"any"},"uniqueKey":"experimental.custom_tools.items.[INDEX].output_schema","typeLabel":"object"},"extends_toolkit":{"type":"string","minLength":1,"uniqueKey":"experimental.custom_tools.items.[INDEX].extends_toolkit","typeLabel":"string"},"preload":{"type":"boolean","description":"Echoes the SDK-local preload hint provided for this tool","uniqueKey":"experimental.custom_tools.items.[INDEX].preload","typeLabel":"boolean"}},"required":["slug","name","description","input_schema","original_slug"],"uniqueKey":"experimental.custom_tools.items.[INDEX]","typeLabel":"object"},"description":"Custom tools — standalone or extending Composio toolkits","uniqueKey":"experimental.custom_tools","typeLabel":"object[]"},"no_elicitation_support_fallback":{"type":"string","enum":["deny","allow"],"description":"What session MCP does with a tool call that needs approval when the MCP client can't ask the user. Omitted when not set, which means deny.","x-experimental":true,"uniqueKey":"experimental.no_elicitation_support_fallback","typeLabel":"enum\u003cstring>"},"source_session_config":{"type":"object","properties":{"id":{"type":"string","format":"sessionConfigId","isRequired":true,"uniqueKey":"experimental.source_session_config.id","typeLabel":"string\u003csessionConfigId>"}},"required":["id"],"description":"Experimental provenance for the reusable Session config most recently applied to this Session.","x-experimental":true,"uniqueKey":"experimental.source_session_config","typeLabel":"object"}},"description":"Experimental v3.1 features","x-experimental":true,"uniqueKey":"experimental","typeLabel":"object"},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["PRELOAD_TOOLS_HIGH_CONTEXT_USAGE"],"description":"Stable machine code identifying the advisory. Safe to switch on in client code.","example":"PRELOAD_TOOLS_HIGH_CONTEXT_USAGE","isRequired":true,"uniqueKey":"warnings.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable description of the advisory. Suitable for logging or surfacing to end users.","example":"Session preloads 25 tools; each preloaded tool adds to the agent context window. Consider keeping the list at or under ~20 tools.","isRequired":true,"uniqueKey":"warnings.items.[INDEX].message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"warnings.items.[INDEX]","typeLabel":"object"},"default":[],"description":"Advisory list — the session exists and is usable, but the listed issues may warrant attention.","example":[{"code":"PRELOAD_TOOLS_HIGH_CONTEXT_USAGE","message":"Session preloads 25 tools; each preloaded tool adds to the agent context window. Consider keeping the list at or under ~20 tools."}],"uniqueKey":"warnings","typeLabel":"object[]"}},"required":["session_id","mcp","tool_router_tools","config","config_version"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"session_id":"trs_1a2b3c4d5e6f","mcp":{"type":"http","url":"https://app.composio.dev/tool_router/v3/trs_1a2b3c4d5e6f/mcp"},"tool_router_tools":["\u003cstring>"],"config":{"user_id":"\u003cstring>","instant":false,"preload":{"tools":["\u003cstring>"]},"search":{"enable":true},"execute":{"enable_multi_execute":true},"toolkits":{"enabled":["\u003cstring>"],"require_approval":["\u003cstring>"]},"auth_configs":{},"manage_connections":{"enabled":true,"callback_url":"\u003cstring>","enable_wait_for_connections":false,"enable_connection_removal":true},"tools":{},"tags":{"enabled":["readOnlyHint"],"disabled":["readOnlyHint"],"require_approval":["readOnlyHint"]},"workbench":{"enable":true,"proxy_execution_enabled":true},"multi_account":{"enable":true,"max_accounts_per_toolkit":123,"require_explicit_selection":true},"proxy_execute":{"enable":true},"hooks":[{"type":"before_execute","id":"\u003cstring>","applies_to":"all","handler":{"type":"condition_check","condition":"\u003cstring>","action":"block"},"name":"\u003cstring>"}],"connected_accounts":{}},"config_version":123,"experimental":{"assistive_prompt":"\u003cstring>","custom_toolkits":[{"slug":"\u003cstring>","name":"\u003cstring>","description":"\u003cstring>","tools":[{"slug":"\u003cstring>","name":"\u003cstring>","description":"\u003cstring>","input_schema":{},"original_slug":"\u003cstring>","output_schema":{},"preload":true}],"preload":true}],"custom_tools":[{"slug":"\u003cstring>","name":"\u003cstring>","description":"\u003cstring>","input_schema":{},"original_slug":"\u003cstring>","output_schema":{},"extends_toolkit":"\u003cstring>","preload":true}],"no_elicitation_support_fallback":"deny","source_session_config":{"id":"\u003cstring>"}},"warnings":[{"code":"PRELOAD_TOOLS_HIGH_CONTEXT_USAGE","message":"Session preloads 25 tools; each preloaded tool adds to the agent context window. Consider keeping the list at or under ~20 tools."}]}}},"exampleType":"generated"}},"exampleType":"generated"},"2e3176b4-e5a8-401f-910a-c10b8cf30e40":{"description":"Bad request. Custom tool validation failed (slug collision, invalid extends_toolkit, schema invalid, etc).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"number","isRequired":true,"uniqueKey":"error.code","typeLabel":"number"},"slug":{"type":"string","isRequired":true,"uniqueKey":"error.slug","typeLabel":"string"},"status":{"type":"number","isRequired":true,"uniqueKey":"error.status","typeLabel":"number"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"},"suggested_fix":{"type":"string","uniqueKey":"error.suggested_fix","typeLabel":"string"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.errors","typeLabel":"string[]"}},"required":["message","code","slug","status"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":123,"slug":"\u003cstring>","status":123,"request_id":"\u003cstring>","suggested_fix":"\u003cstring>","errors":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"393939b2-efde-4f1a-a2d4-63ef76df47fa":{"description":"Unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"number","isRequired":true,"uniqueKey":"error.code","typeLabel":"number"},"slug":{"type":"string","isRequired":true,"uniqueKey":"error.slug","typeLabel":"string"},"status":{"type":"number","isRequired":true,"uniqueKey":"error.status","typeLabel":"number"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"},"suggested_fix":{"type":"string","uniqueKey":"error.suggested_fix","typeLabel":"string"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.errors","typeLabel":"string[]"}},"required":["message","code","slug","status"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":123,"slug":"\u003cstring>","status":123,"request_id":"\u003cstring>","suggested_fix":"\u003cstring>","errors":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"3780afb3-d99a-4665-b745-e99ead25b37d":{"description":"Session not found or has been deleted.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"number","isRequired":true,"uniqueKey":"error.code","typeLabel":"number"},"slug":{"type":"string","isRequired":true,"uniqueKey":"error.slug","typeLabel":"string"},"status":{"type":"number","isRequired":true,"uniqueKey":"error.status","typeLabel":"number"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"},"suggested_fix":{"type":"string","uniqueKey":"error.suggested_fix","typeLabel":"string"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.errors","typeLabel":"string[]"}},"required":["message","code","slug","status"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":123,"slug":"\u003cstring>","status":123,"request_id":"\u003cstring>","suggested_fix":"\u003cstring>","errors":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"6a603881-035a-415d-8d6a-b9860eb1eff4":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"number","isRequired":true,"uniqueKey":"error.code","typeLabel":"number"},"slug":{"type":"string","isRequired":true,"uniqueKey":"error.slug","typeLabel":"string"},"status":{"type":"number","isRequired":true,"uniqueKey":"error.status","typeLabel":"number"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"},"suggested_fix":{"type":"string","uniqueKey":"error.suggested_fix","typeLabel":"string"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.errors","typeLabel":"string[]"}},"required":["message","code","slug","status"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":123,"slug":"\u003cstring>","status":123,"request_id":"\u003cstring>","suggested_fix":"\u003cstring>","errors":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6b8ded1b-8506-4b14-ad0f-8a3dbe2d220a":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your Composio project API key. Create or copy it from the Composio dashboard.","x-default":"your-project-api-key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"88115a90-88a8-44fd-bf64-8d389b2a91c2":{"url":"https://backend.composio.dev","description":"Composio production API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your Composio project API key. Create or copy it from the Composio dashboard.","x-default":"your-project-api-key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"Your Composio project API key. Create or copy it from the Composio dashboard.","isRequired":true,"default":"your-project-api-key","typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"composio-preview","siteName":"Composio Docs","title":"Attach to an existing tool router session (v3.1) - Composio Docs","navMaps":{"firstHrefInVersion":{"v3.1":{"href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach","matchLevel":0},"v3.0":{"href":"/reference/v3/api-reference/tool-router/posttoolroutersession","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T23:37:56.299Z","originalFileLocation":"reference/api-reference/tool-router/posttoolroutersessionbysessionidattach.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Fetch an existing tool router session by ID.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Composio Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/composio-preview/clZwxWuV-UjwHDpH/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/composio-preview/clZwxWuV-UjwHDpH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/composio-preview/clZwxWuV-UjwHDpH/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/composio-preview/clZwxWuV-UjwHDpH/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/composio-preview/clZwxWuV-UjwHDpH/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/composio-preview/clZwxWuV-UjwHDpH/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/composio-preview/clZwxWuV-UjwHDpH/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/composio-preview/clZwxWuV-UjwHDpH/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/composio-preview/clZwxWuV-UjwHDpH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Attach to an existing tool router session (v3.1) - Composio Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fetch an existing tool router session by ID.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Composio Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://composio-preview.mintlify.site/_mintlify/api/og/v2?division=Sessions+%28Prev+Tool+Router%29\u0026amp;title=Attach+to+an+existing+tool+router+session+%28v3.1%29\u0026amp;description=Fetch+an+existing+tool+router+session+by+ID.\u0026amp;theme=2a6064aea71db6aefd788ca2\u0026amp;signature=da3f9412477bbb6bd0127a7d0ec7712c4986483927076082d20172f343ca24e7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Attach to an existing tool router session (v3.1) - Composio Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fetch an existing tool router session by ID.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://composio-preview.mintlify.site/_mintlify/api/og/v2?division=Sessions+%28Prev+Tool+Router%29\u0026amp;title=Attach+to+an+existing+tool+router+session+%28v3.1%29\u0026amp;description=Fetch+an+existing+tool+router+session+by+ID.\u0026amp;theme=2a6064aea71db6aefd788ca2\u0026amp;signature=da3f9412477bbb6bd0127a7d0ec7712c4986483927076082d20172f343ca24e7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/composio-preview/clZwxWuV-UjwHDpH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Composio Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0007CD\">\u003clink data-mint-head rel=\"canonical\" href=\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://composio-preview.mintlify.app/#organization\",\"name\":\"Composio Docs\",\"url\":\"https://composio-preview.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/composio-preview/cL3pOAF8H-TYHF1S/Composio%20Logo.svg?fit=max\u0026auto=format\u0026n=cL3pOAF8H-TYHF1S\u0026q=85\u0026s=c959b1b97e22caccd03fe5d3d71ab52b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://composio-preview.mintlify.app#website\",\"name\":\"Composio Docs\",\"url\":\"https://composio-preview.mintlify.app\",\"publisher\":{\"@id\":\"https://composio-preview.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach#webpage\",\"url\":\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach\",\"name\":\"Attach to an existing tool router session (v3.1)\",\"description\":\"Fetch an existing tool router session by ID.\",\"dateModified\":\"2026-11-06T23:37:56.299Z\",\"isPartOf\":{\"@id\":\"https://composio-preview.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sessions (Prev Tool Router)\",\"item\":\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/getsessionconfigs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Attach to an existing tool router session (v3.1)\",\"item\":\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach#apireference\",\"headline\":\"Attach to an existing tool router session (v3.1)\",\"name\":\"Attach to an existing tool router session (v3.1)\",\"description\":\"Fetch an existing tool router session by ID.\",\"url\":\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach\",\"mainEntityOfPage\":{\"@id\":\"https://composio-preview.mintlify.app/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach#webpage\"},\"dateModified\":\"2026-11-06T23:37:56.299Z\",\"publisher\":{\"@id\":\"https://composio-preview.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://composio-preview.mintlify.app#website\"}}]}\u003c/script>","agentPointerHref":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach.md","siteName":"Composio Docs","nav":{"global":null,"tabs":[{"tab":"Docs","products":[{"product":"Platform","description":"Build agents with the Composio SDK.","groups":[{"group":"Get started","pages":[{"group":"Agent setup","root":{"title":"Overview","href":"/docs/agent-setup"},"directory":"accordion","pages":[{"title":"Authenticate an unattended agent","sidebarTitle":"Unattended Agent Auth","href":"/docs/agent-setup/unattended-authentication"},{"title":"Clients","href":"/docs/agent-setup/clients"}]},{"title":"Quickstart","href":"/docs/quickstart"},{"group":"SDKs and frameworks","root":{"title":"SDKs and frameworks","href":"/docs/providers/index"},"directory":"accordion","pages":[{"title":"Anthropic","href":"/docs/providers/anthropic"},{"title":"OpenAI","href":"/docs/providers/openai"},{"title":"Vercel AI SDK","href":"/docs/providers/vercel"},{"title":"Pi","href":"/docs/providers/pi"},{"title":"Eve","href":"/docs/providers/eve"},{"title":"Google","href":"/docs/providers/google"},{"title":"TypeSafe","href":"/docs/providers/typesafe"},{"title":"LangChain","href":"/docs/providers/langchain"},{"title":"AutoGen","href":"/docs/providers/autogen"},{"title":"CrewAI","href":"/docs/providers/crewai"},{"title":"LlamaIndex","href":"/docs/providers/llamaindex"},{"title":"Mastra","href":"/docs/providers/mastra"},{"group":"Custom providers","root":{"title":"Custom Providers","href":"/docs/providers/custom-providers/index"},"directory":"accordion","pages":[{"title":"TypeScript Custom Provider","href":"/docs/providers/custom-providers/typescript"},{"title":"Python Custom Provider","href":"/docs/providers/custom-providers/python"}]}]}]},{"group":"Build","pages":[{"group":"Sessions","pages":[{"title":"What is a session?","sidebarTitle":"What is a Session?","href":"/docs/how-composio-works"},{"title":"Configuring Sessions","href":"/docs/configuring-sessions"},{"title":"Using saved session configs","href":"/docs/session-configs"},{"title":"Using sessions via MCP","href":"/docs/sessions-via-mcp"}]},{"group":"Toolkits \u0026 Tools","pages":[{"title":"Toolkits","href":"/docs/toolkits"},{"title":"Instant Tools","href":"/docs/instant-tools"}]},{"group":"Governance","pages":[{"title":"Tool hints","href":"/docs/governance/tool-hints"},{"title":"Approvals","href":"/docs/governance/approvals"},{"title":"Firewall","href":"/docs/firewall"}]},{"group":"Authentication","root":{"title":"Authentication","href":"/docs/authentication/index"},"directory":"accordion","pages":[{"title":"Managed authentication for your own tools","href":"/docs/authentication/managed-auth-for-custom-tools"},{"title":"Managing multiple connected accounts","sidebarTitle":"Multiple connected accounts","href":"/docs/authentication/managing-multiple-connected-accounts"},{"title":"Controlling scopes","href":"/docs/authentication/controlling-scopes"},{"title":"Manual auth management","href":"/docs/authentication/manually-authenticating"},{"title":"Programmatic auth configs","href":"/docs/authentication/programmatic-auth-configs"},{"title":"Importing existing connections","href":"/docs/authentication/importing-existing-connections"}]},{"title":"Skills","href":"/docs/skills"},{"group":"Triggers","pages":[{"title":"Triggers","href":"/docs/triggers"},{"group":"Set up triggers","pages":[{"title":"Creating triggers","href":"/docs/setting-up-triggers/creating-triggers"},{"title":"Receiving events","href":"/docs/setting-up-triggers/subscribing-to-events"},{"title":"Managing triggers","href":"/docs/setting-up-triggers/managing-triggers"},{"title":"Custom OAuth webhooks","href":"/docs/setting-up-triggers/custom-oauth-webhooks"},{"title":"Troubleshooting triggers","href":"/docs/setting-up-triggers/troubleshooting"}]}]}]},{"group":"Customize","pages":[{"group":"Extend sessions","expanded":false,"pages":[{"title":"Proxy execute","href":"/docs/extending-sessions/proxy-execute"},{"title":"Custom Tools and Toolkits","href":"/docs/extending-sessions/custom-tools-and-toolkits"},{"title":"Shared connections","href":"/docs/extending-sessions/shared-connections"},{"title":"Custom MCP","href":"/docs/extending-sessions/custom-mcp"}]},{"group":"Sandboxes","expanded":false,"pages":[{"title":"Remote sandbox","href":"/docs/sandbox/remote"},{"title":"Local sandbox","href":"/docs/sandbox/local"}]},{"group":"Guides \u0026 Examples","pages":[{"title":"Examples","sidebarTitle":"Overview","href":"/examples/index"},{"title":"Design a consumer agent with Composio","href":"/docs/consumer-agents"},{"title":"Design a B2B agent with Composio","href":"/docs/b2b-agents"}]}]},{"group":"Ship","pages":[{"title":"Move from prototype to production","href":"/docs/production-readiness"},{"title":"White-labeling authentication","href":"/docs/authentication/white-labeling-authentication"},{"group":"Production readiness","pages":[{"title":"Managed vs custom auth","href":"/docs/authentication/custom-app-vs-managed-app"},{"title":"Rate Limits","sidebarTitle":"Rate limits","href":"/reference/rate-limits"},{"title":"Stream logs to a SIEM","href":"/docs/poc-to-prod/stream-logs-to-a-siem"}]},{"group":"Security and data","expanded":false,"pages":[{"title":"Security","href":"/docs/security/overview"},{"title":"Token custody architecture","href":"/docs/security/token-custody"},{"title":"Data retention and handling","href":"/docs/security/data-retention"},{"title":"Zero Data Retention","href":"/docs/security/zero-data-retention"}]}]},{"group":"Reference and Migration","pages":[{"group":"Migration and legacy","expanded":false,"pages":[{"title":"Sessions vs Direct Execution","href":"/docs/sessions-vs-direct-execution"},{"group":"Migration guides","root":{"title":"Migration guides","href":"/docs/migration-guide/index"},"expanded":false,"directory":"accordion","pages":[{"title":"Migrate from No Auth to Instant","href":"/docs/migration-guide/no-auth-to-instant"},{"title":"Migrating from Direct Tools to Sessions","href":"/docs/migration-guide/direct-to-sessions"},{"title":"Migrating from MCP servers to Sessions","href":"/docs/migration-guide/mcp-servers-to-sessions"},{"title":"Migrating from Experimental Tool Router","href":"/docs/migration-guide/tool-router-beta"},{"title":"Toolkit versioning migration","href":"/docs/migration-guide/toolkit-versioning"},{"title":"Our next generation SDKs","href":"/docs/migration-guide/new-sdk"}]},{"group":"Direct execution","expanded":false,"pages":[{"title":"Fetching tools and schemas","href":"/docs/tools-direct/fetching-tools"},{"title":"Authenticating Tools","href":"/docs/tools-direct/authenticating-tools"},{"title":"Executing tools directly","href":"/docs/tools-direct/executing-tools"},{"group":"Modify tool behavior","pages":[{"title":"Schema Modifiers","href":"/docs/tools-direct/modify-tool-behavior/schema-modifiers"},{"title":"Before Execution Modifiers","href":"/docs/tools-direct/modify-tool-behavior/before-execution-modifiers"},{"title":"After Execution Modifiers","href":"/docs/tools-direct/modify-tool-behavior/after-execution-modifiers"}]},{"title":"Toolkit Versioning","href":"/docs/tools-direct/toolkit-versioning"}]},{"group":"Direct auth","expanded":false,"pages":[{"title":"Custom Auth Configs","href":"/docs/auth-configuration/custom-auth-configs"},{"title":"White-labeling (direct execution)","href":"/docs/auth-configuration/white-labeling"},{"title":"Custom Auth Parameters","href":"/docs/auth-configuration/custom-auth-params"},{"title":"Connected Accounts","href":"/docs/auth-configuration/connected-accounts"},{"title":"Migrating from initiate() to link()","href":"/docs/auth-configuration/migrating-initiate-to-link"}]}]}]},{"group":"Shared resources","pages":[{"title":"Build with the Composio skill","href":"/docs/using-composio-skill"}]}]},{"product":"For You","description":"Connect your apps to AI clients.","groups":[{"group":"Get started","pages":[{"title":"Agent plugins","href":"/docs/agent-plugins"},{"title":"Composio CLI","href":"/docs/cli"},{"title":"Composio Connect","sidebarTitle":"Connect with MCP","href":"/docs/composio-connect"}]}]}]},{"tab":"Knowledge Base","pages":[{"title":"Knowledge Base","href":"/kb"}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples/sdk-examples"}]},{"tab":"Toolkits","pages":[{"title":"Toolkits","href":"/toolkits"}]},{"tab":"Reference","versions":[{"version":"v3.1","default":true,"tag":"Latest","pages":[{"group":"Overview","pages":[{"title":"Overview","sidebarTitle":"API reference","href":"/reference"},{"title":"Changelog","mode":"center","href":"/reference/changelog"},{"title":"Errors","href":"/reference/errors"},{"title":"Glossary","href":"/reference/glossary"}]},{"group":"Authenticating to Composio","root":{"title":"Overview","href":"/reference/authenticating-to-composio/index"},"directory":"accordion","pages":[{"title":"Scoped Project API Key","href":"/reference/authenticating-to-composio/project-api-key-permissions"}]},{"group":"API Reference","expanded":true,"pages":[{"group":"API Keys","pages":[{"title":"Revoke Composio API keys","openapi":"api-reference/openapi.json POST /api/v3.1/api_key_revocation","href":"/reference/api-reference/api-keys/postApiKeyRevocation"}]},{"group":"Auth Configs","root":{"title":"Auth Configs","href":"/reference/api-reference/auth-configs/index"},"directory":"accordion","pages":[{"title":"List authentication configurations with optional filters","openapi":"api-reference/openapi.json GET /api/v3.1/auth_configs","href":"/reference/api-reference/auth-configs/getAuthConfigs"},{"title":"Get single authentication configuration by ID","openapi":"api-reference/openapi.json GET /api/v3.1/auth_configs/{nanoid}","href":"/reference/api-reference/auth-configs/getAuthConfigsByNanoid"},{"title":"Create new authentication configuration","openapi":"api-reference/openapi.json POST /api/v3.1/auth_configs","href":"/reference/api-reference/auth-configs/postAuthConfigs"},{"title":"Update an authentication configuration","openapi":"api-reference/openapi.json PATCH /api/v3.1/auth_configs/{nanoid}","href":"/reference/api-reference/auth-configs/patchAuthConfigsByNanoid"},{"title":"Enable or disable an authentication configuration (DEPRECATED)","openapi":"api-reference/openapi.json PATCH /api/v3.1/auth_configs/{nanoid}/{status}","deprecated":true,"href":"/reference/api-reference/auth-configs/patchAuthConfigsByNanoidByStatus"},{"title":"Delete an authentication configuration","openapi":"api-reference/openapi.json DELETE /api/v3.1/auth_configs/{nanoid}","href":"/reference/api-reference/auth-configs/deleteAuthConfigsByNanoid"}]},{"group":"Connected Accounts","root":{"title":"Connected Accounts","href":"/reference/api-reference/connected-accounts/index"},"directory":"accordion","pages":[{"title":"List connected accounts with optional filters","openapi":"api-reference/openapi.json GET /api/v3.1/connected_accounts","href":"/reference/api-reference/connected-accounts/getConnectedAccounts"},{"title":"Get connected account details by ID","openapi":"api-reference/openapi.json GET /api/v3.1/connected_accounts/{nanoid}","href":"/reference/api-reference/connected-accounts/getConnectedAccountsByNanoid"},{"title":"Create a new connected account","openapi":"api-reference/openapi.json POST /api/v3.1/connected_accounts","href":"/reference/api-reference/connected-accounts/postConnectedAccounts"},{"title":"Re-initiate authentication for a connected account (DEPRECATED)","openapi":"api-reference/openapi.json POST /api/v3.1/connected_accounts/{nanoid}/refresh","deprecated":true,"href":"/reference/api-reference/connected-accounts/postConnectedAccountsByNanoidRefresh"},{"title":"Revoke a connected account at the provider","openapi":"api-reference/openapi.json POST /api/v3.1/connected_accounts/{nanoid}/revoke","href":"/reference/api-reference/connected-accounts/postConnectedAccountsByNanoidRevoke"},{"title":"Complete a deferred OAuth connection after identity verification","openapi":"api-reference/openapi.json POST /api/v3.1/connected_accounts/complete_auth","href":"/reference/api-reference/connected-accounts/postConnectedAccountsCompleteAuth"},{"title":"Create a new auth link session","openapi":"api-reference/openapi.json POST /api/v3.1/connected_accounts/link","href":"/reference/api-reference/connected-accounts/postConnectedAccountsLink"},{"title":"Enable or disable a connected account (DEPRECATED)","openapi":"api-reference/openapi.json PATCH /api/v3.1/connected_accounts/{nanoId}/status","deprecated":true,"href":"/reference/api-reference/connected-accounts/patchConnectedAccountsByNanoIdStatus"},{"title":"Update a connected account","openapi":"api-reference/openapi.json PATCH /api/v3.1/connected_accounts/{nanoid}","href":"/reference/api-reference/connected-accounts/patchConnectedAccountsByNanoid"},{"title":"Delete a connected account","openapi":"api-reference/openapi.json DELETE /api/v3.1/connected_accounts/{nanoid}","href":"/reference/api-reference/connected-accounts/deleteConnectedAccountsByNanoid"}]},{"group":"Files","root":{"title":"Files","href":"/reference/api-reference/files/index"},"directory":"accordion","pages":[{"title":"List files with optional app and action filters (DEPRECATED)","openapi":"api-reference/openapi.json GET /api/v3.1/files/list","deprecated":true,"href":"/reference/api-reference/files/getFilesList"},{"title":"Create presigned URL for request file upload to S3","openapi":"api-reference/openapi.json POST /api/v3.1/files/upload/request","href":"/reference/api-reference/files/postFilesUploadRequest"}]},{"group":"Logs","root":{"title":"Logs","href":"/reference/api-reference/logs/index"},"directory":"accordion","pages":[{"title":"Get log details by ID","openapi":"api-reference/openapi.json GET /api/v3.1/logs/tool_execution/{id}","href":"/reference/api-reference/logs/getLogsToolExecutionById"},{"title":"Search and retrieve tool execution logs","openapi":"api-reference/openapi.json POST /api/v3.1/logs/tool_execution","href":"/reference/api-reference/logs/postLogsToolExecution"}]},{"group":"MCP","root":{"title":"MCP","href":"/reference/api-reference/mcp/index"},"directory":"accordion","pages":[{"title":"List MCP servers for a specific app","openapi":"api-reference/openapi.json GET /api/v3.1/mcp/app/{appKey}","deprecated":true,"href":"/reference/api-reference/mcp/getMcpAppByAppKey"},{"title":"Get MCP server details by ID","openapi":"api-reference/openapi.json GET /api/v3.1/mcp/{id}","deprecated":true,"href":"/reference/api-reference/mcp/getMcpById"},{"title":"List MCP servers with optional filters and pagination","openapi":"api-reference/openapi.json GET /api/v3.1/mcp/servers","deprecated":true,"href":"/reference/api-reference/mcp/getMcpServers"},{"title":"List all instances for an MCP server","openapi":"api-reference/openapi.json GET /api/v3.1/mcp/servers/{serverId}/instances","deprecated":true,"href":"/reference/api-reference/mcp/getMcpServersByServerIdInstances"},{"title":"Create a new MCP server","openapi":"api-reference/openapi.json POST /api/v3.1/mcp/servers","deprecated":true,"href":"/reference/api-reference/mcp/postMcpServers"},{"title":"Create a new MCP server instance","openapi":"api-reference/openapi.json POST /api/v3.1/mcp/servers/{serverId}/instances","deprecated":true,"href":"/reference/api-reference/mcp/postMcpServersByServerIdInstances"},{"title":"Create a new custom MCP server with multiple apps","openapi":"api-reference/openapi.json POST /api/v3.1/mcp/servers/custom","deprecated":true,"href":"/reference/api-reference/mcp/postMcpServersCustom"},{"title":"Generate MCP URL with custom parameters","openapi":"api-reference/openapi.json POST /api/v3.1/mcp/servers/generate","deprecated":true,"href":"/reference/api-reference/mcp/postMcpServersGenerate"},{"title":"Update MCP server configuration","openapi":"api-reference/openapi.json PATCH /api/v3.1/mcp/{id}","deprecated":true,"href":"/reference/api-reference/mcp/patchMcpById"},{"title":"Delete an MCP server","openapi":"api-reference/openapi.json DELETE /api/v3.1/mcp/{id}","deprecated":true,"href":"/reference/api-reference/mcp/deleteMcpById"},{"title":"Delete an MCP server instance and associated connected accounts","openapi":"api-reference/openapi.json DELETE /api/v3.1/mcp/servers/{serverId}/instances/{instanceId}","deprecated":true,"href":"/reference/api-reference/mcp/deleteMcpServersByServerIdInstancesByInstanceId"}]},{"group":"Organization","root":{"title":"Organization","href":"/reference/api-reference/organization/index"},"directory":"accordion","pages":[{"title":"Org usage breakdown","openapi":"api-reference/openapi.json POST /api/v3.1/org/usage/{entity_type}","href":"/reference/api-reference/organization/postOrgUsageByEntityType"},{"title":"Org usage summary","openapi":"api-reference/openapi.json POST /api/v3.1/org/usage/summary","href":"/reference/api-reference/organization/postOrgUsageSummary"}]},{"group":"Organization Management","pages":[{"title":"List organizations","openapi":"api-reference/openapi.json GET /api/v3.1/org/list","href":"/reference/api-reference/organization-management/getOrgList"}]},{"group":"Projects","root":{"title":"Projects","href":"/reference/api-reference/projects/index"},"directory":"accordion","pages":[{"title":"Get project details by ID With Org Api key","openapi":"api-reference/openapi.json GET /api/v3.1/org/owner/project/{nano_id}","href":"/reference/api-reference/projects/getOrgOwnerProjectByNanoId"},{"title":"List all projects","openapi":"api-reference/openapi.json GET /api/v3.1/org/owner/project/list","href":"/reference/api-reference/projects/getOrgOwnerProjectList"},{"title":"List all projects","openapi":"api-reference/openapi.json GET /api/v3.1/org/project/list","href":"/reference/api-reference/projects/getOrgProjectList"},{"title":"Delete and generate new API key for project","openapi":"api-reference/openapi.json POST /api/v3.1/org/owner/project/{nano_id}/regenerate_api_key","href":"/reference/api-reference/projects/postOrgOwnerProjectByNanoIdRegenerateApiKey"},{"title":"Create a new project","openapi":"api-reference/openapi.json POST /api/v3.1/org/owner/project/new","href":"/reference/api-reference/projects/postOrgOwnerProjectNew"},{"title":"Project usage breakdown","openapi":"api-reference/openapi.json POST /api/v3.1/project/usage/{entity_type}","href":"/reference/api-reference/projects/postProjectUsageByEntityType"},{"title":"Project usage summary","openapi":"api-reference/openapi.json POST /api/v3.1/project/usage/summary","href":"/reference/api-reference/projects/postProjectUsageSummary"},{"title":"Delete a project","openapi":"api-reference/openapi.json DELETE /api/v3.1/org/owner/project/{nano_id}","href":"/reference/api-reference/projects/deleteOrgOwnerProjectByNanoId"}]},{"group":"Sessions (prev Tool Router)","root":{"title":"Sessions (prev Tool Router)","href":"/reference/api-reference/tool-router/index"},"directory":"accordion","pages":[{"title":"List Session configs","openapi":"api-reference/openapi.json GET /api/v3.1/session_configs","href":"/reference/api-reference/tool-router/getSessionConfigs"},{"title":"Retrieve a Session config","openapi":"api-reference/openapi.json GET /api/v3.1/session_configs/{session_config_id}","href":"/reference/api-reference/tool-router/getSessionConfigsBySessionConfigId"},{"title":"Get a tool router session by ID (v3.1)","openapi":"api-reference/openapi.json GET /api/v3.1/tool_router/session/{session_id}","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionId"},{"title":"List a tool router session config history","openapi":"api-reference/openapi.json GET /api/v3.1/tool_router/session/{session_id}/config_history","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdConfigHistory"},{"title":"List files in a session mount","openapi":"api-reference/openapi.json GET /api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/items","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdMountsByMountIdItems"},{"title":"Get toolkits for a tool router session","openapi":"api-reference/openapi.json GET /api/v3.1/tool_router/session/{session_id}/toolkits","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdToolkits"},{"title":"List tools with schemas for a tool router session (v3.1)","openapi":"api-reference/openapi.json GET /api/v3.1/tool_router/session/{session_id}/tools","href":"/reference/api-reference/tool-router/getToolRouterSessionBySessionIdTools"},{"title":"Create a new tool router session","openapi":"api-reference/openapi.json POST /api/v3.1/tool_router/session","href":"/reference/api-reference/tool-router/postToolRouterSession"},{"title":"Attach to an existing tool router session (v3.1)","openapi":"api-reference/openapi.json POST /api/v3.1/tool_router/session/{session_id}/attach","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdAttach"},{"title":"Execute a tool within a tool router session","openapi":"api-reference/openapi.json POST /api/v3.1/tool_router/session/{session_id}/execute","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdExecute"},{"title":"Execute a meta tool within a tool router session","openapi":"api-reference/openapi.json POST /api/v3.1/tool_router/session/{session_id}/execute_meta","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdExecuteMeta"},{"title":"Create a link session for a toolkit in a tool router session","openapi":"api-reference/openapi.json POST /api/v3.1/tool_router/session/{session_id}/link","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdLink"},{"title":"Delete a file from a session mount","openapi":"api-reference/openapi.json POST /api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/delete","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdDelete"},{"title":"Create a presigned download URL for a mount file","openapi":"api-reference/openapi.json POST /api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/download_url","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdDownloadUrl"},{"title":"Create a presigned upload URL for a mount file","openapi":"api-reference/openapi.json POST /api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/upload_url","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdMountsByMountIdUploadUrl"},{"title":"Execute proxy request within a tool router session","openapi":"api-reference/openapi.json POST /api/v3.1/tool_router/session/{session_id}/proxy_execute","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdProxyExecute"},{"title":"Search for tools using a query","openapi":"api-reference/openapi.json POST /api/v3.1/tool_router/session/{session_id}/search","href":"/reference/api-reference/tool-router/postToolRouterSessionBySessionIdSearch"},{"title":"Patch a tool router session config (v3.1)","openapi":"api-reference/openapi.json PATCH /api/v3.1/tool_router/session/{session_id}","href":"/reference/api-reference/tool-router/patchToolRouterSessionBySessionId"},{"title":"Delete a tool router session","openapi":"api-reference/openapi.json DELETE /api/v3.1/tool_router/session/{session_id}","href":"/reference/api-reference/tool-router/deleteToolRouterSessionBySessionId"}]},{"group":"Toolkits","root":{"title":"Toolkits","href":"/reference/api-reference/toolkits/index"},"directory":"accordion","pages":[{"title":"List available toolkits","openapi":"api-reference/openapi.json GET /api/v3.1/toolkits","href":"/reference/api-reference/toolkits/getToolkits"},{"title":"Get toolkit by slug","openapi":"api-reference/openapi.json GET /api/v3.1/toolkits/{slug}","href":"/reference/api-reference/toolkits/getToolkitsBySlug"},{"title":"List toolkit categories","openapi":"api-reference/openapi.json GET /api/v3.1/toolkits/categories","href":"/reference/api-reference/toolkits/getToolkitsCategories"},{"title":"Get toolkits changelog","openapi":"api-reference/openapi.json GET /api/v3.1/toolkits/changelog","href":"/reference/api-reference/toolkits/getToolkitsChangelog"},{"title":"List grant contexts","openapi":"api-reference/openapi.json GET /api/v3.1/toolkits/{toolkit_slug}/scopes/grant_context","href":"/reference/api-reference/toolkits/recommendToolkitScopesGrantContext"},{"title":"Create a custom toolkit","openapi":"api-reference/openapi.json POST /api/v3.1/custom/toolkits","href":"/reference/api-reference/toolkits/postCustomToolkits"},{"title":"Sync a custom toolkit","openapi":"api-reference/openapi.json POST /api/v3.1/custom/toolkits/sync","href":"/reference/api-reference/toolkits/postCustomToolkitsSync"},{"title":"Upsert a custom toolkit","openapi":"api-reference/openapi.json POST /api/v3.1/custom/toolkits/upsert","href":"/reference/api-reference/toolkits/postCustomToolkitsUpsert"},{"title":"Fetch multiple toolkits","openapi":"api-reference/openapi.json POST /api/v3.1/toolkits/multi","href":"/reference/api-reference/toolkits/postToolkitsMulti"},{"title":"Get required scopes","openapi":"api-reference/openapi.json POST /api/v3.1/toolkits/{toolkit_slug}/scopes/recommended","href":"/reference/api-reference/toolkits/recommendToolkitScopes"},{"title":"Update a custom toolkit","openapi":"api-reference/openapi.json PATCH /api/v3.1/custom/toolkits/{slug}","href":"/reference/api-reference/toolkits/patchCustomToolkitsBySlug"},{"title":"Delete a custom toolkit","openapi":"api-reference/openapi.json DELETE /api/v3.1/custom/toolkits/{slug}","href":"/reference/api-reference/toolkits/deleteCustomToolkitsBySlug"}]},{"group":"Tools","root":{"title":"Tools","href":"/reference/api-reference/tools/index"},"directory":"accordion","pages":[{"title":"List available tools","openapi":"api-reference/openapi.json GET /api/v3.1/tools","href":"/reference/api-reference/tools/getTools"},{"title":"Get tool by slug","openapi":"api-reference/openapi.json GET /api/v3.1/tools/{tool_slug}","href":"/reference/api-reference/tools/getToolsByToolSlug"},{"title":"Get tool enum list","openapi":"api-reference/openapi.json GET /api/v3.1/tools/enum","href":"/reference/api-reference/tools/getToolsEnum"},{"title":"Execute tool","openapi":"api-reference/openapi.json POST /api/v3.1/tools/execute/{tool_slug}","href":"/reference/api-reference/tools/postToolsExecuteByToolSlug"},{"title":"Generate tool inputs from natural language (DEPRECATED)","openapi":"api-reference/openapi.json POST /api/v3.1/tools/execute/{tool_slug}/input","deprecated":true,"href":"/reference/api-reference/tools/postToolsExecuteByToolSlugInput"},{"title":"Execute proxy request","openapi":"api-reference/openapi.json POST /api/v3.1/tools/execute/proxy","href":"/reference/api-reference/tools/postToolsExecuteProxy"},{"title":"Get required scopes for tools (DEPRECATED)","openapi":"api-reference/openapi.json POST /api/v3.1/tools/scopes/required","deprecated":true,"href":"/reference/api-reference/tools/postToolsScopesRequired"}]},{"group":"Triggers","root":{"title":"Triggers","href":"/reference/api-reference/triggers/index"},"directory":"accordion","pages":[{"title":"List active triggers","openapi":"api-reference/openapi.json GET /api/v3.1/trigger_instances/active","href":"/reference/api-reference/triggers/getTriggerInstancesActive"},{"title":"List trigger types","openapi":"api-reference/openapi.json GET /api/v3.1/triggers_types","href":"/reference/api-reference/triggers/getTriggersTypes"},{"title":"Get trigger type by slug","openapi":"api-reference/openapi.json GET /api/v3.1/triggers_types/{slug}","href":"/reference/api-reference/triggers/getTriggersTypesBySlug"},{"title":"List trigger type enums","openapi":"api-reference/openapi.json GET /api/v3.1/triggers_types/list/enum","href":"/reference/api-reference/triggers/getTriggersTypesListEnum"},{"title":"Create or update a trigger","openapi":"api-reference/openapi.json POST /api/v3.1/trigger_instances/{slug}/upsert","href":"/reference/api-reference/triggers/postTriggerInstancesBySlugUpsert"},{"title":"Update a trigger","openapi":"api-reference/openapi.json PATCH /api/v3.1/trigger_instances/manage/{triggerId}","href":"/reference/api-reference/triggers/patchTriggerInstancesManageByTriggerId"},{"title":"Delete a trigger","openapi":"api-reference/openapi.json DELETE /api/v3.1/trigger_instances/manage/{triggerId}","href":"/reference/api-reference/triggers/deleteTriggerInstancesManageByTriggerId"}]},{"group":"Webhook Endpoints","root":{"title":"Webhook Endpoints","href":"/reference/api-reference/webhook-endpoints/index"},"directory":"accordion","pages":[{"title":"List webhook endpoints","openapi":"api-reference/openapi.json GET /api/v3.1/webhook_endpoints","href":"/reference/api-reference/webhook-endpoints/getWebhookEndpoints"},{"title":"Get webhook endpoint","openapi":"api-reference/openapi.json GET /api/v3.1/webhook_endpoints/{nano_id}","href":"/reference/api-reference/webhook-endpoints/getWebhookEndpointsByNanoId"},{"title":"Create webhook endpoint","openapi":"api-reference/openapi.json POST /api/v3.1/webhook_endpoints","href":"/reference/api-reference/webhook-endpoints/postWebhookEndpoints"},{"title":"Put webhook endpoint configuration","openapi":"api-reference/openapi.json POST /api/v3.1/webhook_endpoints/{nano_id}","href":"/reference/api-reference/webhook-endpoints/postWebhookEndpointsByNanoId"},{"title":"Update webhook endpoint configuration","openapi":"api-reference/openapi.json PATCH /api/v3.1/webhook_endpoints/{nano_id}","href":"/reference/api-reference/webhook-endpoints/patchWebhookEndpointsByNanoId"}]},{"group":"Webhook Events","root":{"title":"Webhook Events","href":"/reference/api-reference/webhook-events/index"},"directory":"accordion","pages":[{"title":"Connection activated","openapi":"api-reference/openapi.json webhook composio.connected_account.activated","href":"/reference/api-reference/webhook-events/composio_connected_account_activated"},{"title":"Connection expired","openapi":"api-reference/openapi.json webhook composio.connected_account.expired","href":"/reference/api-reference/webhook-events/composio_connected_account_expired"},{"title":"Trigger disabled","openapi":"api-reference/openapi.json webhook composio.trigger.disabled","href":"/reference/api-reference/webhook-events/composio_trigger_disabled"},{"title":"Trigger message","openapi":"api-reference/openapi.json webhook composio.trigger.message","href":"/reference/api-reference/webhook-events/composio_trigger_message"},{"title":"Trigger message (V1)","openapi":"api-reference/openapi.json webhook composio.trigger.message.v1","deprecated":true,"href":"/reference/api-reference/webhook-events/composio_trigger_message_v1"},{"title":"Trigger message (V2)","openapi":"api-reference/openapi.json webhook composio.trigger.message.v2","deprecated":true,"href":"/reference/api-reference/webhook-events/composio_trigger_message_v2"}]},{"group":"Webhook Subscriptions","root":{"title":"Webhook Subscriptions","href":"/reference/api-reference/webhook-subscriptions/index"},"directory":"accordion","pages":[{"title":"List webhook subscriptions","openapi":"api-reference/openapi.json GET /api/v3.1/webhook_subscriptions","href":"/reference/api-reference/webhook-subscriptions/getWebhookSubscriptions"},{"title":"Get webhook subscription","openapi":"api-reference/openapi.json GET /api/v3.1/webhook_subscriptions/{id}","href":"/reference/api-reference/webhook-subscriptions/getWebhookSubscriptionsById"},{"title":"List available event types","openapi":"api-reference/openapi.json GET /api/v3.1/webhook_subscriptions/event_types","href":"/reference/api-reference/webhook-subscriptions/getWebhookSubscriptionsEventTypes"},{"title":"Create webhook subscription","openapi":"api-reference/openapi.json POST /api/v3.1/webhook_subscriptions","href":"/reference/api-reference/webhook-subscriptions/postWebhookSubscriptions"},{"title":"Rotate webhook secret","openapi":"api-reference/openapi.json POST /api/v3.1/webhook_subscriptions/{id}/rotate_secret","href":"/reference/api-reference/webhook-subscriptions/postWebhookSubscriptionsByIdRotateSecret"},{"title":"Update webhook subscription","openapi":"api-reference/openapi.json PATCH /api/v3.1/webhook_subscriptions/{id}","href":"/reference/api-reference/webhook-subscriptions/patchWebhookSubscriptionsById"},{"title":"Delete webhook subscription","openapi":"api-reference/openapi.json DELETE /api/v3.1/webhook_subscriptions/{id}","href":"/reference/api-reference/webhook-subscriptions/deleteWebhookSubscriptionsById"}]}]}],"groups":[{"group":"Sessions (Prev Tool Router)","pages":[{"title":"List Session configs","deprecated":false,"version":null,"sidebarTitle":"Getsessionconfigs","openapi":"/api-reference/openapi.json get /api/v3.1/session_configs","href":"/reference/api-reference/tool-router/getsessionconfigs"},{"title":"Retrieve a Session config","deprecated":false,"version":null,"sidebarTitle":"Getsessionconfigsbysessionconfigid","openapi":"/api-reference/openapi.json get /api/v3.1/session_configs/{session_config_id}","href":"/reference/api-reference/tool-router/getsessionconfigsbysessionconfigid"},{"title":"Create a new tool router session","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersession","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session","href":"/reference/api-reference/tool-router/posttoolroutersession"},{"title":"Get a tool router session by ID (v3.1)","deprecated":false,"version":null,"sidebarTitle":"Gettoolroutersessionbysessionid","openapi":"/api-reference/openapi.json get /api/v3.1/tool_router/session/{session_id}","href":"/reference/api-reference/tool-router/gettoolroutersessionbysessionid"},{"title":"Delete a tool router session","deprecated":false,"version":null,"sidebarTitle":"Deletetoolroutersessionbysessionid","openapi":"/api-reference/openapi.json delete /api/v3.1/tool_router/session/{session_id}","href":"/reference/api-reference/tool-router/deletetoolroutersessionbysessionid"},{"title":"Patch a tool router session config (v3.1)","description":"Partially updates an existing tool router session. Inline fields update only the supplied settings. Alternatively, experimental.session_config_id applies the latest active saved config from this project, replacing toolkit, tool, and tag access while preserving other settings. Later saved-config edits do not sync automatically. Uses optimistic concurrency control and retains the previous policy in config history.","deprecated":false,"version":null,"sidebarTitle":"Patchtoolroutersessionbysessionid","openapi":"/api-reference/openapi.json patch /api/v3.1/tool_router/session/{session_id}","href":"/reference/api-reference/tool-router/patchtoolroutersessionbysessionid"},{"title":"Attach to an existing tool router session (v3.1)","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidattach","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/attach","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidattach"},{"title":"List a tool router session config history","description":"Returns the session config history ordered by version DESC (newest first). The live (current) config appears once, on the first page only, with `is_current: true`; archived versions have `is_current: false`.","deprecated":false,"version":null,"sidebarTitle":"Gettoolroutersessionbysessionidconfighistory","openapi":"/api-reference/openapi.json get /api/v3.1/tool_router/session/{session_id}/config_history","href":"/reference/api-reference/tool-router/gettoolroutersessionbysessionidconfighistory"},{"title":"Search for tools using a query","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidsearch","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/search","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidsearch"},{"title":"List tools with schemas for a tool router session (v3.1)","deprecated":false,"version":null,"sidebarTitle":"Gettoolroutersessionbysessionidtools","openapi":"/api-reference/openapi.json get /api/v3.1/tool_router/session/{session_id}/tools","href":"/reference/api-reference/tool-router/gettoolroutersessionbysessionidtools"},{"title":"Execute a tool within a tool router session","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidexecute","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/execute","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidexecute"},{"title":"Execute a meta tool within a tool router session","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidexecutemeta","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/execute_meta","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidexecutemeta"},{"title":"Create a link session for a toolkit in a tool router session","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidlink","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/link","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidlink"},{"title":"Execute proxy request within a tool router session","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidproxyexecute","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/proxy_execute","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidproxyexecute"},{"title":"Get toolkits for a tool router session","deprecated":false,"version":null,"sidebarTitle":"Gettoolroutersessionbysessionidtoolkits","openapi":"/api-reference/openapi.json get /api/v3.1/tool_router/session/{session_id}/toolkits","href":"/reference/api-reference/tool-router/gettoolroutersessionbysessionidtoolkits"},{"title":"List files in a session mount","deprecated":false,"version":null,"sidebarTitle":"Gettoolroutersessionbysessionidmountsbymountiditems","openapi":"/api-reference/openapi.json get /api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/items","href":"/reference/api-reference/tool-router/gettoolroutersessionbysessionidmountsbymountiditems"},{"title":"Create a presigned download URL for a mount file","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidmountsbymountiddownloadurl","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/download_url","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidmountsbymountiddownloadurl"},{"title":"Create a presigned upload URL for a mount file","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidmountsbymountiduploadurl","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/upload_url","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidmountsbymountiduploadurl"},{"title":"Delete a file from a session mount","deprecated":false,"version":null,"sidebarTitle":"Posttoolroutersessionbysessionidmountsbymountiddelete","openapi":"/api-reference/openapi.json post /api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/delete","href":"/reference/api-reference/tool-router/posttoolroutersessionbysessionidmountsbymountiddelete"}]},{"group":"Authentication","pages":[]},{"group":"API Keys","pages":[{"title":"Revoke Composio API keys","deprecated":false,"version":null,"sidebarTitle":"Postapikeyrevocation","openapi":"/api-reference/openapi.json post /api/v3.1/api_key_revocation","href":"/reference/api-reference/api-keys/postapikeyrevocation"}]},{"group":"Logs","pages":[{"title":"Search and retrieve tool execution logs","deprecated":false,"version":null,"sidebarTitle":"Postlogstoolexecution","openapi":"/api-reference/openapi.json post /api/v3.1/logs/tool_execution","href":"/reference/api-reference/logs/postlogstoolexecution"},{"title":"Get log details by ID","deprecated":false,"version":null,"sidebarTitle":"Getlogstoolexecutionbyid","openapi":"/api-reference/openapi.json get /api/v3.1/logs/tool_execution/{id}","href":"/reference/api-reference/logs/getlogstoolexecutionbyid"}]},{"group":"Tools","pages":[{"title":"List available tools","deprecated":false,"version":null,"sidebarTitle":"Gettools","openapi":"/api-reference/openapi.json get /api/v3.1/tools","href":"/reference/api-reference/tools/gettools"},{"title":"Get tool enum list","deprecated":false,"version":null,"sidebarTitle":"Gettoolsenum","openapi":"/api-reference/openapi.json get /api/v3.1/tools/enum","href":"/reference/api-reference/tools/gettoolsenum"},{"title":"Get tool by slug","deprecated":false,"version":null,"sidebarTitle":"Gettoolsbytoolslug","openapi":"/api-reference/openapi.json get /api/v3.1/tools/{tool_slug}","href":"/reference/api-reference/tools/gettoolsbytoolslug"},{"title":"Execute tool","deprecated":false,"version":null,"sidebarTitle":"Posttoolsexecutebytoolslug","openapi":"/api-reference/openapi.json post /api/v3.1/tools/execute/{tool_slug}","href":"/reference/api-reference/tools/posttoolsexecutebytoolslug"},{"title":"Generate tool inputs from natural language (DEPRECATED)","deprecated":true,"version":null,"sidebarTitle":"Posttoolsexecutebytoolsluginput","openapi":"/api-reference/openapi.json post /api/v3.1/tools/execute/{tool_slug}/input","href":"/reference/api-reference/tools/posttoolsexecutebytoolsluginput"},{"title":"Execute proxy request","deprecated":false,"version":null,"sidebarTitle":"Posttoolsexecuteproxy","openapi":"/api-reference/openapi.json post /api/v3.1/tools/execute/proxy","href":"/reference/api-reference/tools/posttoolsexecuteproxy"},{"title":"Get required scopes for tools (DEPRECATED)","deprecated":true,"version":null,"sidebarTitle":"Posttoolsscopesrequired","openapi":"/api-reference/openapi.json post /api/v3.1/tools/scopes/required","href":"/reference/api-reference/tools/posttoolsscopesrequired"}]},{"group":"Connected Accounts","pages":[{"title":"Revoke a connected account at the provider","deprecated":false,"version":null,"sidebarTitle":"Postconnectedaccountsbynanoidrevoke","openapi":"/api-reference/openapi.json post /api/v3.1/connected_accounts/{nanoid}/revoke","href":"/reference/api-reference/connected-accounts/postconnectedaccountsbynanoidrevoke"},{"title":"Complete a deferred OAuth connection after identity verification","deprecated":false,"version":null,"sidebarTitle":"Postconnectedaccountscompleteauth","openapi":"/api-reference/openapi.json post /api/v3.1/connected_accounts/complete_auth","href":"/reference/api-reference/connected-accounts/postconnectedaccountscompleteauth"},{"title":"List connected accounts with optional filters","deprecated":false,"version":null,"sidebarTitle":"Getconnectedaccounts","openapi":"/api-reference/openapi.json get /api/v3.1/connected_accounts","href":"/reference/api-reference/connected-accounts/getconnectedaccounts"},{"title":"Create a new connected account","deprecated":false,"version":null,"sidebarTitle":"Postconnectedaccounts","openapi":"/api-reference/openapi.json post /api/v3.1/connected_accounts","href":"/reference/api-reference/connected-accounts/postconnectedaccounts"},{"title":"Get connected account details by ID","deprecated":false,"version":null,"sidebarTitle":"Getconnectedaccountsbynanoid","openapi":"/api-reference/openapi.json get /api/v3.1/connected_accounts/{nanoid}","href":"/reference/api-reference/connected-accounts/getconnectedaccountsbynanoid"},{"title":"Delete a connected account","deprecated":false,"version":null,"sidebarTitle":"Deleteconnectedaccountsbynanoid","openapi":"/api-reference/openapi.json delete /api/v3.1/connected_accounts/{nanoid}","href":"/reference/api-reference/connected-accounts/deleteconnectedaccountsbynanoid"},{"title":"Update a connected account","deprecated":false,"version":null,"sidebarTitle":"Patchconnectedaccountsbynanoid","openapi":"/api-reference/openapi.json patch /api/v3.1/connected_accounts/{nanoid}","href":"/reference/api-reference/connected-accounts/patchconnectedaccountsbynanoid"},{"title":"Enable or disable a connected account (DEPRECATED)","deprecated":true,"version":null,"sidebarTitle":"Patchconnectedaccountsbynanoidstatus","openapi":"/api-reference/openapi.json patch /api/v3.1/connected_accounts/{nanoId}/status","href":"/reference/api-reference/connected-accounts/patchconnectedaccountsbynanoidstatus"},{"title":"Re-initiate authentication for a connected account (DEPRECATED)","deprecated":true,"version":null,"sidebarTitle":"Postconnectedaccountsbynanoidrefresh","openapi":"/api-reference/openapi.json post /api/v3.1/connected_accounts/{nanoid}/refresh","href":"/reference/api-reference/connected-accounts/postconnectedaccountsbynanoidrefresh"},{"title":"Create a new auth link session","deprecated":false,"version":null,"sidebarTitle":"Postconnectedaccountslink","openapi":"/api-reference/openapi.json post /api/v3.1/connected_accounts/link","href":"/reference/api-reference/connected-accounts/postconnectedaccountslink"}]},{"group":"Toolkits","pages":[{"title":"Create a custom toolkit","deprecated":false,"version":null,"sidebarTitle":"Postcustomtoolkits","openapi":"/api-reference/openapi.json post /api/v3.1/custom/toolkits","href":"/reference/api-reference/toolkits/postcustomtoolkits"},{"title":"Delete a custom toolkit","deprecated":false,"version":null,"sidebarTitle":"Deletecustomtoolkitsbyslug","openapi":"/api-reference/openapi.json delete /api/v3.1/custom/toolkits/{slug}","href":"/reference/api-reference/toolkits/deletecustomtoolkitsbyslug"},{"title":"Update a custom toolkit","deprecated":false,"version":null,"sidebarTitle":"Patchcustomtoolkitsbyslug","openapi":"/api-reference/openapi.json patch /api/v3.1/custom/toolkits/{slug}","href":"/reference/api-reference/toolkits/patchcustomtoolkitsbyslug"},{"title":"Get required scopes","deprecated":false,"version":null,"sidebarTitle":"Recommendtoolkitscopes","openapi":"/api-reference/openapi.json post /api/v3.1/toolkits/{toolkit_slug}/scopes/recommended","href":"/reference/api-reference/toolkits/recommendtoolkitscopes"},{"title":"List grant contexts","deprecated":false,"version":null,"sidebarTitle":"Recommendtoolkitscopesgrantcontext","openapi":"/api-reference/openapi.json get /api/v3.1/toolkits/{toolkit_slug}/scopes/grant_context","href":"/reference/api-reference/toolkits/recommendtoolkitscopesgrantcontext"},{"title":"List available toolkits","deprecated":false,"version":null,"sidebarTitle":"Gettoolkits","openapi":"/api-reference/openapi.json get /api/v3.1/toolkits","href":"/reference/api-reference/toolkits/gettoolkits"},{"title":"List toolkit categories","deprecated":false,"version":null,"sidebarTitle":"Gettoolkitscategories","openapi":"/api-reference/openapi.json get /api/v3.1/toolkits/categories","href":"/reference/api-reference/toolkits/gettoolkitscategories"},{"title":"Upsert a custom toolkit","deprecated":false,"version":null,"sidebarTitle":"Postcustomtoolkitsupsert","openapi":"/api-reference/openapi.json post /api/v3.1/custom/toolkits/upsert","href":"/reference/api-reference/toolkits/postcustomtoolkitsupsert"},{"title":"Sync a custom toolkit","deprecated":false,"version":null,"sidebarTitle":"Postcustomtoolkitssync","openapi":"/api-reference/openapi.json post /api/v3.1/custom/toolkits/sync","href":"/reference/api-reference/toolkits/postcustomtoolkitssync"},{"title":"Get toolkit by slug","deprecated":false,"version":null,"sidebarTitle":"Gettoolkitsbyslug","openapi":"/api-reference/openapi.json get /api/v3.1/toolkits/{slug}","href":"/reference/api-reference/toolkits/gettoolkitsbyslug"},{"title":"Fetch multiple toolkits","deprecated":false,"version":null,"sidebarTitle":"Posttoolkitsmulti","openapi":"/api-reference/openapi.json post /api/v3.1/toolkits/multi","href":"/reference/api-reference/toolkits/posttoolkitsmulti"},{"title":"Get toolkits changelog","deprecated":false,"version":null,"sidebarTitle":"Gettoolkitschangelog","openapi":"/api-reference/openapi.json get /api/v3.1/toolkits/changelog","href":"/reference/api-reference/toolkits/gettoolkitschangelog"}]},{"group":"Organization","pages":[{"title":"Org usage summary","deprecated":false,"version":null,"sidebarTitle":"Postorgusagesummary","openapi":"/api-reference/openapi.json post /api/v3.1/org/usage/summary","href":"/reference/api-reference/organization/postorgusagesummary"},{"title":"Org usage breakdown","deprecated":false,"version":null,"sidebarTitle":"Postorgusagebyentitytype","openapi":"/api-reference/openapi.json post /api/v3.1/org/usage/{entity_type}","href":"/reference/api-reference/organization/postorgusagebyentitytype"}]},{"group":"Projects","pages":[{"title":"Project usage summary","deprecated":false,"version":null,"sidebarTitle":"Postprojectusagesummary","openapi":"/api-reference/openapi.json post /api/v3.1/project/usage/summary","href":"/reference/api-reference/projects/postprojectusagesummary"},{"title":"Project usage breakdown","deprecated":false,"version":null,"sidebarTitle":"Postprojectusagebyentitytype","openapi":"/api-reference/openapi.json post /api/v3.1/project/usage/{entity_type}","href":"/reference/api-reference/projects/postprojectusagebyentitytype"},{"title":"List all projects","deprecated":false,"version":null,"sidebarTitle":"Getorgprojectlist","openapi":"/api-reference/openapi.json get /api/v3.1/org/project/list","href":"/reference/api-reference/projects/getorgprojectlist"},{"title":"Create a new project","deprecated":false,"version":null,"sidebarTitle":"Postorgownerprojectnew","openapi":"/api-reference/openapi.json post /api/v3.1/org/owner/project/new","href":"/reference/api-reference/projects/postorgownerprojectnew"},{"title":"List all projects","deprecated":false,"version":null,"sidebarTitle":"Getorgownerprojectlist","openapi":"/api-reference/openapi.json get /api/v3.1/org/owner/project/list","href":"/reference/api-reference/projects/getorgownerprojectlist"},{"title":"Get project details by ID With Org Api key","deprecated":false,"version":null,"sidebarTitle":"Getorgownerprojectbynanoid","openapi":"/api-reference/openapi.json get /api/v3.1/org/owner/project/{nano_id}","href":"/reference/api-reference/projects/getorgownerprojectbynanoid"},{"title":"Delete a project","deprecated":false,"version":null,"sidebarTitle":"Deleteorgownerprojectbynanoid","openapi":"/api-reference/openapi.json delete /api/v3.1/org/owner/project/{nano_id}","href":"/reference/api-reference/projects/deleteorgownerprojectbynanoid"},{"title":"Delete and generate new API key for project","deprecated":false,"version":null,"sidebarTitle":"Postorgownerprojectbynanoidregenerateapikey","openapi":"/api-reference/openapi.json post /api/v3.1/org/owner/project/{nano_id}/regenerate_api_key","href":"/reference/api-reference/projects/postorgownerprojectbynanoidregenerateapikey"}]},{"group":"Auth Configs","pages":[{"title":"List authentication configurations with optional filters","deprecated":false,"version":null,"sidebarTitle":"Getauthconfigs","openapi":"/api-reference/openapi.json get /api/v3.1/auth_configs","href":"/reference/api-reference/auth-configs/getauthconfigs"},{"title":"Create new authentication configuration","deprecated":false,"version":null,"sidebarTitle":"Postauthconfigs","openapi":"/api-reference/openapi.json post /api/v3.1/auth_configs","href":"/reference/api-reference/auth-configs/postauthconfigs"},{"title":"Get single authentication configuration by ID","deprecated":false,"version":null,"sidebarTitle":"Getauthconfigsbynanoid","openapi":"/api-reference/openapi.json get /api/v3.1/auth_configs/{nanoid}","href":"/reference/api-reference/auth-configs/getauthconfigsbynanoid"},{"title":"Delete an authentication configuration","deprecated":false,"version":null,"sidebarTitle":"Deleteauthconfigsbynanoid","openapi":"/api-reference/openapi.json delete /api/v3.1/auth_configs/{nanoid}","href":"/reference/api-reference/auth-configs/deleteauthconfigsbynanoid"},{"title":"Update an authentication configuration","deprecated":false,"version":null,"sidebarTitle":"Patchauthconfigsbynanoid","openapi":"/api-reference/openapi.json patch /api/v3.1/auth_configs/{nanoid}","href":"/reference/api-reference/auth-configs/patchauthconfigsbynanoid"},{"title":"Enable or disable an authentication configuration (DEPRECATED)","deprecated":true,"version":null,"sidebarTitle":"Patchauthconfigsbynanoidbystatus","openapi":"/api-reference/openapi.json patch /api/v3.1/auth_configs/{nanoid}/{status}","href":"/reference/api-reference/auth-configs/patchauthconfigsbynanoidbystatus"}]},{"group":"Organization Management","pages":[{"title":"List organizations","deprecated":false,"version":null,"sidebarTitle":"Getorglist","openapi":"/api-reference/openapi.json get /api/v3.1/org/list","href":"/reference/api-reference/organization-management/getorglist"}]},{"group":"Webhook Subscriptions","pages":[{"title":"List webhook subscriptions","deprecated":false,"version":null,"sidebarTitle":"Getwebhooksubscriptions","openapi":"/api-reference/openapi.json get /api/v3.1/webhook_subscriptions","href":"/reference/api-reference/webhook-subscriptions/getwebhooksubscriptions"},{"title":"Create webhook subscription","deprecated":false,"version":null,"sidebarTitle":"Postwebhooksubscriptions","openapi":"/api-reference/openapi.json post /api/v3.1/webhook_subscriptions","href":"/reference/api-reference/webhook-subscriptions/postwebhooksubscriptions"},{"title":"Get webhook subscription","deprecated":false,"version":null,"sidebarTitle":"Getwebhooksubscriptionsbyid","openapi":"/api-reference/openapi.json get /api/v3.1/webhook_subscriptions/{id}","href":"/reference/api-reference/webhook-subscriptions/getwebhooksubscriptionsbyid"},{"title":"Delete webhook subscription","deprecated":false,"version":null,"sidebarTitle":"Deletewebhooksubscriptionsbyid","openapi":"/api-reference/openapi.json delete /api/v3.1/webhook_subscriptions/{id}","href":"/reference/api-reference/webhook-subscriptions/deletewebhooksubscriptionsbyid"},{"title":"Update webhook subscription","deprecated":false,"version":null,"sidebarTitle":"Patchwebhooksubscriptionsbyid","openapi":"/api-reference/openapi.json patch /api/v3.1/webhook_subscriptions/{id}","href":"/reference/api-reference/webhook-subscriptions/patchwebhooksubscriptionsbyid"},{"title":"Rotate webhook secret","deprecated":false,"version":null,"sidebarTitle":"Postwebhooksubscriptionsbyidrotatesecret","openapi":"/api-reference/openapi.json post /api/v3.1/webhook_subscriptions/{id}/rotate_secret","href":"/reference/api-reference/webhook-subscriptions/postwebhooksubscriptionsbyidrotatesecret"},{"title":"List available event types","deprecated":false,"version":null,"sidebarTitle":"Getwebhooksubscriptionseventtypes","openapi":"/api-reference/openapi.json get /api/v3.1/webhook_subscriptions/event_types","href":"/reference/api-reference/webhook-subscriptions/getwebhooksubscriptionseventtypes"}]},{"group":"Webhook Endpoints","pages":[{"title":"List webhook endpoints","deprecated":false,"version":null,"sidebarTitle":"Getwebhookendpoints","openapi":"/api-reference/openapi.json get /api/v3.1/webhook_endpoints","href":"/reference/api-reference/webhook-endpoints/getwebhookendpoints"},{"title":"Create webhook endpoint","deprecated":false,"version":null,"sidebarTitle":"Postwebhookendpoints","openapi":"/api-reference/openapi.json post /api/v3.1/webhook_endpoints","href":"/reference/api-reference/webhook-endpoints/postwebhookendpoints"},{"title":"Get webhook endpoint","deprecated":false,"version":null,"sidebarTitle":"Getwebhookendpointsbynanoid","openapi":"/api-reference/openapi.json get /api/v3.1/webhook_endpoints/{nano_id}","href":"/reference/api-reference/webhook-endpoints/getwebhookendpointsbynanoid"},{"title":"Put webhook endpoint configuration","deprecated":false,"version":null,"sidebarTitle":"Postwebhookendpointsbynanoid","openapi":"/api-reference/openapi.json post /api/v3.1/webhook_endpoints/{nano_id}","href":"/reference/api-reference/webhook-endpoints/postwebhookendpointsbynanoid"},{"title":"Update webhook endpoint configuration","deprecated":false,"version":null,"sidebarTitle":"Patchwebhookendpointsbynanoid","openapi":"/api-reference/openapi.json patch /api/v3.1/webhook_endpoints/{nano_id}","href":"/reference/api-reference/webhook-endpoints/patchwebhookendpointsbynanoid"}]},{"group":"Triggers","pages":[{"title":"Create or update a trigger","deprecated":false,"version":null,"sidebarTitle":"Posttriggerinstancesbyslugupsert","openapi":"/api-reference/openapi.json post /api/v3.1/trigger_instances/{slug}/upsert","href":"/reference/api-reference/triggers/posttriggerinstancesbyslugupsert"},{"title":"List active triggers","deprecated":false,"version":null,"sidebarTitle":"Gettriggerinstancesactive","openapi":"/api-reference/openapi.json get /api/v3.1/trigger_instances/active","href":"/reference/api-reference/triggers/gettriggerinstancesactive"},{"title":"Delete a trigger","deprecated":false,"version":null,"sidebarTitle":"Deletetriggerinstancesmanagebytriggerid","openapi":"/api-reference/openapi.json delete /api/v3.1/trigger_instances/manage/{triggerId}","href":"/reference/api-reference/triggers/deletetriggerinstancesmanagebytriggerid"},{"title":"Update a trigger","deprecated":false,"version":null,"sidebarTitle":"Patchtriggerinstancesmanagebytriggerid","openapi":"/api-reference/openapi.json patch /api/v3.1/trigger_instances/manage/{triggerId}","href":"/reference/api-reference/triggers/patchtriggerinstancesmanagebytriggerid"},{"title":"List trigger type enums","deprecated":false,"version":null,"sidebarTitle":"Gettriggerstypeslistenum","openapi":"/api-reference/openapi.json get /api/v3.1/triggers_types/list/enum","href":"/reference/api-reference/triggers/gettriggerstypeslistenum"},{"title":"Get trigger type by slug","deprecated":false,"version":null,"sidebarTitle":"Gettriggerstypesbyslug","openapi":"/api-reference/openapi.json get /api/v3.1/triggers_types/{slug}","href":"/reference/api-reference/triggers/gettriggerstypesbyslug"},{"title":"List trigger types","deprecated":false,"version":null,"sidebarTitle":"Gettriggerstypes","openapi":"/api-reference/openapi.json get /api/v3.1/triggers_types","href":"/reference/api-reference/triggers/gettriggerstypes"}]},{"group":"MCP","pages":[{"title":"List MCP servers with optional filters and pagination","deprecated":true,"version":null,"sidebarTitle":"Getmcpservers","openapi":"/api-reference/openapi.json get /api/v3.1/mcp/servers","href":"/reference/api-reference/mcp/getmcpservers"},{"title":"Create a new MCP server","deprecated":true,"version":null,"sidebarTitle":"Postmcpservers","openapi":"/api-reference/openapi.json post /api/v3.1/mcp/servers","href":"/reference/api-reference/mcp/postmcpservers"},{"title":"Create a new custom MCP server with multiple apps","deprecated":true,"version":null,"sidebarTitle":"Postmcpserverscustom","openapi":"/api-reference/openapi.json post /api/v3.1/mcp/servers/custom","href":"/reference/api-reference/mcp/postmcpserverscustom"},{"title":"Generate MCP URL with custom parameters","deprecated":true,"version":null,"sidebarTitle":"Postmcpserversgenerate","openapi":"/api-reference/openapi.json post /api/v3.1/mcp/servers/generate","href":"/reference/api-reference/mcp/postmcpserversgenerate"},{"title":"Get MCP server details by ID","deprecated":true,"version":null,"sidebarTitle":"Getmcpbyid","openapi":"/api-reference/openapi.json get /api/v3.1/mcp/{id}","href":"/reference/api-reference/mcp/getmcpbyid"},{"title":"Delete an MCP server","deprecated":true,"version":null,"sidebarTitle":"Deletemcpbyid","openapi":"/api-reference/openapi.json delete /api/v3.1/mcp/{id}","href":"/reference/api-reference/mcp/deletemcpbyid"},{"title":"Update MCP server configuration","deprecated":true,"version":null,"sidebarTitle":"Patchmcpbyid","openapi":"/api-reference/openapi.json patch /api/v3.1/mcp/{id}","href":"/reference/api-reference/mcp/patchmcpbyid"},{"title":"List MCP servers for a specific app","deprecated":true,"version":null,"sidebarTitle":"Getmcpappbyappkey","openapi":"/api-reference/openapi.json get /api/v3.1/mcp/app/{appKey}","href":"/reference/api-reference/mcp/getmcpappbyappkey"},{"title":"List all instances for an MCP server","deprecated":true,"version":null,"sidebarTitle":"Getmcpserversbyserveridinstances","openapi":"/api-reference/openapi.json get /api/v3.1/mcp/servers/{serverId}/instances","href":"/reference/api-reference/mcp/getmcpserversbyserveridinstances"},{"title":"Create a new MCP server instance","deprecated":true,"version":null,"sidebarTitle":"Postmcpserversbyserveridinstances","openapi":"/api-reference/openapi.json post /api/v3.1/mcp/servers/{serverId}/instances","href":"/reference/api-reference/mcp/postmcpserversbyserveridinstances"},{"title":"Delete an MCP server instance and associated connected accounts","deprecated":true,"version":null,"sidebarTitle":"Deletemcpserversbyserveridinstancesbyinstanceid","openapi":"/api-reference/openapi.json delete /api/v3.1/mcp/servers/{serverId}/instances/{instanceId}","href":"/reference/api-reference/mcp/deletemcpserversbyserveridinstancesbyinstanceid"}]},{"group":"Files","pages":[{"title":"List files with optional app and action filters (DEPRECATED)","deprecated":true,"version":null,"sidebarTitle":"Getfileslist","openapi":"/api-reference/openapi.json get /api/v3.1/files/list","href":"/reference/api-reference/files/getfileslist"},{"title":"Create presigned URL for request file upload to S3","deprecated":false,"version":null,"sidebarTitle":"Postfilesuploadrequest","openapi":"/api-reference/openapi.json post /api/v3.1/files/upload/request","href":"/reference/api-reference/files/postfilesuploadrequest"}]},{"group":"Webhook Events","pages":[{"title":"Trigger message","openapi":"api-reference/openapi.json webhook composio.trigger.message","href":"/reference/api-reference/webhook-events/composio_trigger_message"},{"title":"Trigger message (V2)","openapi":"api-reference/openapi.json webhook composio.trigger.message.v2","deprecated":true,"href":"/reference/api-reference/webhook-events/composio_trigger_message_v2"},{"title":"Trigger message (V1)","openapi":"api-reference/openapi.json webhook composio.trigger.message.v1","deprecated":true,"href":"/reference/api-reference/webhook-events/composio_trigger_message_v1"},{"title":"Connection expired","openapi":"api-reference/openapi.json webhook composio.connected_account.expired","href":"/reference/api-reference/webhook-events/composio_connected_account_expired"},{"title":"Connection activated","openapi":"api-reference/openapi.json webhook composio.connected_account.activated","href":"/reference/api-reference/webhook-events/composio_connected_account_activated"},{"title":"Trigger disabled","openapi":"api-reference/openapi.json webhook composio.trigger.disabled","href":"/reference/api-reference/webhook-events/composio_trigger_disabled"}]}]},{"version":"v3.0","pages":[{"title":"v3.0","href":"/reference/v3/api-reference/tool-router/posttoolroutersession"}]}]}]},"basePath":"","title":"Attach to an existing tool router session (v3.1) - Composio Docs","buildId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","deploymentId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DbeN8Wo6.js","utils-CwSb5Doc.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BmREeM3N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-AYjWerCj.js","snippetPresets-QD4ULQlp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-CqcDm2To.js","ApiExamples-Digj5cjF.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CiHrzluR.js","shallow-D7h7pFGg.js","getApiPlaygroundDisplay-mlxkpAUf.js","CodeSnippet-D2rH5lZI.js","CodeSnippets-B53ulOaL.js","getPastedJson-DxGeNMih.js","icon-BHbyrebp.js","MethodPill-C7F_KEEJ.js","DuplicateIcon-j3c5-73z.js","createIcon-OvCnyFqD.js","DynamicMarkdown-DpAS3GCb.js","SectionHeading-DMPpdrvW.js","axios-vUo_bRtp.js","Markdown-D7pDRguu.js","clsx-2_c6mSt_.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cu7_SikL.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ydqCcy4b.js"]}