跳转到主要内容

PDF Tools API

Delete Pages API

Remove unwanted pages from PDFs inside document cleanup, compliance, and intake workflows before files reach users.

Create API KeyRead full API docs

Credits

1 Credit / call

1 Credit per successful API request. Failed processing attempts are refunded automatically.

Pricing

1,000 Credits = $1

Every signed-in user receives 100 free API Credits each month.

Endpoint

/api/external/pdf-tools/delete-pages

Use your API Key in the x-api-key header.

cURL example

curl -X POST https://itextmaster.com/api/external/pdf-tools/delete-pages \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "files": [
      { "name": "input.pdf", "dataBase64": "JVBERi0xLjcK..." }
    ],
    "options": {"pages":[2,4]}
  }' \
  --output cleaned.pdf

Node.js example

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://itextmaster.com/api/external/pdf-tools/delete-pages', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  files: [
    { name: 'input.pdf', dataBase64: 'JVBERi0xLjcK...' }
  ],
  options: {"pages":[2,4]}
})
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile('cleaned.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/pdf-tools/delete-pages',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'files': [
            {'name': 'input.pdf', 'dataBase64': 'JVBERi0xLjcK...'}
        ],
        'options': {'pages':[2,4]}
    },
)
response.raise_for_status()

with open('cleaned.pdf', 'wb') as f:
    f.write(response.content)

Error codes

401invalid_api_key

The x-api-key header is missing, invalid, or has been rotated.

402insufficient_credits

The account does not have enough API Credits for the request.

422pdf_tool_processing_failed

The file, options, or PDF structure could not be processed.

Limits

  • Requires one valid PDF file.
  • At least one page must remain after deletion.
  • Use valid 1-based page numbers in the options payload.

Example output

cleaned.pdf with X-Credits-Charged: 1 and X-Credit-Balance response headers.

X-Credits-Charged: 1

X-Credit-Balance: 99

Content-Disposition: attachment; filename="cleaned.pdf"

FAQ

Can I delete multiple pages in one request?

Yes. Send a pages array with all pages that should be removed.

Is page deletion permanent in the output?

Yes. The returned PDF omits the selected pages; keep the original if you need an audit copy.

What does the API return?

A cleaned PDF file with X-Credits-Charged and X-Credit-Balance headers.

Start with 100 free API Credits

Create an API Key, test Delete Pages API, and buy more Credits only when automation volume grows.

Get API KeyView full API docs