pdf.pages
Rotate, delete, reorder or extract pages.
POST /v1/pdf/pages
| Input | one file, sent as multipart/form-data; the optional options part is a JSON object |
| Output | one PDF |
| Credits | 1 credit per 10 pages, rounded up to whole blocks of 10 pages, with a minimum of 1 credit |
| Limits | [size, page and time limits: no claim ID yet] |
| Reads or changes the document | returns a changed copy |
| Error statuses | 400, 413, 422, 500, 501, 504 (see Errors) |
Options
Section titled “Options”| Option | Type | Required | Default | Description |
|---|---|---|---|---|
action |
string | yes | What to do. rotate: Rotate the listed pages clockwise by degrees. delete: Remove the listed pages. extract: Return only the listed pages, in the order given. reorder: Put every page in the order given. The list must name each page exactly once. |
|
degrees |
integer | no | For rotate: 90, 180 or 270 degrees clockwise. Default 90. |
|
pages |
array of integer | yes | One-based page numbers. | |
password |
string | no | Password of an encrypted document. |
Example
Section titled “Example”curl -sS -f -X POST "$PDFLUENT_API_URL/v1/pdf/pages" \ -H "x-api-key: $PDFLUENT_API_KEY" \ -F 'options={"action":"rotate","pages":[1],"degrees":90}' \ -o result.pdfimport jsonimport os
import requests
options = {"action": "rotate", "pages": [1], "degrees": 90}
parts = [ ("file", ("outlined.pdf", open("outlined.pdf", "rb"))), ("options", (None, json.dumps(options))),]
response = requests.post( os.environ["PDFLUENT_API_URL"] + "/v1/pdf/pages", headers={"x-api-key": os.environ["PDFLUENT_API_KEY"]}, files=parts,)response.raise_for_status()
with open("result.pdf", "wb") as out: out.write(response.content)import { openAsBlob } from 'node:fs';import { writeFile } from 'node:fs/promises';
const form = new FormData();form.append('file', await openAsBlob("outlined.pdf"), "outlined.pdf");form.append('options', JSON.stringify({"action":"rotate","pages":[1],"degrees":90}));
const response = await fetch(process.env.PDFLUENT_API_URL + "/v1/pdf/pages", { method: 'POST', headers: { 'x-api-key': process.env.PDFLUENT_API_KEY }, body: form,});if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
await writeFile("result.pdf", Buffer.from(await response.arrayBuffer()));The key goes in the x-api-key header; see Authentication. Every response carries x-pdfluent-pages and x-pdfluent-credits.