Zum Hauptinhalt springen

Upload Document

POST 
/documents

Upload a document to the project associated with the API key.

The document will be uploaded to the project that the API key belongs to. Maximum file size allowed is 100MB.

Supported file types:

  • PDF: .pdf
  • Word: .doc, .docx
  • Excel: .xls, .xlsx
  • Images: .png, .jpg, .bmp
  • TIFF: .tif, .tiff (single- or multi-page — converted to PDF on upload)
  • Emails: .eml, .msg
  • XML: only structured CII-syntax e-invoices (XRechnung-CII / ZUGFeRD 2.x / Factur-X). UBL-syntax invoices, legacy ZUGFeRD 1.0 standalone XML, and any other XML are rejected with 400 Unsupported file type.

Parameters:

  • file: The file to upload (multipart/form-data)
  • description: Optional description of the document
  • folder_path: Optional folder path within the project (/ as separator, max 255 chars per segment)
  • metadata: Optional JSON metadata (key-value pairs)

Filename requirements:

  • Maximum 255 characters (longer names are truncated automatically).
  • Path separators and directory components are stripped automatically.
  • Returns 400 Invalid Filename if the name is empty after validation.

Request​

Responses​

Document uploaded successfully