---
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.

Both partner tokens and entity user tokens can be used for authentication. Entity users must have a role with the `entity.update` permission.

## 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
- `401`: The `Authorization` header is missing or contains an invalid or expired access token. See [Authentication](https://docs.monite.com/api/concepts/authentication) to learn how to authenticate API calls.
- `422`: Validation Error
- `429`: API rate limit has been exceeded. Check the response headers for the rate limit information.

---

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