---
title: "FileUpload"
description: "Where and how to send the file: one `PUT` of its bytes to `uploadUrl`, with the same `Content-Type`, before `expiresAt`."
canonical: "https://docs.printags.com/schemas/fileupload/"
last_updated: "2026-11-16"
---

# FileUpload

Where and how to send the file: one `PUT` of its bytes to `uploadUrl`, with the same `Content-Type`, before `expiresAt`. The URL needs no Authorization header: give it to the browser that holds the file.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `uploadUrl` | string (uri) | no | `https://api.printags.com/v2/uploads/<token>` (`https://sandbox-api.printags.com/...` when asked on the sandbox host). The token is signed, bound to the account and to the key's mode (test or live), valid 15 minutes and good for one file. Treat it as a secret until it is used. |
| `method` | string: `PUT` | no |  |
| `contentType` | string: `image/png`, `image/jpeg`, `application/pdf` | no |  |
| `maxBytes` | integer | no | The largest file the URL takes (25 MB) |
| `expiresAt` | string (date-time) | no |  |

## Example

```json
{
  "uploadUrl": "https://api.printags.com/v2/uploads/eyJhIjoiN2IxZTJhNGMifQ.c2lnbmF0dXJl",
  "method": "PUT",
  "contentType": "image/png",
  "maxBytes": 26214400,
  "expiresAt": "2026-11-10T13:15:00.000Z"
}
```
