Upload a file

One file, multipart/form-data, field name file. The only route on this surface that is not JSON.

It answers an id. That id is what POST /company/v3/documents/upsert takes as file_id; until a document claims it the file belongs to nothing.

Up to 10 MB. pdf, doc, docx, xls, xlsx, jpg, jpeg, png — the content is checked, not just the extension. name is optional and defaults to the uploaded filename without its extension.

url is signed and short-lived: read it, do not store it. Read the document again to get a fresh one.