Skip to main content
The Documents API lets you create and store PDF documents in your Lumin Workspace, and run PDF operations such as merge, compress, split, password protection, summarization, and translation.

​
Key concepts

  • Document — a file stored in a Lumin Workspace. Once created, it can be viewed, shared, annotated, or used in other workflows.
  • Upload (file-upload method) — import an existing file by providing a file URL or uploading directly via multipart form data.
  • Template (template method) — generate a PDF by filling in fields from a PDF template (pdf_ prefix templates).
  • Location — where the document is saved: the Workspace’s shared document list, a specific Space, or the user’s Personal document list. You can optionally specify a folder.
  • PDF operations — process documents by Lumin document ID or publicly accessible file URL. Most operations return a temporary signed_url that expires after 30 minutes. To persist results, download the file and re-upload via Upload Document.

​
Supported file formats

PDF, DOCX, XLSX, PPTX, DOC, XLS, PNG, JPEG/JPG

​
File size limits

PlanMax size
Free20 MB
Paid200 MB

​
Create documents

Upload Document

Import and save a document from a file URL or direct file upload.

Create Document from Template

Create and save a PDF document from a PDF template.

​
PDF operations

Merge Documents

Combine 2–20 PDF or image files into a single PDF.

Compress Document

Reduce PDF file size with standard or maximum compression.

Split Document

Extract page ranges or split a PDF into equal-sized parts.

Add Password

Add or change password protection on a PDF.

Remove Password

Remove password protection from a PDF.

Summarize Document

Generate an AI-powered summary of a PDF’s text content.

Translate Document

Translate a PDF into a target language while preserving layout.