AnyConvert
← All docs

Crop PDF

Send a PDF and a rectangle or margins, as you see the page; get back the same PDF with its visible area (CropBox) set accordingly. The hidden content is not removed — it can still be recovered from the file. For actually removing content, see our roadmap for a dedicated redaction tool.

See the Crop PDF tool page, or the docs index for authentication, the shared request/webhook contract, and the generic error table.

Request

POST /webhooks/trigger — same endpoint and fields as every tool, with tool="crop-pdf" set explicitly (it's not the default).

curl
curl -X POST https://api.anyconvert.app/webhooks/trigger \
  -H "x-api-key: your_api_key_here" \
  -F "file=@drawing.pdf" \
  -F "fileId=document-001" \
  -F "referenceId=reference-001" \
  -F "tool=crop-pdf"

Options

An optional options multipart field carrying a JSON object, validated synchronously before a credit is charged — a bad value is rejected with 400, not charged and not queued.

boxobject, one of box/margins{ x, y, width, height } in displayed points (top-left origin). Must be at least 10×10pt and lie inside the page.
marginsobject, one of box/margins{ top, right, bottom, left } — removed from each displayed edge.
unitstring, optional"pt" (default), "mm", or "in".
pagesstring, optionalDefault "all"; the page-selection grammar.

Response

The success delivery carries a warning noting that cropped content is hidden, not removed.

Pricing

Billed per page, not per document — 1 credit for every 20 pages, rounded up.

Failure reasons

Delivered via the webhook as outcome=failure with a reason below — see the docs index for the full delivery shape.

invalid_optionsThe box lies outside the page, is smaller than 10×10pt, or a page is outside the document.
invalid_fileThe file could not be read, or was not the format this tool expects.
render_failedSomething failed during conversion that wasn’t a problem with the input itself.
timeoutThe job did not finish within its time budget.
internal_errorAn unexpected error on our side.
AnyConvert
A simple conversion API for teams that need documents turned into the right format, automatically.
Tools
PDF to WordMerge PDFJPG to PDFSign PDFEdit PDFCompress PDFExtract Text with CoordinatesView all tools →
Product
DocsPricing
Legal
Terms of ServicePrivacy PolicyRefund Policy
Support
support@anyconvert.app
© 2026 AnyConvert. All rights reserved.