---
title: "Upload an image (raw bytes; SHA-256 + dimensions in X-Image-* headers)."
method: POST
path: "/images"
tags: ["Images"]
---

# Upload an image (raw bytes; SHA-256 + dimensions in X-Image-\* headers).

`POST /images`

## Request

- Base URL: `https://www.livediagram.app/api`
- URL: `https://www.livediagram.app/api/images`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Owner-Id`

## Response `200`

Success.

- object
  - `image` ImageSummary, required
    - `byteSize` number, required
    - `contentType` string, required
    - `createdAt` number, required
    - `height` number, required
    - `id` string, required
    - `originalName` string
    - `width` number, required
  - `deduped` boolean, required

## Other responses

- `400`: Error.
- `401`: Error.
- `403`: Error.
- `409`: Error.
- `413`: Error.
- `415`: Error.
- `429`: Rate limited. Back off and retry.
- `503`: Error.

---

[API](https://skmtc.dev/livediagram/apis/livediagram-api.md) · [All operations](https://skmtc.dev/livediagram/apis/livediagram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livediagram/apis/livediagram-api/revisions/f286d27acfd2?raw)