xtract.bot
POST /api/pdf-rotate

Rotate one or more pages of a PDF by 90, 180, or 270 degrees. The rest of the document is preserved verbatim.

Rotates the chosen pages of a PDF by 90, 180, or 270 degrees clockwise. Inputs: - `pages`: which pages to rotate. Accepts a comma-separated list (`1,3,5`), ranges (`2-7`), or `all` for every page. - `degrees`: `90`, `180`, or `270`. Pages not in the selection are preserved verbatim. The output is the rotated document — no re-rasterization, original quality kept.

Inputs

NameTypeDefaultDescription
pdf*fileThe PDF to rotate (base64-encoded by the playground).
rotationenum (90 | 180 | 270 | -90 | -180 | -270)"90"Rotation in degrees (relative to current).
pagesstring""1-based page selection (e.g. '1,3-5'); empty == all pages.

Response

Modes: binary, base64-json. Cache: yes (24h TTL).

Code samples

Built from the rotate-all-90 example.

# Download or substitute the example input:
#   curl -O https://xtract.bot/examples/pdf-extract-text/hello.pdf
PDF=$(base64 -w0 < hello.pdf)

curl -X POST https://api.xtract.bot/api/pdf-rotate \
  -H "Content-Type: application/json" \
  -H "Accept: application/octet-stream" \
  -H "X-Account-Id: $XTRACT_ACCOUNT_ID" \
  -H "X-Api-Key: $XTRACT_API_KEY" \
  -d '{
  "rotation": "90",
  "pages": "",
  "pdf": "'"$PDF"'"
}'