API ReferenceToolkits

Fetch multiple toolkits

Markdown
POST
/api/v3/toolkits/multi

Retrieves a comprehensive list of toolkits of their latest versions that are available to the authenticated project. Toolkits represent integration points with external services and applications, each containing a collection of tools and triggers. This endpoint supports filtering by category and management type, as well as different sorting options. You can optionally specify a list of toolkit slugs to fetch specific toolkits.

Authorization

x-api-key<token>

Project API key authentication

In: header

Request Body

application/json

toolkitsarray of string

Array of toolkit slug identifiers to retrieve

categorystring

Category ID or name to filter toolkits by

managed_byenum

Entity responsible for managing the toolkits

Possible values:
composioallproject
sort_byenum

Determines how toolkits should be sorted in the response

Possible values:
usagealphabetically
limitnullable number
cursorstring

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://backend.composio.dev/api/v3/toolkits/multi" \  -H "Content-Type: application/json" \  -d '{}'
{
  "items": [
    {
      "slug": "github",
      "name": "GitHub",
      "auth_schemes": [
        "oauth2",
        "api_key"
      ],
      "composio_managed_auth_schemes": [
        "oauth2"
      ],
      "is_local_toolkit": false,
      "no_auth": false,
      "deprecated": {
        "toolkitId": "550e8400-e29b-41d4-a716-446655440000"
      },
      "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": [
          {
            "id": "developer-tools",
            "name": "Developer Tools"
          },
          {
            "id": "productivity",
            "name": "Productivity"
          }
        ],
        "triggers_count": 5,
        "tools_count": 12,
        "version": "20250905_00"
      }
    }
  ],
  "next_cursor": "string",
  "total_pages": 0,
  "current_page": 0,
  "total_items": 0
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}