---
title: "Upload an image and get back a stable URL the editor can drop into <img src>."
method: POST
path: "/v1/documents/images/upload"
tags: ["v1", "documents"]
---

# Upload an image and get back a stable URL the editor can drop into <img src>.

`POST /v1/documents/images/upload`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/documents/images/upload`
- Auth: HTTP bearer

Upload a single inline image and return a URL you can reference
in the document via <img src="...">.

Accepts PNG/JPEG/WebP/GIF/SVG, up to 10 MB per upload. The returned `url`
is a time-limited signed link (image storage is private; images are always
served via signed URLs) that renders immediately in the editor; on save the
backend normalizes it to the stable canonical reference, and every
subsequent read re-signs it fresh. `canonical_url` is that stable stored
form. Useful for saving a drawing or screenshot so a document can embed it.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/superdocs/apis/universal-document-ai-api.md) · [All operations](https://skmtc.dev/superdocs/apis/universal-document-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superdocs/apis/universal-document-ai-api/revisions/37d03122940b?raw)