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
Path parameters
session_idstring toolRouterSessionId
Tool router session ID
Tool router session ID
Request body
object required
Response
Successfully retrieved tools with their complete schemas.
Example response
{
"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"
}
},
"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"
],
"human_description": "Create a new issue in a GitHub repository",
"deprecated": {
"displayName": "GitHub Actions",
"version": "20250905_00",
"available_versions": [
"20250905_00",
"20250906_00"
],
"toolkit": {
"logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
}
}
}
]
}