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

# List available 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.



## OpenAPI

````yaml /api-reference/openapi-v3.json get /api/v3/toolkits
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:
    get:
      tags:
        - Toolkits
      summary: List available 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.
      operationId: getToolkits
      parameters:
        - schema:
            type: string
            description: Category ID or name to filter toolkits by
            example: productivity
          required: false
          description: Filter toolkits by category
          name: category
          in: query
        - schema:
            type: string
            enum:
              - composio
              - all
              - project
            description: 'Deprecated: Entity responsible for managing the toolkits'
            deprecated: true
          required: false
          description: 'Deprecated: Filter toolkits by who manages them'
          deprecated: true
          name: managed_by
          in: query
        - schema:
            type: string
            enum:
              - native
              - custom
              - all
            description: >-
              Filter by toolkit provenance: "native" (Composio-managed),
              "custom" (project-registered custom toolkits), or "all". Takes
              precedence over managed_by when both are supplied.
            example: custom
          required: false
          description: Filter toolkits by provenance (alias over managed_by)
          name: type
          in: query
        - schema:
            type: string
            enum:
              - usage
              - alphabetically
            description: Determines how toolkits should be sorted in the response
          required: false
          description: Sort order for returned toolkits
          name: sort_by
          in: query
        - schema:
            type: boolean
            nullable: true
            default: false
            description: Include deprecated toolkits in the response
            example: true
          required: false
          description: Include deprecated toolkits in the response
          name: include_deprecated
          in: query
        - schema:
            type: string
            description: >-
              Search query to filter toolkits by name, slug, or description
              (minimum 1 character)
            example: gmail
          required: false
          description: Search query to filter toolkits by name, slug, or description
          name: search
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 256
            description: >-
              [EXPERIMENTAL] List the custom toolkits this user can use. Without
              it, only custom toolkits with access "all" are listed.
            example: user_123
            x-experimental: true
          required: false
          description: >-
            [EXPERIMENTAL] List the custom toolkits this user can use. Without
            it, only custom toolkits with access "all" are listed.
          name: user_id
          in: query
        - schema:
            type: number
            nullable: true
          required: false
          description: Number of items per page, max allowed is 1000
          name: limit
          in: query
        - schema:
            type: string
          required: false
          description: >-
            Cursor for pagination. The cursor is a base64 encoded string of the
            page and limit. The page is the page number and the limit is the
            number of items per page. The cursor is used to paginate through the
            items. The cursor is not required for the first page.
          name: cursor
          in: query
      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: []
        - UserApiKeyAuth: []
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
    UserApiKeyAuth:
      type: apiKey
      in: header
      name: x-user-api-key
      description: Your Composio user API key for user-scoped endpoints.
      x-default: your-user-api-key

````