{"uid":"cap_LBiHgqFvq3TysEHbcnjlZ","slug":"docforge-pdf-watermark-01cfcfc7","name":"DocForge PDF Watermark","description":"Machine-payable document & media generation via x402 (USDC on Base). Endpoints respond 402 with payment instructions; retry with an x402 payment header.","url":"https://docforge-selim.duckdns.org/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":{"required":["file","text"],"properties":{"file":{"type":"string","description":"Base64-encoded source PDF (data: URI accepted). Max 15MB."},"size":{"type":"number","description":"Font size."},"text":{"type":"string","description":"Watermark text (required)."},"angle":{"type":"number","description":"Rotation degrees, default 45."},"color":{"type":"string","description":"Hex color, e.g. #888888."},"opacity":{"type":"number","description":"0-1, default ~0.2."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"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":{"type":"json","example":"Binary watermarked PDF (application/pdf)"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S2B_hiLCi1jNQXzAc9JXl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Adds a watermark to an existing PDF document, returning the watermarked binary PDF, paid via x402 USDC on Base.","exampleAgentPrompt":"Can you add a diagonal 'CONFIDENTIAL' watermark in light gray across every page of this PDF I'm uploading? Pay the $0.02 fee automatically.","exampleUseCases":null,"resultDescription":"A binary PDF file (application/pdf) with the specified watermark applied to all pages, returned as application/pdf content ready to save or forward.","failureModes":["402 Payment Required — no x402 payment header provided; retry with valid USDC payment on Base","400 Bad Request — missing or malformed PDF input or watermark parameters","413 Payload Too Large — PDF file exceeds size limit","415 Unsupported Media Type — input file is not a valid PDF","500 Internal Server Error — watermark processing failed on the server side","Payment rejected — insufficient USDC balance or invalid wallet signature"],"whenToPreferThis":"Use this endpoint when you need to programmatically stamp or brand a PDF with a text or image watermark in a machine-payable, per-call fashion via x402/USDC, without managing a subscription or API key — ideal for agents automating document workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:26:09.085Z","isFirstParty":false}