Skip to main content
Version: 9.x

Select pages

Keeps the pages you list, in the order you list them.

POST/forms/pdf/select
Form data
filesfile[]required

The PDFs.

archivesfile[]

ZIP files Gotenberg unpacks: each entry counts as a file uploaded under files.

downloadFromjson

URLs Gotenberg downloads first, as if you had uploaded the files. Each entry takes a url, and optionally extraHttpHeaders.

Options
pagespagesrequired

The pages to keep, such as 3,1 or 1-2.

Response

The PDF, or a ZIP of the PDFs when you send several.

The route also takes the headers. An error answers a status and a message: see Errors.

Keep pages​

curl \
  --request POST http://localhost:3000/forms/pdf/select \
  --form files=@report.pdf \
  --form pages=1-2 \
  -o report.pdf

pages takes a page selection: a page, a range, a list of both, or all, odd, even or last.

Reorder pages​

select keeps the pages in the order you list them:

curl \
  --request POST http://localhost:3000/forms/pdf/select \
  --form files=@report.pdf \
  --form pages=3,1,2 \
  -o report.pdf

In a list of stages​

The stage also runs in a list on /forms/pdf/pipe, and on the PDFs a Chromium or LibreOffice conversion makes, in its stages field:

curl \
  --request POST http://localhost:3000/forms/pdf/pipe \
  --form files=@report.pdf \
  --form 'stages=[
    { "op": "select", "pages": "3,1" }
  ]' \
  -o report.pdf