> ## 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 version history

> Returns the most recent 20 artifact versions for a design, with their
artifact IDs, labels, and titles. Use `?skip=N` to paginate backwards.
Page size is fixed at 20.

Each version corresponds to a snapshot of the design's code at a point
in time. Use the returned `artifactId` with the artifact read/write
endpoints, or fork from it with `POST /v3/designs/{editorId}/artifacts`.




## OpenAPI

````yaml openapi-v3.yml get /v3/designs/{editorId}/versions
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/designs/{editorId}/versions:
    get:
      tags:
        - Designs
      summary: List version history
      description: |
        Returns the most recent 20 artifact versions for a design, with their
        artifact IDs, labels, and titles. Use `?skip=N` to paginate backwards.
        Page size is fixed at 20.

        Each version corresponds to a snapshot of the design's code at a point
        in time. Use the returned `artifactId` with the artifact read/write
        endpoints, or fork from it with `POST /v3/designs/{editorId}/artifacts`.
      operationId: getDesignVersionsV3
      parameters:
        - $ref: '#/components/parameters/EditorId'
        - $ref: '#/components/parameters/Skip'
      responses:
        '200':
          description: Paginated version history.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VersionHistoryPage'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    EditorId:
      name: editorId
      in: path
      required: true
      description: The design's editor ID.
      schema:
        type: string
        example: abc123
    Skip:
      name: skip
      in: query
      required: false
      description: Number of most-recent items to skip (for pagination). Defaults to 0.
      schema:
        type: integer
        minimum: 0
        default: 0
  schemas:
    VersionHistoryPage:
      type: object
      properties:
        versions:
          type: array
          items:
            $ref: '#/components/schemas/VersionHistoryItem'
        hasMore:
          type: boolean
    VersionHistoryItem:
      type: object
      properties:
        artifactId:
          type: string
        versionLabel:
          type: string
          example: v3
        title:
          type: string
          example: Onboarding redesign
        timeCreated:
          type: integer
          nullable: true
          description: Milliseconds since the Unix epoch.
    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'
    Forbidden:
      description: The caller does not have access to this resource.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: The requested design or artifact does not exist.
      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.

````