​
Description

This endpoint writes metadata to PDF files.

​
Endpoint

POST /api/v1/write-pdf-metadata

​
Headers

  • Content-Type: application/json
  • Authorization: Bearer <API_KEY> (required)

​
Request Body

{
  "inputMethod": "string", // Required. Either "url" or "base64"
  "files": ["string"], // Required. Array of URLs or base64-encoded PDF contents
  "metadata": {
    "Title": "string",
    "Author": "string",
    "Subject": "string",
    "Keywords": "string",
    "Creator": "string",
    "Producer": "string"
  }
}

​
Responses

​
Success (200)

Returns the URL to the modified PDF. 
{
  "url": "string" // URL to the modified PDF file or ZIP file
}

​
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.