Get toolkit by 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.

get/api/v3.1/toolkits/{slug}

Path parameters

slugstring required

The unique slug identifier of the toolkit to retrieve

Example:github

Toolkit slug identifier

Query parameters

versionstring

Version of the toolkit

Example:20250905_00

Version of the toolkit

Response

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

slugstring required

URL-friendly unique identifier for the toolkit

namestring 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

enabledboolean required

Indicates if this toolkit is currently enabled and available for use

composio_managed_auth_schemesstring[]

List of authentication methods that Composio manages for this toolkit

is_local_toolkitboolean 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_guide_urlstring nullable

URL to a guide page with authentication setup instructions for this toolkit

base_urlstring

If evaluation of base URL needs some connection info (like shopify), please create the connection and get the base URL from there

get_current_user_endpointstring

Endpoint to get the current user

get_current_user_endpoint_methodstring

HTTP method to use when calling the get current user endpoint (e.g., GET, POST)

Example response

{
  "slug": "github",
  "name": "GitHub",
  "type": "native",
  "enabled": true,
  "composio_managed_auth_schemes": [
    "oauth2"
  ],
  "composio_managed_auth": [
    {
      "mode": "OAUTH2",
      "scopes": {
        "available": [
          "read",
          "write"
        ]
      },
      "user_scopes": {
        "available": [
          "search:read",
          "users:read"
        ]
      }
    }
  ],
  "auth_config_details": [
    {
      "mode": "oauth2",
      "required_scopes": [
        "offline_access",
        "User.Read"
      ],
      "proxy": {
        "base_url": "https://auth.example.com/proxy"
      },
      "name": "OAuth 2.0",
      "auth_hint_url": "https://github.com/settings/tokens"
    }
  ],
  "auth_guide_url": "https://composio.dev/auth/github",
  "base_url": "https://api.github.com",
  "meta": {
    "created_at": "2023-01-15T09:30:00.000Z",
    "updated_at": "2023-05-20T14:45:00.000Z",
    "description": "Integrate with GitHub repositories, issues, pull requests, and more.",
    "logo": "https://assets.composio.dev/logos/github.png",
    "app_url": "https://github.com",
    "categories": [
      {
        "name": "Developer Tools",
        "slug": "developer-tools"
      },
      {
        "name": "Productivity",
        "slug": "productivity"
      }
    ],
    "triggers_count": 5,
    "tools_count": 12,
    "version": "20250905_00",
    "available_versions": [
      "20250905_00",
      "20250906_00"
    ]
  },
  "get_current_user_endpoint_method": "GET"
}

Changes

Changed in 7 of the 61 revisions of this API.413

Jul 24, 20267957524a25901See the full diff
- ○
  added the required property auth_config_details/items/required_scopes to the response with the 200 status
  response-required-property-added
Jul 7, 2026ebe821998eab1See the full diff
- ○
  added the required property type to the response with the 200 status
  response-required-property-added
Jun 29, 202639778f3995084See the full diff
- ●
  removed the optional property auth_config_details/items/fields/auth_config_creation/optional/items/advanced from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property auth_config_details/items/fields/auth_config_creation/required/items/advanced from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property auth_config_details/items/fields/connected_account_initiation/optional/items/advanced from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property auth_config_details/items/fields/connected_account_initiation/required/items/advanced from the response with the 200 status
  response-optional-property-removed
Jun 25, 20264a4a24bbe8fd1See the full diff
- ○
  added the required property composio_managed_auth to the response with the 200 status
  response-required-property-added
Jun 17, 2026589a7d115a5e1See the full diff
- ○
  the endpoint scheme security CookieAuth was removed from the API
  api-security-removed
May 11, 202623348819b35e8See the full diff
- ○
  added the optional property auth_config_details/items/fields/auth_config_creation/optional/items/advanced to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property auth_config_details/items/fields/auth_config_creation/optional/items/is_secret to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property auth_config_details/items/fields/auth_config_creation/required/items/advanced to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property auth_config_details/items/fields/auth_config_creation/required/items/is_secret to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property auth_config_details/items/fields/connected_account_initiation/optional/items/advanced to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property auth_config_details/items/fields/connected_account_initiation/optional/items/is_secret to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property auth_config_details/items/fields/connected_account_initiation/required/items/advanced to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property auth_config_details/items/fields/connected_account_initiation/required/items/is_secret to the response with the 200 status
  response-optional-property-added
May 5, 202652c71f747c651See the full diff
- ○
  endpoint added
  endpoint-added

Full history