List meta tools with schemas for a tool router session

GET

https://backend.composio.dev/api/v3/tool_router/session/:session_id/tools

GET

/api/v3/tool_router/session/:session_id/tools

1 import requests
2 
3 url = "https://backend.composio.dev/api/v3/tool_router/session/session_id/tools"
4 
5 payload = {}
6 headers = {
7     "x-api-key": "<apiKey>",
8     "Content-Type": "application/json"
9 }
10 
11 response = requests.get(url, json=payload, headers=headers)
12 
13 print(response.json())

Try it

200Retrieved

1 {
2   "items": [
3     {
4       "slug": "github-actions",
5       "name": "GitHub Actions",
6       "description": "Automate GitHub workflows including CI/CD, issue management, and release processes",
7       "toolkit": {
8         "slug": "github",
9         "name": "GitHub",
10         "logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
11       },
12       "input_parameters": {
13         "repo_name": {
14           "type": "string",
15           "description": "GitHub repository name in owner/repo format",
16           "required": true,
17           "example": "octocat/Hello-World"
18         },
19         "workflow_id": {
20           "type": "string",
21           "description": "ID or filename of the workflow to trigger",
22           "required": true,
23           "example": "main.yml"
24         }
25       },
26       "no_auth": false,
27       "available_versions": [
28         "20250905_00",
29         "20250906_00"
30       ],
31       "version": "20250905_00",
32       "output_parameters": {
33         "run_id": {
34           "type": "number",
35           "description": "ID of the workflow run that was triggered",
36           "example": 12345678
37         },
38         "status": {
39           "type": "string",
40           "description": "Status of the workflow run",
41           "example": "completed",
42           "enum": [
43             "queued",
44             "in_progress",
45             "completed",
46             "failed"
47           ]
48         }
49       },
50       "scopes": [
51         "https://www.googleapis.com/auth/gmail.modify"
52       ],
53       "tags": [
54         "ci-cd",
55         "github",
56         "automation",
57         "devops"
58       ],
59       "is_deprecated": false,
60       "deprecated": {
61         "displayName": "GitHub Actions",
62         "version": "20250905_00",
63         "available_versions": [
64           "20250905_00",
65           "20250906_00"
66         ],
67         "is_deprecated": false,
68         "toolkit": {
69           "logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
70         }
71       }
72     }
73   ]
74 }

Returns the meta tools available in a tool router session with their complete schemas. This includes request and response schemas specific to the session context.

Authentication

x-api-keystring

API key authentication

Path parameters

session_idstringOptionalformat: "toolRouterSessionId"

Tool router session ID

Request

This endpoint expects an object.

Response

Successfully retrieved meta tools with their complete schemas.

itemslist of objects

List of tools with their complete schemas

Authentication

Path parameters

Request

Response

Errors