Docs

POST /v1/convert

Use POST /v1/convert for Word, Excel, PowerPoint, and other Office files, or when you need LibreOffice or wkhtmltopdf instead of Chromium. Do not send .docx through POST /v1/pdf, and do not merge PDFs here — that is POST /v1/pdf/merge.

Provide exactly one of html, url, or file. file requires sourceFilename with an extension. This is the Office/wkhtml path — do not overload /v1/pdf with .docx or merge jobs.

Targets and engines

to: pdf (default), docx, xlsx, html, png. engine: libreoffice (default) or wkhtmltopdf.

  • LibreOffice handles Office files and HTML/URL conversion to the listed targets
  • wkhtmltopdf only supports html or url to pdf, and can set options.toc
  • 503 convert_unavailable means the document worker is cold or unreachable — not billed

Example

Excel to PDF. file is base64 (optional data URI).

POST /v1/convert
{
  "file": "UEsDB...",
  "sourceFilename": "quarterly.xlsx",
  "to": "pdf"
}