---
title: "List tools with schemas for a tool router session"
method: GET
path: "/api/v3/tool_router/session/{session_id}/tools"
tags: ["Tool Router"]
---

# List tools with schemas for a tool router session

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

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.

## Path parameters

- `session_id` string, toolRouterSessionId — Tool router session ID

## Request body

- object

## Response `200`

Successfully retrieved tools with their complete schemas.

- object
  - `items` Tool[], required — List of tools with their complete schemas
    - `slug` string, required — Unique identifier for the tool
    - `name` string, required — Human-readable display name of the tool
    - `description` string, required — Detailed explanation of the tool's functionality and purpose
    - `toolkit` object, required
      - `slug` string, required — Unique identifier of the parent toolkit
      - `name` string, required — Human-readable name of the parent toolkit
      - `logo` string, required — URL to the toolkit logo image
    - `input_parameters` object, required — Schema definition of required input parameters for the tool
    - `no_auth` boolean, required — Indicates if the tool can be used without authentication
    - `available_versions` string[], required — List of all available versions for this tool
    - `version` string, required — Current version of the tool
    - `output_parameters` object, required — Schema definition of return values from the tool
    - `scopes` string[], required — List of scopes associated with the tool
    - `scope_requirements` object, nullable, required — Structured scope requirements for the tool. Null means the tool is legacy and only exposes flat scopes.
      - `all_of` union[], required
        - union
          - string
          - object
            - `any_of` union[], required
              - …
            - `when` object
            - `source` string[]
      - `source` string[]
    - `tags` string[], required — List of tags associated with the tool for categorization and filtering
    - `human_description` string — Human-friendly description of the tool, if available
    - `is_deprecated` boolean, required — Indicates if this tool is deprecated and may be removed in the future
    - `deprecated` object, required
      - `displayName` string, required — The display name of the tool
      - `version` string, required — Current version identifier of the tool
      - `available_versions` string[], required — List of all available versions for this tool
      - `is_deprecated` boolean, required — Indicates if this tool is deprecated and may be removed in the future
      - `toolkit` object, required
        - `logo` string, required — URL to the toolkit logo image

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `413` — Payload too large
- `429` — Too many requests
- `500` — Internal server error
- `502` — Bad gateway

---

[API](https://skmtc.dev/composiohq/apis/composio-platform-api.md) · [All operations](https://skmtc.dev/composiohq/apis/composio-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api/revisions/368fb7851f42/schema)