Uploads
Upload the customer's car photo once, then use it for as many renders as you like: three wheels on the same car is one upload and three renders.
Upload a car photo#
POST /v1/uploads, as multipart/form-data with one field, file.
curl https://app.viztunr.com/api/v1/uploads \
-H "Authorization: Bearer $VIZTUNR_KEY" \
-F file=@customer-car.jpg
- JPEG, PNG, WebP, HEIC, or HEIF, up to 10 MB.
- Send the right content type for the file part; curl does this for you from the file name.
- Uploads are free. Only renders use your balance.
- One clear photo of the whole car works best, ideally a three-quarter angle in good light.
Response, 201 Created:
{
"id": "upl_269c9fcbc7154983b2124958d8e4c58e",
"url": "https://api.viztunr.com/storage/v1/object/public/shop-uploads/.../269c9fcb.jpg",
"content_type": "image/jpeg",
"size_bytes": 719808,
"created_at": "2026-11-14T07:35:36Z"
}
| Field | What it is |
|---|---|
id | Pass it as upload when you start a render |
url | Where the photo is stored, for showing a "before" image |
content_type, size_bytes | As received |
Uploads are kept until you delete them.
Errors#
| Code | Status | Why |
|---|---|---|
parameter_missing | 400 | The body has no file field, or isn't multipart |
file_too_large | 413 | The file is over 10 MB |
unsupported_image_type | 422 | Not JPEG, PNG, WebP, HEIC, or HEIF |
Delete an upload#
DELETE /v1/uploads/:id removes the car photo. Renders already made from it keep their result image.
curl -X DELETE https://app.viztunr.com/api/v1/uploads/upl_269c9fcbc7154983b2124958d8e4c58e \
-H "Authorization: Bearer $VIZTUNR_KEY"
Answers 204 No Content, or 404 with code upload_not_found if it doesn't exist or belongs to another shop. When a customer asks you to delete their data, delete their uploads and their renders.