Add PDF watermark
Add a text watermark to all or specific pages of a PDF.
Authorizations
Short-lived, Developer-API-audience token obtained by the trusted MCP service through token exchange (mcp_at_...). Raw MCP resource tokens are rejected.
Body
File ID of the PDF
"550e8400-e29b-41d4-a716-446655440000"
Watermark text
"CONFIDENTIAL"
Font size in points (default: 50)
50
Opacity from 0 to 1 (default: 0.3)
0.3
Rotation angle in degrees (default: -45)
-45
Text color as hex code (default: #808080)
"#FF0000"
Page specifications to apply watermark to. If omitted, all pages are watermarked.
Optional webhook configuration
Response
Watermark job created
Job ID
"550e8400-e29b-41d4-a716-446655440000"
Action that was performed
"pdf.merge"
Current job status
PENDING, PROCESSING, COMPLETED, FAILED "PENDING"
Input file IDs used for this job
Output file ID (available when COMPLETED)
null
Error message (available when FAILED)
null
Job creation timestamp
Job start timestamp
Job completion timestamp
Signed, time-limited browser download URL for the output file (available when COMPLETED). An API key may also be used on the same endpoint.
"https://api.autype.com/api/v1/dev/tools/files/output-file-id/download?token=signed-token"
Structured job result data (e.g. OCR markdown/JSON, generated filename, PDF metadata, form fields). Available when the job produces a direct result instead of an output file.
Deprecated — use result instead. Additional metadata, duplicated from result for backward compatibility.
