# Stirling PDF

> Merge, split, compress, rotate and convert PDFs with Stirling PDF, the open source PDF toolkit you run yourself. Make scans searchable, pull out text for an AI step, add watermarks, page numbers and passwords.

App · 14 actions. Web page: https://docs.lodol.com/docs/integrations/stirling-pdf

## Actions

### Add a password

Protect a PDF with a password it asks for when opened, and stop printing or copying if you like.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Password (`password`, text, required): The password the PDF asks for when it is opened.
- Restrict (`restrictions`, list): What people who open it can't do. Needs a Permissions password. Leave empty to restrict nothing. One or more of: `printing`, `copying` (Copying text and pictures), `editing` (Changing the content), `commenting` (Adding comments), `filling_forms` (Filling in forms), `assembling` (Adding, removing or turning pages).
- Permissions password (`permissions_password`, text): A second, different password that lifts the restrictions. Needed only when you choose something to restrict.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The password-protected PDF, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `needs_password_to_open` (true/false): Whether the PDF asks for its password to open.
- `page_count` (number): How many pages the PDF has.
- `restrictions` (list): What people who open it can't do without the permissions password, such as printing or copying.
- `size_bytes` (number): The file's size in bytes.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 1,
  "document_ref": "doc_c5d6e7f8c5d6e7f8c5d6e7f8c5d6e7f8",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_c5d6e7f8c5d6e7f8c5d6e7f8c5d6e7f8",
      "filename": "invoice-1001.pdf",
      "page_count": 3,
      "size_bytes": 2376
    }
  ],
  "filename": "invoice-1001.pdf",
  "needs_password_to_open": true,
  "page_count": 3,
  "restrictions": [
    "printing",
    "copying"
  ],
  "size_bytes": 2376
}
```

### Add a watermark

Put words such as DRAFT or CONFIDENTIAL across every page of a PDF.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Text (`text`, text, required): The words to put across the pages, such as DRAFT.
- Size (`size`, text): How large the words are. One of: `small`, `medium`, `large`. Default: `medium`.
- Colour (`colour`, text): The words' colour. One of: `grey`, `red`, `blue`, `green`, `black`. Default: `grey`.
- See-through (`opacity`, text): How much of the page shows through the words. One of: `faint`, `medium` (Half see-through), `solid`. Default: `faint`.
- Angle (`angle`, number): How far the words are tilted, in degrees: 0 is level, 45 runs up from the bottom left. From -360 to 360. Default: `45`.
- Make it hard to remove (`hard_to_remove`, true/false): Turn each page into a picture so the watermark can't be taken off. The text can no longer be selected or searched. Default: `false`.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The watermarked PDF, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `page_count` (number): How many pages the PDF has.
- `size_bytes` (number): The file's size in bytes.
- `watermark` (text): The words put across the pages.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 1,
  "document_ref": "doc_b4c5d6e7b4c5d6e7b4c5d6e7b4c5d6e7",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_b4c5d6e7b4c5d6e7b4c5d6e7b4c5d6e7",
      "filename": "invoice-1001.pdf",
      "page_count": 3,
      "size_bytes": 4459
    }
  ],
  "filename": "invoice-1001.pdf",
  "page_count": 3,
  "size_bytes": 4459,
  "watermark": "DRAFT"
}
```

### Add page numbers

Number the pages of a PDF, such as Page 2 of 5 at the foot of each page.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Position (`position`, text): Where on the page the number goes. One of: `bottom_centre` (Bottom, in the middle), `bottom_right` (Bottom right), `bottom_left` (Bottom left), `top_centre` (Top, in the middle), `top_right` (Top right), `top_left` (Top left). Default: `bottom_centre`.
- Format (`number_format`, text): The words around the number: {n} is the page's number and {total} how many pages there are, such as Page {n} of {total}. Leave empty for the number alone.
- Start at (`start_at`, number): The number the first numbered page gets. From 1 to 100000. Default: `1`.
- Pages (`pages`, text): Which pages get a number, such as 2-last to leave out a cover. Leave empty for every page.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The PDF made, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `page_count` (number): How many pages the PDF has.
- `size_bytes` (number): The file's size in bytes.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 1,
  "document_ref": "doc_0f1e2d3c0f1e2d3c0f1e2d3c0f1e2d3c",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_0f1e2d3c0f1e2d3c0f1e2d3c0f1e2d3c",
      "filename": "invoice-1001.pdf",
      "page_count": 3,
      "size_bytes": 4459
    }
  ],
  "filename": "invoice-1001.pdf",
  "page_count": 3,
  "size_bytes": 4459
}
```

### Compress a PDF

Make a PDF smaller, such as a large scan before emailing it, to a level or a size to aim for.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- How much (`level`, text): How hard to compress. Stronger makes a smaller file with softer pictures. One of: `light` (A little: tidies the file, pictures stay the same), `balanced`, `strong` (A lot: smallest file, softer pictures). Default: `balanced`.
- Aim for size (`target_size`, text): A size to get it under, such as 5MB for an email or 500KB, in place of How much. Leave empty to use How much.
- Black and white (`grayscale`, true/false): Turn colours to shades of grey, which saves more. Default: `false`.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The smaller PDF, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `original_size_bytes` (number): How large the PDF was before, in bytes.
- `page_count` (number): How many pages the PDF has.
- `saved_percent` (number): How much smaller it is now, as a percentage, such as 69.3.
- `size_bytes` (number): The file's size in bytes.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 1,
  "document_ref": "doc_8192a3b48192a3b48192a3b48192a3b4",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_8192a3b48192a3b48192a3b48192a3b4",
      "filename": "scan.pdf",
      "page_count": 1,
      "size_bytes": 27999
    }
  ],
  "filename": "scan.pdf",
  "original_size_bytes": 91261,
  "page_count": 1,
  "saved_percent": 69.3,
  "size_bytes": 27999
}
```

### Convert PDF to images

Turn a PDF's pages into pictures, one per page, such as a preview of the first page to post or attach.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Pages (`pages`, text): Which pages, such as 1 or 2-4. Leave empty for every page.
- Image format (`image_format`, text): The kind of picture to make. One of: `png` (PNG: sharpest, best for text), `jpg` (JPEG: smallest, best for photos). Default: `png`.
- Sharpness (`resolution`, number): Dots per inch, from 50 to 600. 150 reads well on screen; 300 is print quality and four times larger. From 50 to 600. Default: `150`.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: One picture for each page, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every picture made, one for each page, in page order.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `height` (number): The picture's height in pixels.
- `page` (number): The page of the PDF it shows.
- `size_bytes` (number): The file's size in bytes.
- `width` (number): The picture's width in pixels.

**Example output**

```json
{
  "content_type": "image/png",
  "document_count": 2,
  "document_ref": "doc_d6e7f809d6e7f809d6e7f809d6e7f809",
  "documents": [
    {
      "content_type": "image/png",
      "document_ref": "doc_d6e7f809d6e7f809d6e7f809d6e7f809",
      "filename": "invoice-1001-page-1.png",
      "height": 1754,
      "page": 1,
      "size_bytes": 16207,
      "width": 1240
    },
    {
      "content_type": "image/png",
      "document_ref": "doc_e7f8091ae7f8091ae7f8091ae7f8091a",
      "filename": "invoice-1001-page-2.png",
      "height": 1754,
      "page": 2,
      "size_bytes": 16369,
      "width": 1240
    }
  ],
  "filename": "invoice-1001-page-1.png",
  "height": 1754,
  "page": 1,
  "size_bytes": 16207,
  "width": 1240
}
```

### Convert to PDF

Turn a Word, Excel or PowerPoint file, a picture, a web page, Markdown or an email into a PDF, or make one from HTML or Markdown.

**Inputs**

- File (`file`, text): The file: a .docx, .xlsx, .pptx, .odt, .txt, .csv, .jpg, .png, .html, .md, .eml or .msg. Upload it, pick one from an earlier step, or paste a link. Use this or Content.
- Content (`content`, text): HTML (starting with <) or Markdown to lay out as a PDF, such as an invoice built in an earlier step. Use this or File.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The PDF made, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `converted_from` (text): What was converted: document (Word, Excel, PowerPoint, text), image, html, markdown, email or svg.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `page_count` (number): How many pages the PDF has.
- `size_bytes` (number): The file's size in bytes.

**Example output**

```json
{
  "content_type": "application/pdf",
  "converted_from": "document",
  "document_count": 1,
  "document_ref": "doc_a3b4c5d6a3b4c5d6a3b4c5d6a3b4c5d6",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_a3b4c5d6a3b4c5d6a3b4c5d6a3b4c5d6",
      "filename": "minutes.pdf",
      "page_count": 1,
      "size_bytes": 12601
    }
  ],
  "filename": "minutes.pdf",
  "page_count": 1,
  "size_bytes": 12601
}
```

### Extract pages

Make a PDF of only some pages, in the order you list them, such as the signed last page of a contract.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Pages (`pages`, text, required): The pages to keep, such as 1-3, 5 or last. They come out in the order written, so 3, 1 puts page 3 first.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The PDF with only the pages kept, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `page_count` (number): How many pages the PDF has.
- `pages_kept` (list): The pages kept, in the order they are in now.
- `size_bytes` (number): The file's size in bytes.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 1,
  "document_ref": "doc_5e6f70815e6f70815e6f70815e6f7081",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_5e6f70815e6f70815e6f70815e6f7081",
      "filename": "report.pdf",
      "page_count": 2,
      "size_bytes": 1471
    }
  ],
  "filename": "report.pdf",
  "page_count": 2,
  "pages_kept": [
    3,
    1
  ],
  "size_bytes": 1471
}
```

### Extract text from a PDF

Get the text of a PDF, for a later step such as an AI step, a search or a spreadsheet. A scan has none until it is made searchable.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The PDF's text, and the same text as a .txt file in Lodol.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): The .txt file, as a one-item list.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `page_count` (number): How many pages the PDF has.
- `size_bytes` (number): The file's size in bytes.
- `text` (text): The text read from the pages, for a later step such as an AI step or a search. The first 200,000 characters; the file holds all of it.
- `text_truncated` (true/false): Whether the text was longer than the 200,000 characters given here.
- `word_count` (number): How many words were read.

**Example output**

```json
{
  "content_type": "text/plain",
  "document_count": 1,
  "document_ref": "doc_f8091a2bf8091a2bf8091a2bf8091a2b",
  "documents": [
    {
      "content_type": "text/plain",
      "document_ref": "doc_f8091a2bf8091a2bf8091a2bf8091a2b",
      "filename": "invoice-1001.txt",
      "size_bytes": 159
    }
  ],
  "filename": "invoice-1001.txt",
  "page_count": 3,
  "size_bytes": 159,
  "text": "Invoice 1001\nPage 1 of 3\nInvoice total: 1,250.00 EUR",
  "text_truncated": false,
  "word_count": 24
}
```

### Make a scan searchable (OCR)

Read the words in a scanned PDF so its text can be searched, copied and used in later steps, such as an AI step.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Languages (`languages`, list): The languages the pages are written in. Leave empty for English. Only languages your server has are listed.
- Read pages that have text (`redo_text_pages`, true/false): Also read pages that already have text, such as a PDF made from a scan with poor text. Off: those pages are left alone. Default: `false`.
- Straighten pages (`straighten`, true/false): Straighten pages that were scanned at a slant first. Default: `false`.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The searchable PDF, saved in Lodol for 30 days, and the text read from it.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `languages` (list): The languages the pages were read in, such as eng.
- `page_count` (number): How many pages the PDF has.
- `size_bytes` (number): The file's size in bytes.
- `text` (text): The text read from pages that had none, for a later step such as an AI step. The first 200,000 characters.
- `text_truncated` (true/false): Whether the text was longer than the 200,000 characters given here.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 1,
  "document_ref": "doc_92a3b4c592a3b4c592a3b4c592a3b4c5",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_92a3b4c592a3b4c592a3b4c592a3b4c5",
      "filename": "scan.pdf",
      "page_count": 1,
      "size_bytes": 36032
    }
  ],
  "filename": "scan.pdf",
  "languages": [
    "eng"
  ],
  "page_count": 1,
  "size_bytes": 36032,
  "text": "SCANNED LETTER\nDear Ann,\nYour permit number is 48213.\nKind regards",
  "text_truncated": false
}
```

### Merge PDFs

Put several PDFs (or pictures, such as photos of receipts) together as one PDF, in the order given, such as an invoice and its receipts.

**Inputs**

- Files (`files`, list, required): The PDFs to merge, in order: upload them, or pick files from earlier steps. Pictures become a page each.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The merged PDF, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `merged_count` (number): How many files were merged.
- `page_count` (number): How many pages the PDF has.
- `size_bytes` (number): The file's size in bytes.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 1,
  "document_ref": "doc_1a2b3c4d1a2b3c4d1a2b3c4d1a2b3c4d",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_1a2b3c4d1a2b3c4d1a2b3c4d1a2b3c4d",
      "filename": "invoice-pack.pdf",
      "page_count": 5,
      "size_bytes": 3511
    }
  ],
  "filename": "invoice-pack.pdf",
  "merged_count": 2,
  "page_count": 5,
  "size_bytes": 3511
}
```

### Remove a password

Take the password and restrictions off a PDF you have the password for, so later steps can read and change it.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Password (`password`, text, required): The PDF's password. If it also has a permissions password, give that one.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The PDF made, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `page_count` (number): How many pages the PDF has.
- `size_bytes` (number): The file's size in bytes.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 1,
  "document_ref": "doc_0f1e2d3c0f1e2d3c0f1e2d3c0f1e2d3c",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_0f1e2d3c0f1e2d3c0f1e2d3c0f1e2d3c",
      "filename": "invoice-1001.pdf",
      "page_count": 3,
      "size_bytes": 4459
    }
  ],
  "filename": "invoice-1001.pdf",
  "page_count": 3,
  "size_bytes": 1725
}
```

### Remove pages

Take pages out of a PDF, such as a cover sheet or blank pages at the end.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Pages (`pages`, text, required): The pages to take out, such as 1 or 4-last.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The PDF without the pages removed, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `page_count` (number): How many pages the PDF has.
- `pages_removed` (list): The pages taken out, numbered as they were.
- `size_bytes` (number): The file's size in bytes.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 1,
  "document_ref": "doc_6f7081926f7081926f7081926f708192",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_6f7081926f7081926f7081926f708192",
      "filename": "report.pdf",
      "page_count": 3,
      "size_bytes": 1771
    }
  ],
  "filename": "report.pdf",
  "page_count": 3,
  "pages_removed": [
    1,
    2,
    3
  ],
  "size_bytes": 1771
}
```

### Rotate pages

Turn every page of a PDF, such as a scan that came out sideways.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Rotation (`rotation`, text, required): How far to turn every page. One of: `90` (A quarter turn clockwise), `180` (Upside down), `270` (A quarter turn anticlockwise).
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The turned PDF, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `page_count` (number): How many pages the PDF has.
- `rotation` (number): How far every page was turned clockwise, in degrees.
- `size_bytes` (number): The file's size in bytes.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 1,
  "document_ref": "doc_708192a3708192a3708192a3708192a3",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_708192a3708192a3708192a3708192a3",
      "filename": "scan.pdf",
      "page_count": 3,
      "size_bytes": 1704
    }
  ],
  "filename": "scan.pdf",
  "page_count": 3,
  "rotation": 90,
  "size_bytes": 1704
}
```

### Split a PDF

Cut a PDF into several: a set number of pages each, after the pages you name, or one file for every page.

**Inputs**

- PDF (`pdf`, text, required): The PDF: upload one, pick one from an earlier step, or paste a link.
- Pages per file (`pages_per_file`, number): How many pages each new PDF has, such as 2. Leave empty to use Split after pages instead. From 1 to 10000.
- Split after pages (`split_after`, text): The pages to cut after, such as 3, 7: pages 1 to 3, 4 to 7 and the rest. Leave both empty for one PDF per page.
- Save as (`filename`, text): What to call the file made, such as Invoice 1001. The ending is added for you. Leave empty to keep the name of the file it came from.

**Outputs**: The PDFs the split made, saved in Lodol for 30 days.

- `content_type` (text): The kind of file, such as application/pdf or image/png.
- `document_count` (number): How many files were made.
- `document_ref` (text): The file, for a later step that takes one, such as an email's attachments or a drive upload.
- `documents` (list): Every PDF made, each with its name, size and pages.
- `filename` (text): The file's name, ending included, such as invoice.pdf.
- `page_count` (number): How many pages the PDF has.
- `size_bytes` (number): The file's size in bytes.

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_count": 3,
  "document_ref": "doc_2b3c4d5e2b3c4d5e2b3c4d5e2b3c4d5e",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_2b3c4d5e2b3c4d5e2b3c4d5e2b3c4d5e",
      "filename": "report-1.pdf",
      "page_count": 2,
      "size_bytes": 1855
    },
    {
      "content_type": "application/pdf",
      "document_ref": "doc_3c4d5e6f3c4d5e6f3c4d5e6f3c4d5e6f",
      "filename": "report-2.pdf",
      "page_count": 2,
      "size_bytes": 1856
    },
    {
      "content_type": "application/pdf",
      "document_ref": "doc_4d5e6f704d5e6f704d5e6f704d5e6f70",
      "filename": "report-3.pdf",
      "page_count": 2,
      "size_bytes": 1856
    }
  ],
  "filename": "report-1.pdf",
  "page_count": 2,
  "size_bytes": 1855
}
```
