---
title: "Upload a visual to a signed URL"
description: "The `uploadUrl` of `createFileUpload`: send the file's bytes as the body, with its `Content-Type`."
canonical: "https://docs.printags.com/upload-a-visual-to-a-signed-url/"
last_updated: "2026-11-16"
---

# Upload a visual to a signed URL

`PUT /v2/uploads/{token}`

The `uploadUrl` of `createFileUpload`: send the file's bytes as the body, with its `Content-Type`. No Authorization header: the token stands in for it. Callable from a browser on any origin (CORS, with its preflight). The content must match the type announced when the URL was made. Limited per IP address (`RATE_LIMITED`, with `Retry-After`).

## Authentication

None: this route answers without an API key.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `token` | path | string | yes | The signed token, as `uploadUrl` holds it |

## Request body

Content type: `image/png`, required.

## Responses

| Status | Description |
| --- | --- |
| 201 | The file is stored |
| 400 | Empty body (`EMPTY_BODY`), or content that is not the announced type (`CONTENT_TYPE_MISMATCH`) |
| 401 | Forged or expired token, or one made for another use (`INVALID_UPLOAD_TOKEN`) |
| 403 | A live URL used on the sandbox host (`SANDBOX_REQUIRES_TEST_KEY`) |
| 409 | The URL already stored its file (`UPLOAD_LINK_USED`): ask for a new one |
| 413 | Over 25 MB (`FILE_TOO_LARGE`) |
| 422 | A PDF that cannot be prepared for print (`INVALID_FILE`) |
| 429 | Too many uploads from this address (`RATE_LIMITED`) |
| 500 | Internal server error (`UPLOAD_FAILED`) |

### 201 response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no |  |
| `file` | [UploadedFile](/schemas/uploadedfile/) | no |  |

```json
{
  "success": true,
  "file": {
    "fileId": "f0000000-0000-4000-8000-000000000009",
    "name": "recto.png",
    "size": 182044,
    "contentType": "image/png"
  }
}
```

## Example

```bash
curl -X PUT "https://api.printags.com/v2/uploads/{token}"
```
