---
title: "Upload an image"
method: POST
path: "/v1/uploads/images.json"
tags: ["Uploads"]
---

# Upload an image

`POST /v1/uploads/images.json`

Upload an image

## Request body

- union
  - UploadImageFromUrl
    - `file_name` string, required
    - `url` string, uri, required
  - UploadImageFromContents
    - `file_name` string, required
    - `contents` string, required — Base64-encoded image content

## Response `200`

Successful operation

- Upload
  - `id` string
  - `file_name` string
  - `height` integer
  - `width` integer
  - `size` integer
  - `mime_type` string
  - `preview_url` string, uri
  - `upload_time` string

## Other responses

- `400` — Error response

---

[API](https://skmtc.net/printify/apis/printify-public-api.md) · [All operations](https://skmtc.net/printify/apis/printify-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/printify/printify-public-api/revisions/376214ac98ff/schema)