Skip to main content
PUT
/
entities
/
{entity_id}
/
logo
Upload an entity logo
curl --request PUT \
  --url https://api.sandbox.monite.com/v1/entities/{entity_id}/logo \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-monite-version: <x-monite-version>' \
  --form file='@example-file'
{
  "id": "753fbb53-2347-4f47-9bbe-21c9b68b81a1",
  "created_at": "2025-03-11T13:13:24.841010Z",
  "file_type": "entity-logo",
  "name": "logo.png",
  "region": "eu-central-1",
  "md5": "07098e3581e0d599c15121f5634ea124",
  "mimetype": "image/png",
  "url": "https://bucketname.amazonaws.com/path/to/logo-image.png",
  "size": 63643,
  "previews": [],
  "pages": []
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-monite-version
string<date>
required

Path Parameters

​
entity_id
string<uuid>
required

A unique ID to specify the entity.

Example:

"ea837e28-509b-4b6a-a600-d54b6aa0b1f5"

Body

multipart/form-data
​
file
file
required

Response

Successful Response

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

​
file_type
string
required

The type of the business object associated with this file.

Example:

"payables"

​
md5
string
required

The MD5 hash of the file.

Example:

"31d1a2dd1ad3dfc39be849d70a68dac0"

​
mimetype
string
required

The file's media type.

Example:

"application/pdf"

​
name
string
required

The original file name (if available).

Maximum string length: 512
Example:

"invoice.pdf"

​
region
string
required

Geographical region of the data center where the file is stored.

Example:

"eu-central-1"

​
size
integer
required

The file size in bytes.

Required range: x >= 0
Example:

24381

​
url
string
required

The URL to download the file.

Example:

"https://bucketname.s3.amazonaws.com/12345/67890.pdf"

​
pages
object[] | null

If the file is a PDF document, this property contains individual pages extracted from the file. Otherwise, an empty array.

​
previews
object[] | null

Preview images generated for this file. There can be multiple images with different sizes.