Upload a file
Upload a file to attach elsewhere by id. Send multipart/form-data with a file part and a purpose. identity_document uploads are an owner’s passport or government ID: attach one to a document requirement (document on fulfill) or directly at company create (shareholders[].passport). additional_document uploads answer a form’s file field: pass the file id as that field’s value on fulfill. Uploads are single-use and write-only - the response carries no download URL and the contents can never be read back through the API. PDF, JPEG or PNG, 10MB max, and images at most 8000px per side. Content is verified against the declared type.
Authorizations
Your API key, e.g. Authorization: Bearer clmt_test_. Live keys use the clmt_live_ prefix.
Body
Response
The uploaded file.
A file: either a document Clemta published on one of your companies (source: operations - Articles, an EIN letter, a filed form - download the bytes from the content endpoint) or one you uploaded (source: upload - write-only, attach it by id). Nothing about storage is ever exposed - no URLs, no keys. Uploaded contents cannot be read back.
Entity name.
file ^file_[0-9A-Za-z]{22}$"file_0346sFPEvSkJvY8vt14NNw"
The document's filename, extension included.
"Articles_of_Incorporation.pdf"
The company this document belongs to. Absent on an upload not yet attached.
^cmp_[0-9A-Za-z]{22}$"application/pdf"
Size in bytes, when known.
What an uploaded file is for. Absent on documents Clemta published.
identity_document, formation_document, additional_document, tax_form_1099, business_logo, business_icon Who put the file here. operations - a deliverable we published, its bytes downloadable from the content endpoint. upload - you sent it (POST /v1/files), write-only: reference it by id, its contents can never be read back.
operations, upload Where the file's contents can be downloaded, with your API key. Present only when the purpose allows downloading - Clemta-published deliverables, never your own uploads.
True once an upload has been attached. Uploads are single-use.