---
title: "Uploads an image encoded in base64 to the specified storage bucket."
method: POST
path: "/api/v1/uploadImage"
tags: ["Image"]
---

# Uploads an image encoded in base64 to the specified storage bucket.

`POST /api/v1/uploadImage`

## Request body

- object
  - `base64` string, byte — The base64-encoded image
  - `name` string — Optional name prefix for the uploaded image, limited to 100 characters

## Response `201`

Image uploaded successfully

- object
  - `url` string — The signed URL of the uploaded image

## Other responses

- `400` — Bad Request. Reasons might include no base64 string provided, name length exceeding 100 characters, or base64 size exceeding 10MB.
- `500` — Internal Server Error

## Changes

- **2026-07-13** `f44af6e313d8` — 1 info
  - endpoint added
- **2023-08-17** `f61c9ac97a45` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hero-page/apis/hero-api/changes/api/v1/uploadImage/post.md)

---

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