---
title: "PDF/UA auto-tagging API"
canonical_url: "https://www.nutrient.io/guides/dws-processor/tools-and-api/pdfua-api/"
md_url: "https://www.nutrient.io/guides/dws-processor/tools-and-api/pdfua-api.md"
last_updated: "2026-05-26T07:02:01.697Z"
description: "Automatically tag PDF files for accessibility (PDF/UA) in a single API call using Nutrient DWS Processor API."
---

# 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](https://www.nutrient.io/guides/dws-accessibility/developer-guides/auto-tag-pdfs.md) 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:

### Shell

### HTTP

## Auto-tag a PDF from a URL

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

```json

{
  "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`:

```json

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

```

## Advanced customization with Build API

For advanced customization, use `/build` with:

```json

"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`.

## Related links

- [`PDF/UA Auto-Tagging` operation in API reference](https://www.nutrient.io/api/reference/public/#tag/Document-Editing/operation/processor-pdfua)

- [`Build document` operation](https://www.nutrient.io/api/reference/public/#tag/Document-Editing/operation/build-document)

- [DWS Accessibility API overview](https://www.nutrient.io/guides/dws-accessibility.md)

- [DWS Accessibility auto-tagging](https://www.nutrient.io/guides/dws-accessibility/developer-guides/auto-tag-pdfs.md)
---

## Related pages

- [Markdown-to-PDF API](/guides/dws-processor/tools-and-api/markdown-to-pdf-api.md)
- [Tools and APIs](/guides/dws-processor/tools-and-api.md)
- [Document-to-image API](/guides/dws-processor/tools-and-api/document-to-image-api.md)
- [Image-to-PDF API](/guides/dws-processor/tools-and-api/image-to-pdf-api.md)
- [DOCX templating API](/guides/dws-processor/tools-and-api/docx-templating-api.md)
- [Office-to-PDF API](/guides/dws-processor/tools-and-api/office-to-pdf-api.md)
- [PDF security API](/guides/dws-processor/tools-and-api/pdf-security-api.md)
- [PDF generator API](/guides/dws-processor/tools-and-api/pdf-generator-api.md)
- [PDF-to-image API](/guides/dws-processor/tools-and-api/pdf-to-image-api.md)
- [PDF-to-PDF/A API](/guides/dws-processor/tools-and-api/pdf-to-pdfa-api.md)
- [PDF OCR API](/guides/dws-processor/tools-and-api/pdf-ocr-api.md)
- [PDF watermark API](/guides/dws-processor/tools-and-api/pdf-watermark-api.md)
- [Redaction API](/guides/dws-processor/tools-and-api/redaction-api.md)