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

# List design systems

> Returns every design system accessible to the authenticated user —
both built-in (reserved) systems (e.g. Base, Shadcn, MUI) and any
custom systems the user owns or has been invited to.

Use the returned `id` as the `designSystemId` parameter when creating
new designs.




## OpenAPI

````yaml openapi-v3.yml get /v3/design-systems
openapi: 3.0.3
info:
  title: Magic Patterns API (v3)
  version: 3.0.0
  description: |
    The Magic Patterns API v3 provides programmatic access to design generation,
    iteration, and code-level editing. v3 mirrors the surface of the Magic
    Patterns MCP server — a single key authenticates both transports.

    v3 bills against your normal Magic Patterns credit balance. There is no
    separate API subscription. Free tier users can call v3 up to their credit
    limit, identical to web and MCP usage.

    For the legacy v2 single-shot creation endpoint (separate $99/mo plan),
    see the v2 reference.
servers:
  - url: https://api.magicpatterns.com/api
security:
  - ApiKeyAuth: []
tags:
  - name: Health
  - name: Design Systems
  - name: Designs
  - name: Artifacts
paths:
  /v3/design-systems:
    get:
      tags:
        - Design Systems
      summary: List design systems
      description: |
        Returns every design system accessible to the authenticated user —
        both built-in (reserved) systems (e.g. Base, Shadcn, MUI) and any
        custom systems the user owns or has been invited to.

        Use the returned `id` as the `designSystemId` parameter when creating
        new designs.
      operationId: listDesignSystemsV3
      responses:
        '200':
          description: List of accessible design systems.
          content:
            application/json:
              schema:
                type: object
                properties:
                  designSystems:
                    type: array
                    items:
                      $ref: '#/components/schemas/DesignSystem'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    DesignSystem:
      type: object
      properties:
        id:
          type: string
          description: Pass this as `designSystemId` when creating a design.
          example: ds-9b80b54e-92b3-4b2f-8265-afe466ee8b75
        name:
          type: string
          example: Shadcn
        isReserved:
          type: boolean
          description: True for built-in design systems (Base, Shadcn, MUI, etc).
        isActive:
          type: boolean
          description: True for the user's currently selected default design system.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message.
          example: You do not have access to this resource.
  responses:
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-mp-api-key
      description: >
        Magic Patterns API key. The same key authenticates v3 REST and the

        MCP server. Create one at
        https://www.magicpatterns.com/settings/api-keys.

````