{"uid":"cap_USOOVkGOvQ-V10hKTaPqA","slug":"tanod-docs-pdf-protect-a0ac6aa7","name":"Tanod Docs PDF Protect","description":"Documents: DOCX template fill, Office to PDF, any file to Markdown, PDF to Word, OCR, PDF pipeline.","url":"https://docs.tanod.dev/v1/pdf/protect?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"anyOf":[{"type":"string","maxLength":2048,"minLength":1},{"type":"null"}],"default":null,"description":"Public http(s) URL of the PDF (at most 20 MB; private, internal and IP-literal hosts are refused); or use pdf_base64."},"output":{"enum":["base64","url"],"type":"string","default":"base64","description":"base64 (default): the file comes back inline as base64. url: the file is stored for 24 hours and the reply carries a download link (url, expires_at, bytes, content_type, sha256) instead of the base64, which keeps the file out of your context window."},"pdf_base64":{"anyOf":[{"type":"string","maxLength":13398872,"minLength":1},{"type":"null"}],"default":null,"description":"The PDF as base64 (at most 10 MB decoded per request); or use url."},"permissions":{"type":"object","properties":{"print":{"type":"boolean","default":true},"modify":{"type":"boolean","default":true},"annotate":{"type":"boolean","default":true},"assemble":{"type":"boolean","default":true},"copy_text":{"type":"boolean","default":true},"fill_forms":{"type":"boolean","default":true},"accessibility":{"type":"boolean","default":true},"print_high_quality":{"type":"boolean","default":true}},"description":"What a user-password holder may do (default: everything).","additionalProperties":false},"user_password":{"type":"string","maxLength":127,"minLength":1,"description":"Needed to open the PDF; never logged."},"owner_password":{"anyOf":[{"type":"string","maxLength":127,"minLength":1},{"type":"null"}],"default":null,"description":"Lifts the restrictions; default: a random one nobody knows."}}},"responseSchema":{"type":"json","example":{"file":{"name":"protected.pdf","bytes":14183,"pages":1,"data_base64":"JVBERi0xLjcKJb/3... (trimmed: 18,912 base64 characters in the reply)","content_type":"application/pdf"},"operation":"protect","encryption":"AES-256","input_bytes":13264,"input_pages":1,"permissions":{"print":true,"modify":true,"annotate":true,"assemble":true,"copy_text":true,"fill_forms":true,"accessibility":true,"print_high_quality":true},"output_bytes":14183,"untrusted_content":true,"owner_password_set":false,"active_content_removed":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dAP-iaNqVNCsjW7VhUNA0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Password-protects a PDF with AES-256 encryption and granular permission controls (print, copy, modify, etc.)","exampleAgentPrompt":"Can you password-protect this PDF so that only someone with the password 'OpenSesame123' can open it, and make it so they can't copy text or print it? Here's the file URL: https://example.com/report.pdf","exampleUseCases":[{"title":"Lock confidential report before sharing","prompt":"I need to send this financial report PDF to an external auditor but I want to lock it so only they can open it using the password 'Audit2024$', and they shouldn't be able to copy or modify any of the content. Here's the file: https://company.com/q4-report.pdf"},{"title":"Distribute read-only legal documents","prompt":"Take this contract PDF at https://storage.example.com/contract.pdf and protect it with the user password 'ReadOnly#99' — disable printing, copying text, modifying, and form filling so clients can only view it."},{"title":"Secure employee onboarding package","prompt":"I have this onboarding PDF encoded in base64 that I'd like to password-protect with 'Welcome2024!' so new hires can open it, but they shouldn't be able to print high quality copies or annotate it — can you encrypt it and give me back a download link instead of the raw data?"}],"resultDescription":"Returns a JSON object containing the AES-256 encrypted PDF (as base64 inline or a 24-hour download URL), along with metadata including file size in bytes, page count, active permissions granted, whether an owner password was set, encryption type, and input/output byte counts.","failureModes":["PDF URL is unreachable, private, or internal (IP-literal hosts refused)","PDF exceeds 20 MB via URL or 10 MB via base64","Neither url nor pdf_base64 provided","Invalid base64 encoding in pdf_base64","Password exceeds 127 characters","Malformed permissions object with unrecognized keys","PDF is already encrypted and cannot be re-protected without owner password"],"whenToPreferThis":"Use this endpoint when you need to add AES-256 password encryption to an existing PDF with fine-grained permission controls (print, copy, modify, annotate, assemble, fill forms, accessibility). Prefer this over generic file converters when security and DRM-style restrictions are the primary goal rather than format conversion.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:45:53.006Z","isFirstParty":false,"canonicalSlug":"tanod-docs-pdf-protect-a0ac6aa7"}