---
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

## Changes

- **2026-07-22** `c039e97e7f14` — 3 info
  - added the optional property `scope_requirements/all_of/items/anyOf[subschema #2]/any_of/items/anyOf[subschema #2]/source` to the response with the `200` status
  - added the optional property `scope_requirements/all_of/items/anyOf[subschema #2]/source` to the response with the `200` status
  - added the optional property `scope_requirements/source` to the response with the `200` status
- **2026-07-16** `b61c29327d74` — 1 breaking, 2 info
  - the `scope_requirements/all_of/items/anyOf[subschema #2]/any_of/items/` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - added the optional property `scope_requirements/all_of/items/anyOf[subschema #2]/when` to the response with the `200` status
  - added `subschema #1, subschema #2` to the `scope_requirements/all_of/items/anyOf[subschema #2]/any_of/items/` response property `anyOf` list for the response status `200`
- **2026-06-17** `589a7d115a5e` — 1 info
  - the endpoint scheme security `CookieAuth` was removed from the API
- **2026-05-05** `52c71f747c65` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1/changes/api/v3.1/tools/:tool_slug/get.md)

---

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