​

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.