---
title: "Upload Email Signature Asset"
method: POST
path: "/v1/email-signatures/assets"
tags: ["email-signatures"]
---

# Upload Email Signature Asset

`POST /v1/email-signatures/assets`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v1/email-signatures/assets`
- Auth: HTTP bearer

Store an image for the signature body to reference.

Returns the absolute URL to put in an `<img src>`; the image itself is served
unauthenticated from `/v2/public/signature-assets/{token}`, because the
recipient's mail client has no session.

## Headers

- `mentium-workspace-id` string, nullable

## Request body `multipart/form-data`

- BodyUploadEmailSignatureAssetV1EmailSignaturesAssetsPost
  - `file` string, binary, required

## Response `201`

Successful Response

- EmailSignatureAssetSchema: An image the signature body can reference. ``src`` is the object's own public URL, built from ``S3_ENDPOINT`` and ``S3_BUCKET_EMAIL_SIGNATURE_ASSETS``. It goes straight into the body's ``<img src>``: the recipient's mail client fetches it from S3, never from us.
  - `id` string, uuid, required
  - `file_name` string, required
  - `size_bytes` integer, required
  - `src` string, required
  - `created_at` string, date-time, required

## Other responses

- `404`: Not found
- `422`: Validation Error

---

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