Sessions (Prev Tool Router)
List tools with schemas for a tool router session
Returns the tools available in a tool router session with their complete schemas. This includes both meta tools and any preloaded app tools exposed by the session. Tools are returned in alphabetical order.
GET
/
api
/
v3
/
tool_router
/
session
/
{session_id}
/
tools
List tools with schemas for a tool router session
import requests
url = "https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools"
payload = {}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{}'package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("GET", 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.get("https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{}")
.asString();using RestSharp;
var options = new RestClientOptions("https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-api-key", "<api-key>");
request.AddJsonBody("{}", false);
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
false{
"items": [
{
"slug": "GITHUB_CREATE_A_WORKFLOW_DISPATCH_EVENT",
"name": "GitHub Actions",
"description": "Automate GitHub workflows including CI/CD, issue management, and release processes",
"toolkit": {
"slug": "github",
"name": "GitHub",
"logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
},
"input_parameters": {
"repo_name": {
"type": "string",
"description": "GitHub repository name in owner/repo format",
"required": true,
"example": "octocat/Hello-World"
},
"workflow_id": {
"type": "string",
"description": "ID or filename of the workflow to trigger",
"required": true,
"example": "main.yml"
}
},
"no_auth": false,
"available_versions": [
"20250905_00",
"20250906_00"
],
"version": "20250905_00",
"output_parameters": {
"run_id": {
"type": "number",
"description": "ID of the workflow run that was triggered",
"example": 12345678
},
"status": {
"type": "string",
"description": "Status of the workflow run",
"example": "completed",
"enum": [
"queued",
"in_progress",
"completed",
"failed"
]
}
},
"scopes": [
"https://www.googleapis.com/auth/gmail.modify"
],
"scope_requirements": {
"all_of": [
"read:user",
{
"any_of": [
"repo",
"public_repo"
]
}
]
},
"tags": [
"ci-cd",
"github",
"automation",
"devops"
],
"is_deprecated": false,
"deprecated": {
"displayName": "GitHub Actions",
"version": "20250905_00",
"available_versions": [
"20250905_00",
"20250906_00"
],
"is_deprecated": false,
"toolkit": {
"logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
}
},
"instant": {
"supported": true,
"price": {
"description": "<string>",
"discount": "<string>"
}
},
"human_description": "Create a new issue in a GitHub repository"
}
]
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}Authorizations
Body
application/json
The body is of type object.
List tools with schemas for a tool router session
import requests
url = "https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools"
payload = {}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{}'package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("GET", 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.get("https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{}")
.asString();using RestSharp;
var options = new RestClientOptions("https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-api-key", "<api-key>");
request.AddJsonBody("{}", false);
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
false{
"items": [
{
"slug": "GITHUB_CREATE_A_WORKFLOW_DISPATCH_EVENT",
"name": "GitHub Actions",
"description": "Automate GitHub workflows including CI/CD, issue management, and release processes",
"toolkit": {
"slug": "github",
"name": "GitHub",
"logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
},
"input_parameters": {
"repo_name": {
"type": "string",
"description": "GitHub repository name in owner/repo format",
"required": true,
"example": "octocat/Hello-World"
},
"workflow_id": {
"type": "string",
"description": "ID or filename of the workflow to trigger",
"required": true,
"example": "main.yml"
}
},
"no_auth": false,
"available_versions": [
"20250905_00",
"20250906_00"
],
"version": "20250905_00",
"output_parameters": {
"run_id": {
"type": "number",
"description": "ID of the workflow run that was triggered",
"example": 12345678
},
"status": {
"type": "string",
"description": "Status of the workflow run",
"example": "completed",
"enum": [
"queued",
"in_progress",
"completed",
"failed"
]
}
},
"scopes": [
"https://www.googleapis.com/auth/gmail.modify"
],
"scope_requirements": {
"all_of": [
"read:user",
{
"any_of": [
"repo",
"public_repo"
]
}
]
},
"tags": [
"ci-cd",
"github",
"automation",
"devops"
],
"is_deprecated": false,
"deprecated": {
"displayName": "GitHub Actions",
"version": "20250905_00",
"available_versions": [
"20250905_00",
"20250906_00"
],
"is_deprecated": false,
"toolkit": {
"logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
}
},
"instant": {
"supported": true,
"price": {
"description": "<string>",
"discount": "<string>"
}
},
"human_description": "Create a new issue in a GitHub repository"
}
]
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}{
"error": {
"message": "<string>",
"code": 123,
"slug": "<string>",
"status": 123,
"request_id": "<string>",
"suggested_fix": "<string>",
"errors": [
"<string>"
]
}
}