---
title: "Create email image upload URL"
method: POST
path: "/media/upload-url"
tags: ["Media"]
---

# Create email image upload URL

`POST /media/upload-url`

Returns an authenticated API URL for a block-ready email image. PUT the exact bytes to uploadUrl using the same API credentials, then register the key with POST /media/complete-upload. The public object does not exist until its bytes pass server-side validation.

## Request body

- object
  - `filename` string, required
  - `contentType` string, required
  - `fileSizeBytes` integer, required

## Response `200`

Upload URL created

- object
  - `success` boolean
  - `uploadUrl` string
  - `publicUrl` string
  - `key` string
  - `fileName` string

## Other responses

- `400` — Unsupported image type or size
- `401` — Unauthorized
- `503` — Uploads not configured

## Changes

- **2026-08-02** `36f92fc0caa2` — 3 breaking
  - the response property `success` became optional for the status `400`
  - the response property `success` became optional for the status `401`
  - the response property `success` became optional for the status `503`
- **2026-07-15** `8bc13491b9f6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/media/upload-url/post.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/36f92fc0caa2/schema)