---
title: "Upload an entity logo"
method: PUT
path: "/entities/{entity_id}/logo"
tags: ["Entities"]
---

# Upload an entity logo

`PUT /entities/{entity_id}/logo`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/entities/{entity_id}/logo`
- Auth: HTTP bearer

Entity logo can be PNG, JPG, or GIF, up to 10 MB in size. The logo is used, for example, in PDF documents created by this entity.

## Path parameters

- `entity_id` string, required

## Headers

- `x-monite-version` string, required

## Request body `multipart/form-data`

- object
  - `file` string, binary, required

## Response `200`

Successful Response

- FileSchema2: Represents a file (such as a PDF invoice) that was uploaded to Monite.
  - `id` string, uuid, required: A unique ID of this file.
  - `created_at` string, date-time, required: UTC date and time when this file was uploaded to Monite. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `file_type` string, required: The type of the business object associated with this file.
  - `md5` string, required: The MD5 hash of the file.
  - `mimetype` string, required: The file's [media type](https://developer.mozilla.org/en-US/docs/Web/HTTP/MIME_types).
  - `name` string, required: The original file name (if available).
  - `pages` PageSchema[]: If the file is a PDF document, this property contains individual pages extracted from the file. Otherwise, an empty array.
    - `id` string, uuid, required: A unique ID of the image.
    - `mimetype` string, required: The [media type](https://developer.mozilla.org/en-US/docs/Web/HTTP/MIME_types) of the image.
    - `number` integer, required: The page number in the PDF document, from 0.
    - `size` integer, required: Image file size, in bytes.
    - `url` string, required: The URL to download the image.
  - `previews` PreviewSchema[]: Preview images generated for this file. There can be multiple images with different sizes.
    - `height` integer, required: The image height in pixels.
    - `url` string, required: The image URL.
    - `width` integer, required: The image width in pixels.
  - `region` string, required: Geographical region of the data center where the file is stored.
  - `size` integer, required: The file size in bytes.
  - `url` string, required: The URL to download the file.

## Other responses

- `400`: Bad Request
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/monite/apis/monite-3.md) - [All operations](https://skmtc.dev/monite/apis/monite-3/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-3/revisions/c13be6f83ce9?raw)