Skip to main content
POST
Upload a document
Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.
Its file_id links it to an expense, an income or a case as evidence.

Authorizations

Authorization
string
header
required

Your partner secret key, mk_live_… for real companies or mk_test_… for test companies. Keep it on your servers. See Authentication.

Path Parameters

company_id
string<uuid>
required

The company's ID. Every company-scoped call works in exactly this company.

Body

multipart/form-data
file
file
required
category
enum<string>
Available options:
expenses,
contracts,
receipts

Response

The stored document.

id
string
required
file_id
string<uuid>
required

The ID to use as file_id on an expense, an income or a case.

filename
string
required
content_type
string
required
size_bytes
integer
required
created_at
string<date-time>
required
category
enum<string>
Available options:
expenses,
contracts,
receipts,
all