> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch multiple toolkits

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



## OpenAPI

````yaml api-reference/openapi-v3.json POST /api/v3/toolkits/multi
openapi: 3.0.0
info:
  version: 3.0.0
  title: Composio Platform API
  description: >-
    Composio v3 API — legacy endpoints under /api/v3/. Use v3.1 for new
    integrations.
  contact:
    name: Composio Support
    url: https://composio.dev/support
    email: support@composio.dev
  license:
    name: Proprietary
    url: https://composio.dev/terms
servers:
  - url: https://backend.composio.dev
    description: Composio production API
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: Authentication related endpoints
    x-group: Authentication
  - name: Auth Configs
    description: Authentication configuration management
    x-group: Auth Configs
  - name: Connected Accounts
    description: Connected account management
    x-group: Connected Accounts
  - name: Logs
    description: Logging and monitoring
    x-group: Logs
  - name: OpenAPI
    description: OpenAPI specification management
    x-group: OpenAPI
  - name: Organization
    description: Organization management
    x-group: Organization
  - name: API Keys
    description: API key management
    x-group: API Keys
  - name: Webhooks
    description: Webhook configuration
    x-group: Webhooks
  - name: Webhook Endpoints
    description: >-
      Per-OAuth-app webhook ingress endpoints. Inbound URLs the provider posts
      to, plus signing secret storage and verification.
    x-group: Webhook Endpoints
  - name: Webhook Subscriptions
    description: >-
      Webhook delivery subscriptions. Outbound URLs Composio posts trigger
      events to, plus signing secret rotation and event-type filters.
    x-group: Webhook Subscriptions
  - name: Team
    description: Team member management
    x-group: Team
  - name: Consumer Skills
    description: Organization-authored Skill management
    x-group: Consumer Skills
  - name: Toolkits
    description: Toolkit and tool management
    x-group: Toolkits
  - name: Tools
    description: Tool execution endpoints
    x-group: Tools
  - name: Triggers
    description: Trigger management and execution
    x-group: Triggers
  - name: Payments
    description: Payment and subscription management
    x-group: Payments
  - name: Billing
    description: Dashboard billing state — usage, subscription, contract (cookie-auth only)
    x-group: Billing
  - name: Compliance
    description: Organization compliance agreements and acceptance state
    x-group: Compliance
  - name: Files
    description: File management
    x-group: Files
  - name: MCP
    description: MCP server management
    x-group: MCP
  - name: MCP Partner
    description: MCP partner management
    x-group: MCP Partner
  - name: Stripe Projects
    description: Stripe Projects provisioning
    x-group: Stripe Projects
  - name: Tool Router
    description: (Labs) Tool router endpoints
    x-group: Sessions (Prev Tool Router)
  - name: Playground
    description: Dashboard playground chat
    x-group: Playground
  - name: Arena
    description: Arena conversations, messages and terms
    x-group: Arena
  - name: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Projects
    description: Projects API endpoints.
    x-group: Projects
paths:
  /api/v3/toolkits/multi:
    post:
      tags:
        - Toolkits
      summary: Fetch multiple toolkits
      description: >-
        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.
      operationId: postToolkitsMulti
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                toolkits:
                  type: array
                  items:
                    type: string
                  description: Array of toolkit slug identifiers to retrieve
                  example:
                    - github
                    - slack
                    - gmail
                category:
                  type: string
                  description: Category ID or name to filter toolkits by
                  example: productivity
                managed_by:
                  type: string
                  enum:
                    - composio
                    - all
                    - project
                  description: Entity responsible for managing the toolkits
                sort_by:
                  type: string
                  enum:
                    - usage
                    - alphabetically
                  description: Determines how toolkits should be sorted in the response
                limit:
                  type: number
                  nullable: true
                cursor:
                  type: string
              description: Body parameters for filtering and sorting toolkits
      responses:
        '200':
          description: >-
            Toolkits retrieved successfully. Returns a paginated list of
            available toolkits with detailed metadata.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          description: URL-friendly unique identifier for the toolkit
                          example: github
                        name:
                          type: string
                          description: Human-readable name of the toolkit
                          example: GitHub
                        type:
                          type: string
                          enum:
                            - native
                            - custom
                          description: >-
                            Toolkit provenance: "native" for Composio-managed
                            toolkits, "custom" for a project-registered custom
                            (MCP) toolkit
                          example: native
                        instant:
                          type: object
                          properties:
                            supported:
                              type: boolean
                              enum:
                                - true
                          required:
                            - supported
                          description: >-
                            Present when the latest version of this toolkit
                            supports Instant accounts. See the tools endpoint
                            for support on individual tools.
                        access:
                          type: string
                          enum:
                            - all
                            - user
                          description: >-
                            [EXPERIMENTAL] Custom toolkits only. "all": every
                            user in the project can use it. "user": only the
                            user it was created for can.
                          example: all
                          x-experimental: true
                        auth_schemes:
                          type: array
                          items:
                            type: string
                          description: >-
                            List of authentication methods supported by this
                            toolkit
                          example:
                            - oauth2
                            - api_key
                        composio_managed_auth_schemes:
                          type: array
                          items:
                            type: string
                          description: >-
                            List of authentication methods that Composio manages
                            for this toolkit
                          example:
                            - oauth2
                        is_local_toolkit:
                          type: boolean
                          description: >-
                            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.
                          deprecated: true
                          example: false
                        no_auth:
                          type: boolean
                          description: >-
                            When true, this toolkit can be used without
                            authentication
                          example: false
                        auth_guide_url:
                          type: string
                          nullable: true
                          description: >-
                            URL to a guide page with authentication setup
                            instructions for this toolkit
                          example: https://composio.dev/auth/github
                        deprecated:
                          $ref: '#/components/schemas/DeprecatedToolkitInfo'
                        meta:
                          type: object
                          properties:
                            created_at:
                              type: string
                              description: Creation date and time of the toolkit
                              example: '2023-01-15T09:30:00.000Z'
                            updated_at:
                              type: string
                              description: Last modification date and time of the toolkit
                              example: '2023-05-20T14:45:00.000Z'
                            description:
                              type: string
                              description: >-
                                Human-readable description explaining the
                                toolkit's purpose and functionality
                              example: >-
                                Integrate with GitHub repositories, issues, pull
                                requests, and more.
                            logo:
                              type: string
                              description: Image URL for the toolkit's branding
                              example: https://assets.composio.dev/logos/github.png
                            app_url:
                              type: string
                              nullable: true
                              description: >-
                                Link to the toolkit's main application or
                                service website
                              example: https://github.com
                            categories:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    description: Category identifier
                                    example: developer-tools
                                  name:
                                    type: string
                                    description: Human-readable category name
                                    example: Developer Tools
                                required:
                                  - id
                                  - name
                              description: List of categories associated with this toolkit
                              example:
                                - id: developer-tools
                                  name: Developer Tools
                                - id: productivity
                                  name: Productivity
                            triggers_count:
                              type: number
                              description: Count of available triggers in this toolkit
                              example: 5
                            tools_count:
                              type: number
                              description: Count of available tools in this toolkit
                              example: 12
                            version:
                              type: string
                              description: Version of the toolkit
                              example: 20250905_00
                          required:
                            - created_at
                            - updated_at
                            - description
                            - logo
                            - categories
                            - triggers_count
                            - tools_count
                            - version
                          description: Additional metadata about the toolkit
                      required:
                        - slug
                        - name
                        - type
                        - is_local_toolkit
                        - deprecated
                        - meta
                      description: Detailed information about a toolkit
                  next_cursor:
                    type: string
                    nullable: true
                  total_pages:
                    type: number
                  current_page:
                    type: number
                  total_items:
                    type: number
                required:
                  - items
                  - total_pages
                  - current_page
                  - total_items
        '400':
          description: >-
            Bad request. The query parameters may be invalid or in an incorrect
            format.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: >-
            Unauthorized. Authentication is required or the provided credentials
            are invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found. The toolkits you are looking for do not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: >-
            Too many requests. The upstream service is rate limiting the
            request; retry after a short backoff.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: >-
            Internal server error. An unexpected error occurred while processing
            the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    DeprecatedToolkitInfo:
      type: object
      properties:
        toolkitId:
          type: string
      required:
        - toolkitId
      description: Deprecated toolkit ID
      deprecated: true
      example:
        toolkitId: 550e8400-e29b-41d4-a716-446655440000
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: number
            slug:
              type: string
            status:
              type: number
            request_id:
              type: string
            suggested_fix:
              type: string
            errors:
              type: array
              items:
                type: string
          required:
            - message
            - code
            - slug
            - status
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your Composio project API key. Create or copy it from the Composio
        dashboard.
      x-default: your-project-api-key

````