AnyConvert
← All docs

Protect PDF

Send a PDF and the passwords or restrictions you want; get back the same PDF encrypted with AES-256 (or AES-128 on request).

See the Protect 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="protect-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=@contract.pdf" \
  -F "fileId=document-001" \
  -F "referenceId=reference-001" \
  -F "tool=protect-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. Passwords are never logged or echoed back, in any response or error message.

userPasswordstring, optionalNeeded to open the file. 0 to 127 UTF-8 bytes. If omitted, the file opens without a password but keeps any restrictions.
ownerPasswordstring, optionalNeeded to change restrictions later. If omitted and a restriction is set, a random owner password is generated and never returned — restrictions then can't be changed by anyone.
permissionsobject, optionalprint ("none", "low", or "high", default "high"); modify, extract, annotate, fillForms, assemble (booleans, default true). Accessibility extraction always stays allowed.
currentPasswordstring, optionalRequired when the input is already encrypted and doesn’t open with an empty password.
compatstring, optionalDefault "aes256", or "aes128" for older readers.

Pricing

Billed per document — $1 (1 credit) per protected PDF.

Failure reasons

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

invalid_optionsNeither a password nor any restriction was given, or a password couldn't be represented.
encrypted_fileThe input is already encrypted and the correct currentPassword wasn't given.
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.