{"uid":"cap_6cI3sqO08zaTYRc8bzp-1","slug":"relaystation-pdf-watermark-c31dc093","name":"RelayStation PDF Watermark","description":"$0.001/page. Stamp text watermarks across PDF pages — DRAFT, CONFIDENTIAL, or your own. 1¢ x402 min; remainder auto-credits — relaystation.ai/penny","url":"https://api.relaystation.ai/v1/pdf/watermark","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"file":{"type":"object","description":"cputools input-source: { inline: <base64 ≤ 4 MiB> } or { inputKey: <scratch key from /v1/cputools/upload-url, ≤ 50 MB> }."},"size":{"type":"integer","maximum":400,"minimum":1},"text":{"type":"string","maxLength":500,"minLength":1},"color":{"type":"string","pattern":"^#?[0-9a-fA-F]{6}$"},"pages":{"type":"string","description":"1-based pages/ranges, \"all\" or \"1-3\" (default all)."},"opacity":{"type":"number","maximum":1,"minimum":0},"position":{"enum":["center","top-left","top-right","bottom-left","bottom-right"],"type":"string"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LhmLHefUOxPSbwgqyVTA7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stamps a text watermark (e.g. DRAFT, CONFIDENTIAL, or custom text) across pages of a PDF document with configurable position, opacity, color, and size","exampleAgentPrompt":"Take this PDF file and stamp 'CONFIDENTIAL' in red text at a 0.3 opacity diagonally centered on every page — I need to share it externally and want the watermark clearly visible but not blocking the content.","exampleUseCases":[{"title":"Draft review document marking","prompt":"Add a 'DRAFT' watermark in gray at 50% opacity centered on all pages of this contract PDF before I send it to the client for review."},{"title":"Confidential report protection","prompt":"Stamp 'CONFIDENTIAL' in dark red text, centered, at 0.4 opacity across all pages of this financial report PDF — size 80 and I want to make sure it's visible on every page."},{"title":"Page-range selective watermarking","prompt":"Add a 'FOR REVIEW ONLY' watermark in blue at the bottom-right of pages 1 through 5 of this PDF proposal at 0.6 opacity."}],"resultDescription":"Returns a watermarked PDF file with the specified text overlaid on the requested pages. The output PDF has the watermark applied at the configured position, color, opacity, and font size, with all original content preserved underneath.","failureModes":["File too large (>50 MB via inputKey or >4 MiB inline base64) returns an error","Invalid color hex pattern causes schema validation failure","Invalid page range string returns a parsing error","Malformed or corrupt PDF input returns a processing error","Opacity value outside 0–1 range fails schema validation","Text exceeding 500 characters is rejected"],"whenToPreferThis":"Choose this endpoint when you need to programmatically add visible text watermarks to PDF documents at low cost ($0.001/page), especially within an automated agent workflow that handles document distribution or review cycles. Ideal when you need fine-grained control over watermark position, opacity, color, and page range selection without standing up your own PDF processing infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:48:43.750Z","isFirstParty":false}