---
title: "Get toolkit by slug"
method: GET
path: "/api/v3.1/toolkits/{slug}"
tags: ["Toolkits", "Integration"]
---

# Get toolkit by slug

`GET /api/v3.1/toolkits/{slug}`

Retrieves comprehensive information about a specific toolkit using its unique slug identifier. This endpoint provides detailed metadata, authentication configuration options, and feature counts for the requested toolkit.

## Path parameters

- `slug` string, required — The unique slug identifier of the toolkit to retrieve

## Query parameters

- `version` string — Version of the toolkit

## Response `200`

Successfully retrieved detailed information about the requested toolkit, including authentication options, metadata, and feature counts.

- object — Detailed information about a single toolkit
  - `slug` string, required — URL-friendly unique identifier for the toolkit
  - `name` string, required — Human-readable name of the toolkit
  - `type` 'native' | 'custom', required — Toolkit provenance: "native" for Composio-managed toolkits, "custom" for a project-registered custom (MCP) toolkit
  - `enabled` boolean, required — Indicates if this toolkit is currently enabled and available for use
  - `composio_managed_auth_schemes` string[] — List of authentication methods that Composio manages for this toolkit
  - `composio_managed_auth` object[], required — Managed-auth-only metadata, including the supported OAuth scope ceiling.
    - `mode` string, required — Authentication mode for the Composio-managed auth config
    - `scopes` object, required — OAuth scopes available in the Composio-managed auth config for this auth mode.
      - `available` string[], required — Available OAuth scopes
    - `user_scopes` object — OAuth user scopes available in the Composio-managed auth config for this auth mode. Only present for Slack toolkits.
      - `available` string[], required — Available OAuth user scopes
  - `is_local_toolkit` boolean, required — DEPRECATED: This field is no longer meaningful and will always return false. It was previously used to indicate if a toolkit is specific to the current project.
  - `auth_config_details` object[] — Complete authentication configuration details for each supported auth method
    - `mode` string, required — The type of authentication mode (e.g., oauth2, basic_auth, api_key)
    - `required_scopes` string[], required — OAuth scopes that are always requested for this authentication method regardless of the tool-specific scopes selected, such as token-refresh (e.g. offline_access) and identity/whoami scopes. Consumers handling authentication themselves should union these with per-tool scopes.
    - `fields` object, required — Field groups required for different authentication stages
      - `auth_config_creation` object, required — Form fields needed when creating an authentication configuration
        - `required` object[], required
          - `name` string, required
          - `displayName` string, required
          - `default` string, nullable
          - `type` string, required
          - `description` string, required
          - `required` boolean, required
          - `is_secret` boolean
          - `legacy_template_name` string
        - `optional` object[], required
          - `name` string, required
          - `displayName` string, required
          - `default` string, nullable
          - `type` string, required
          - `description` string, required
          - `required` boolean, required
          - `is_secret` boolean
          - `legacy_template_name` string
      - `connected_account_initiation` object, required — Form fields needed when connecting a user account with this authentication method
        - `required` object[], required
          - `name` string, required
          - `displayName` string, required
          - `default` string, nullable
          - `type` string, required
          - `description` string, required
          - `required` boolean, required
          - `is_secret` boolean
          - `legacy_template_name` string
        - `optional` object[], required
          - `name` string, required
          - `displayName` string, required
          - `default` string, nullable
          - `type` string, required
          - `description` string, required
          - `required` boolean, required
          - `is_secret` boolean
          - `legacy_template_name` string
    - `proxy` object — Configuration for proxying authentication requests to external services
      - `base_url` string, required — URL to which authentication requests will be proxied
    - `name` string, required — Display name for this authentication method
    - `auth_hint_url` string, nullable — URL to a page where users can obtain or configure credentials for this authentication method
    - `deprecated_auth_provider_details` object — Authentication URL fields for OAuth 2.0 and OAuth 1.0. We don't recommend using this field for authentication and might break post Aug 31 2025.
      - `authorization_url` string
      - `token_url` string
  - `auth_guide_url` string, nullable — URL to a guide page with authentication setup instructions for this toolkit
  - `base_url` string — If evaluation of base URL needs some connection info (like shopify), please create the connection and get the base URL from there
  - `meta` object, required — Comprehensive metadata for the toolkit including dates, descriptions, and statistics
    - `created_at` string, required — Creation date and time of the toolkit
    - `updated_at` string, required — Last modification date and time of the toolkit
    - `description` string, required — Human-readable description explaining the toolkit's purpose and functionality
    - `logo` string, required — Image URL for the toolkit's branding
    - `app_url` string, nullable — Link to the toolkit's main application or service website
    - `categories` object[], required — List of categories associated with this toolkit
      - `name` string, required — Human-readable category name
      - `slug` string, required — URL-friendly identifier for the category
    - `triggers_count` number, required — Count of available triggers in this toolkit
    - `tools_count` number, required — Count of available tools in this toolkit
    - `version` string, required — Version of the toolkit
    - `available_versions` string[], required — Available versions of the toolkit
  - `get_current_user_endpoint` string — Endpoint to get the current user
  - `get_current_user_endpoint_method` string — HTTP method to use when calling the get current user endpoint (e.g., GET, POST)
  - `deprecated` object, required
    - `toolkitId` string, required
    - `getCurrentUserEndpoint` string
    - `rawProxyInfoByAuthSchemes` object[], required

## Other responses

- `400` — Bad request. The toolkit slug may be invalid or in an incorrect format.
- `401` — Unauthorized. Authentication is required or the provided credentials are invalid.
- `404` — Not found. The requested toolkit does not exist or is not accessible to the authenticated project.
- `500` — Internal server error. An unexpect ed error occurred while processing the request.

---

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