§ Mark and adjust
Set PDF Metadata API
Writes document properties and keywords, and removes them. Removals are applied before additions, so you can replace a value in one request.
- Endpoint
- POST /pdf/set-metadata
- Inputs
- Exactly 1 PDF
- Returns
- application/pdf
- Limits
- 20 MB per file, 3,000 pages.
- Price
- $0.001
§ 01 The request
One POST, and the file comes back.
POST /pdf/set-metadata
curl -sS --fail-with-body \
-o tagged.pdf \
-H "Authorization: Bearer $OHMYWRAP_KEY" \
-F "file=@contract.pdf" \
-F 'options={"properties":{"Department":"Legal"},"keywords":["contract","2026"]}' \
https://api.ohmywrap.com/pdf/set-metadataOptions
| Option | Type | Default | What it does |
|---|---|---|---|
| properties | object | — | Property name to value, to set. |
| keywords | string[] | — | Keywords to add. |
| removeProperties | string[] | — | Property names to delete. |
| removeKeywords | string[] | — | Keywords to delete. |
Worth knowing
At least one of the four options must be present, or it is 422 no_metadata_change rather than a pointless round trip that changes nothing.
Your first /pdf/set-metadata call takes one line of curl.
Ten thousand calls cost ten dollars, the pack never expires, and nothing you send is kept.
10,000 calls for $10. No subscription, no expiry.