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

# Upload mockup

> Upload an image or PDF as a mockup.

Uploads a new mockup file (image or PDF) to a project. Supports direct file uploads and Figma imports.

## Request body (multipart/form-data)

<ParamField body="project_id" type="string" required>
  UUID of the project.
</ParamField>

<ParamField body="file" type="file" required>
  The image (PNG, JPG, GIF, WebP) or PDF file to upload. Max 50MB.
</ParamField>

<ParamField body="name" type="string">
  Display name for the mockup. Defaults to the filename.
</ParamField>

<ParamField body="base_mockup_id" type="string">
  UUID of an existing mockup to add this as a new version of.
</ParamField>

<ResponseExample>
  ```json 201 theme={null}
  {
    "success": true,
    "data": {
      "id": "110e8400-e29b-41d4-a716-44665544000b",
      "name": "Homepage v2",
      "file_type": "image",
      "file_url": "https://storage.surefeedback.com/mockups/...",
      "project_id": "770e8400-e29b-41d4-a716-446655440002",
      "created_at": "2026-03-02T12:00:00Z"
    }
  }
  ```
</ResponseExample>