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

# Queue an HTML page clone

> Requires page.create. Creates a pending HTML page and its link, then queues cloning of an HTTP(S) source URL. HTTP 202 means accepted, not completed. Poll the page payload cloneStatus to observe processing, ready or failed. Returns 503 when the clone worker is unavailable.



## OpenAPI

````yaml https://api.trackup.me/openapi.json post /v1/projects/{id}/pages/clone
openapi: 3.1.0
info:
  title: Trackup API
  description: >-
    API-key-accessible Trackup operations. Send your key in the `X-Api-Key`
    header.


    Keys belong to a team. `X-Team-Id` is not required; if supplied, it must
    match that team.


    Each operation lists its required key permission. The key creator must
    remain a team member and normally hold that permission. The ingest-only
    permissions `visitor.create`, `conversion.create`, and `request.create` do
    not need to be held by the creator.


    Project access and selection are described per operation. Session-only
    account, administration and OAuth operations are not part of this reference.


    The same operations are available as MCP tools at `/mcp` (Streamable HTTP).
    Authenticate with `X-Api-Key` or connect through OAuth, which issues an API
    key on consent.


    Schema validation errors return HTTP 422 with an `errors` object. Other
    errors generally contain `error` and `message`; operation-specific responses
    describe exceptions.
  version: 1.0.0
servers:
  - url: /
    description: Current API environment
security:
  - ApiKey: []
paths:
  /v1/projects/{id}/pages/clone:
    post:
      tags:
        - Pages
      summary: Queue an HTML page clone
      description: >-
        Requires page.create. Creates a pending HTML page and its link, then
        queues cloning of an HTTP(S) source URL. HTTP 202 means accepted, not
        completed. Poll the page payload cloneStatus to observe processing,
        ready or failed. Returns 503 when the clone worker is unavailable.
      operationId: clonePage
      parameters:
        - in: path
          name: id
          schema:
            type: string
            format: uuid
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 255
                sourceUrl:
                  type: string
                  format: uri
                purpose:
                  type: string
                  enum:
                    - landing
                    - checkout
                  default: landing
                pathname:
                  type: string
                  pattern: ^\/?[a-zA-Z0-9\-._~/]+$
                  minLength: 1
                  maxLength: 1024
                salesPlatformId:
                  type: string
                  format: uuid
              required:
                - name
                - sourceUrl
      responses:
        '202':
          description: Page created and clone queued with cloneStatus=pending.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueuedPageClone'
        '400':
          description: Malformed request or an invalid operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '401':
          description: The X-Api-Key header is missing or the API key is invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '403':
          description: >-
            The key is expired, revoked, lacks permission, or its creator no
            longer has the required team access. A conflicting X-Team-Id is also
            rejected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: >-
            The requested resource was not found or is outside the permitted
            scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '409':
          description: The operation conflicts with existing data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '422':
          description: >-
            Invalid input. Each field path maps to its first validation message;
            _form identifies an object-level error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '500':
          description: An unexpected error occurred.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '503':
          description: The required service or worker is unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    QueuedPageClone:
      allOf:
        - $ref: '#/components/schemas/CreatedPage'
      properties:
        cloneStatus:
          type: string
          const: pending
        sourceUrl:
          type: string
      required:
        - cloneStatus
        - sourceUrl
      example:
        id: 33333333-3333-4333-8333-333333333333
        name: Autumn offer
        type: html
        createdAt: '2026-10-26T12:00:00.000Z'
        projectId: 11111111-1111-4111-8111-111111111111
        link:
          id: 99999999-9999-4999-8999-999999999999
          name: Autumn offer
          pathname: /autumn-offer
          type: generic
          urls:
            - id: aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa
              pageId: 33333333-3333-4333-8333-333333333333
              salesPlatformId: null
              name: Autumn offer
              weight: 1
              isActive: true
        cloneStatus: pending
        sourceUrl: https://shop.example.com/autumn
    ApiError:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
      required:
        - error
        - message
      additionalProperties: true
    ValidationError:
      type: object
      properties:
        errors:
          type: object
          additionalProperties:
            type: string
      required:
        - errors
    CreatedPage:
      type: object
      properties:
        id:
          type: string
          format: uuid
        projectId:
          type: string
          format: uuid
        name:
          type: string
        type:
          type: string
          enum:
            - redirect
            - builder
            - html
        createdAt:
          type: string
          format: date-time
        link:
          $ref: '#/components/schemas/PageLink'
      required:
        - id
        - projectId
        - name
        - type
        - createdAt
        - link
      example:
        id: 33333333-3333-4333-8333-333333333333
        name: Autumn offer
        type: redirect
        createdAt: '2026-10-26T12:00:00.000Z'
        projectId: 11111111-1111-4111-8111-111111111111
        link:
          id: 99999999-9999-4999-8999-999999999999
          name: Autumn offer
          pathname: /autumn-offer
          type: generic
          urls:
            - id: aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa
              pageId: 33333333-3333-4333-8333-333333333333
              salesPlatformId: null
              name: Autumn offer
              weight: 1
              isActive: true
    PageLink:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        pathname:
          type: string
        type:
          type: string
          enum:
            - generic
            - traffic_source
            - sales_platform
        urls:
          type: array
          items:
            $ref: '#/components/schemas/UrlVariant'
      required:
        - id
        - name
        - pathname
        - type
        - urls
      example:
        id: 99999999-9999-4999-8999-999999999999
        name: Autumn offer
        pathname: /autumn-offer
        type: generic
        urls:
          - id: aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa
            pageId: 33333333-3333-4333-8333-333333333333
            salesPlatformId: null
            name: Autumn offer
            weight: 1
            isActive: true
    UrlVariant:
      type: object
      properties:
        id:
          type: string
          format: uuid
        pageId:
          type: string
          format: uuid
        salesPlatformId:
          type:
            - string
            - 'null'
          format: uuid
        name:
          type: string
        weight:
          type: number
        isActive:
          type: boolean
      required:
        - id
        - pageId
        - salesPlatformId
        - name
        - weight
        - isActive
      example:
        id: 55555555-5555-4555-8555-555555555555
        pageId: 33333333-3333-4333-8333-333333333333
        salesPlatformId: null
        name: Landing A
        weight: 50
        isActive: true
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.