---
title: "Get tool by slug"
method: GET
path: "/api/v3.1/tools/{tool_slug}"
tags: ["Tools"]
---

# Get tool by slug

`GET /api/v3.1/tools/{tool_slug}`

Retrieve detailed information about a specific tool using its slug identifier. This endpoint returns full metadata about a tool including input/output parameters, versions, and toolkit information.

## Path parameters

- `tool_slug` string, required

## Query parameters

- `version` string
- `toolkit_versions` union
  - string
  - object — Object representation of parsed bracket notation

## Response `200`

Successfully retrieved tool details

- Tool
  - `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
            - union
              - …
          - `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 - Invalid tool slug format
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `404` — Not found - Tool with the specified slug does not exist
- `500` — Internal server error - Something went wrong on the server

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)