Description
This endpoint writes metadata to PDF files.Endpoint
Headers
- Content-Type:
application/json
- Authorization: Bearer
<API_KEY>
(required)
Request Body
Responses
Success (200)
Returns the URL to the modified PDF.Notes
- Credit usage: 5 credits per 100MB of output PDF size
- Multiple files can be processed in a single request
- Returns a ZIP file if multiple PDFs are processed
- Supports standard PDF metadata fields
- Files are temporarily stored (24-hour retention)
- Not all metadata are writable. Consider taking a look at https://exiftool.org/TagNames/XMP.html#pdf for an (exhaustive?) list of available metadata.
- Caution: Writing metadata may compromise PDF/A compliance.
Rate Limiting
Rate limit headers are included in the response.Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
Indicates whether binary content is supplied via URL or base64-encoded string.
Available options:
url
, base64
Array of PDF URLs or base64-encoded PDF contents to update.
Minimum length:
1
Key-value metadata pairs to write into the PDF.
Response
PDF metadata updated.
Temporary download URL for the updated PDF (or ZIP when multiple files are provided).