API ReferenceTool Router

List meta tools with schemas for a tool router session

Markdown
GET
/api/v3/tool_router/session/{session_id}/tools

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.

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Path Parameters

session_id?string

Tool router session ID

FormattoolRouterSessionId

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://backend.composio.dev/api/v3/tool_router/session/{session_id}/tools" \  -H "Content-Type: application/json" \  -d '{}'
{
  "items": [
    {
      "slug": "github-actions",
      "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,
          "examples": [
            "octocat/Hello-World"
          ]
        },
        "workflow_id": {
          "type": "string",
          "description": "ID or filename of the workflow to trigger",
          "required": true,
          "examples": [
            "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",
          "examples": [
            12345678
          ]
        },
        "status": {
          "type": "string",
          "description": "Status of the workflow run",
          "enum": [
            "queued",
            "in_progress",
            "completed",
            "failed"
          ],
          "examples": [
            "completed"
          ]
        }
      },
      "scopes": [
        "https://www.googleapis.com/auth/gmail.modify"
      ],
      "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"
        }
      }
    }
  ]
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}