{"uid":"cap_3c9R-8ys91ta-pl8uGwHn","slug":"tanod-docs-pdf-unlock-d66197ae","name":"Tanod Docs PDF Unlock","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/unlock?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."},"password":{"type":"string","maxLength":127,"minLength":0,"description":"User or owner password; \"\" opens owner-password-only PDFs; never logged."},"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."}}},"responseSchema":{"type":"json","example":{"file":{"name":"unlocked.pdf","bytes":13257,"pages":1,"data_base64":"JVBERi0xLjcKJb/3... (trimmed: 17,676 base64 characters in the reply)","content_type":"application/pdf"},"operation":"unlock","input_bytes":14183,"input_pages":1,"opened_with":"user","output_bytes":13257,"untrusted_content":true,"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_O8nnY-W7dXVEeVGFWGbx7","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":"Removes password protection from an encrypted or owner-locked PDF, returning the unlocked file as base64 or a 24-hour download URL.","exampleAgentPrompt":"I have a password-protected PDF at https://example.com/secure-report.pdf — the password is 'letmein'. Can you unlock it and give me back the file as base64 so I can work with it?","exampleUseCases":[{"title":"Unlock contractor-sent protected invoice","prompt":"I received this PDF invoice but it's locked with the password 'Invoice2024'. Here it is as base64 — can you unlock it and give me back an accessible version?"},{"title":"Strip owner restrictions from internal report","prompt":"This internal report PDF has an owner password that's preventing me from copying text or printing. The password is blank — can you remove those restrictions and give me a download link to the unlocked version?"},{"title":"Open password-protected legal document from URL","prompt":"Can you unlock this PDF at https://files.lawfirm.com/contract_protected.pdf? The user password is 'Contract#99'. Give me back the file as base64 so I can process it further."}],"resultDescription":"Returns a JSON object containing the unlocked PDF either as inline base64 or a 24-hour download URL (with expiry, byte size, content type, and SHA256 hash). Also includes metadata such as operation type ('unlock'), input/output byte counts, page count, which password type was used to open the file, and flags like untrusted_content and active_content_removed.","failureModes":["Wrong or missing password returns an authentication error","PDF URL exceeds 20 MB or base64 payload exceeds 10 MB decoded triggers a size rejection","Private, internal, or IP-literal host URLs are refused","Malformed base64 input causes a decoding error","File is not a valid PDF returns a format error","Neither url nor pdf_base64 provided results in a validation error"],"whenToPreferThis":"Choose this endpoint when you need to programmatically remove password protection or owner restrictions from a PDF, especially in an automated pipeline where you have the password at hand. It supports both URL-based and base64 inline input, making it flexible for agent workflows. Prefer it over general PDF tools when you specifically need decryption/unlocking as a discrete step, and the output format flexibility (base64 vs download URL) lets you keep large files out of context windows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:44:52.712Z","isFirstParty":false,"canonicalSlug":"tanod-docs-pdf-unlock-d66197ae"}