PDF/UA auto-tagging API

Use the PDF/UA auto-tagging API to convert a PDF into a tagged, accessibility-ready PDF/UA document in a single request. This is a preconfigured endpoint on top of the Build API output type pdfua.

The /processor/pdfua endpoint is deprecated in DWS Processor and retained for existing integrations only. New integrations should use the DWS Accessibility auto-tag PDFs guide.

Auto-tag a PDF for accessibility

Place a PDF file in the same folder as your code (for example, document.pdf) and send it to the API:

curl -X POST https://api.nutrient.io/processor/pdfua \
  -H "Authorization: Bearer your_api_key_here" \
  -F 'file=@document.pdf' \
  --fail \
  -o result.pdf

Auto-tag a PDF from a URL

For remotely hosted source PDFs, pass the URL as JSON using url:

{
  "url": "https://www.nutrient.io/api/assets/downloads/samples/pdf/basic.pdf"
}

Password-protected PDFs

If the input PDF is encrypted, pass password in the JSON payload or in multipart data:

{
  "url": "https://example.com/protected.pdf",
  "password": "your-password"
}

Advanced customization with Build API

For advanced customization, use /build with:

"output": {
  "type": "pdfua"
}

With /build, you can:

  • Compose output from multiple parts (for example, file parts, HTML parts, and page composition).
  • Apply actions before PDF/UA output (for example, OCR, watermark, rotate, flatten, redaction, and Instant JSON/XFDF import).
  • Configure PDF output options such as metadata, labels, user_password, owner_password, user_permissions, and optimize.
  • Control per-part input settings such as pages, password, content_type, and layout.