v1
mcp

Upload a base64-encoded image and get back a stable URL to embed in a document via <img src>.

Upload an image (base64-encoded) and get a stable URL to reference in a document via <img src="...">.

Accepts PNG/JPEG/WebP/GIF/SVG, up to 10 MB decoded. Send raw base64 or a data: URL in image_base64. This is the agent-friendly counterpart to the browser multipart upload — use it to save a generated or fetched image so a document can embed it.

Embed the returned url (the stable canonical reference — it never expires and every document read serves it as a fresh time-limited signed link). view_url is such a signed link for immediately viewing/downloading the image outside a document; it expires, so never embed it.

post/v1/documents/images/upload-base64

Request

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

Headers

authorizationstring nullable

Request body

image_base64string required

The image bytes, base64-encoded (raw base64 or a data: URL).

filenamestring nullable

Optional original filename (used only to infer content type).

content_typestring nullable

Optional MIME type, e.g. image/png. Defaults to image/png.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.