{"uid":"cap_7fCCAZyAyBubHOhWY8vtz","slug":"tanod-docs-pdf-metadata-read-write-6ee35b51","name":"Tanod Docs PDF Metadata Read/Write","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/metadata?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"set":{"anyOf":[{"type":"object","properties":{"title":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"default":null},"author":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"default":null},"creator":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"default":null},"subject":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"default":null},"keywords":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"default":null},"producer":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"default":null}},"additionalProperties":false},{"type":"null"}],"default":null,"description":"Fields to write (\"\" deletes one); omit to only read."},"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."},"strip":{"type":"boolean","default":false,"description":"Remove ALL document metadata (Info, XMP, page-level) first."},"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."}}},"responseSchema":{"type":"json","example":{"changed":false,"metadata":{"title":"Form W-9 (Rev. March 2024)","author":"SE:W:CAR:MP","created":"2024-03-06T08:18:13-05:00","creator":"Designer 6.5","has_xmp":true,"subject":"Request for Taxpayer Identification Number and Certification","keywords":"Fillable","modified":"2024-03-06T08:18:13-05:00","producer":"Designer 6.5"},"operation":"metadata","input_bytes":140815,"input_pages":6,"pdf_version":"1.7","untrusted_content":true}},"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_S9AzF9Pn11cJy97lRqnnb","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":"Reads, sets, or strips metadata fields (title, author, subject, keywords, etc.) from a PDF document.","exampleAgentPrompt":"Read the metadata from this PDF at https://example.com/report.pdf — I want to see the title, author, subject, and keywords. Then update the title to 'Q4 Financial Report 2024' and the author to 'Finance Team', and return the modified file as a download link.","exampleUseCases":[{"title":"Audit PDF document properties","prompt":"Can you pull all the metadata from this PDF — https://example.com/contract.pdf — and tell me the title, author, creator, producer, and when it was created and modified?"},{"title":"Stamp author and keywords on PDF","prompt":"I have a PDF encoded in base64 here. Please set the author to 'Acme Legal Dept', the title to 'Master Services Agreement', and the keywords to 'contract legal MSA' — then give me back a download link to the updated file."},{"title":"Strip all metadata before sharing","prompt":"Before I share this PDF publicly, I need to remove all the metadata from it — title, author, XMP, everything. Here's the URL: https://internal.example.com/draft.pdf. Return the cleaned file as base64."}],"resultDescription":"Returns a JSON object containing the PDF's metadata fields (title, author, creator, subject, keywords, producer, created, modified, has_xmp), whether the metadata was changed, the PDF version, page count, input byte size, and the modified PDF either as a base64 string or a temporary 24-hour download URL (with sha256, byte size, and expiry).","failureModes":["PDF URL is not publicly accessible, uses a private/internal host, or exceeds 20 MB — returns an error","Base64 payload exceeds 10 MB decoded — request rejected","Input is not a valid PDF — parsing error returned","Network timeout fetching the URL","Fields in `set` are too long (over 1000 characters) — validation error"],"whenToPreferThis":"Use this endpoint when you need to read or programmatically update standard PDF metadata fields (Info dictionary and XMP) without re-generating or converting the document. It is the right choice when you want to non-destructively inspect PDF properties, bulk-tag documents, or scrub metadata for privacy — and you already have a PDF (not a Word doc or image). Prefer the URL input for large files to avoid large base64 payloads in context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:30:02.311Z","isFirstParty":false,"canonicalSlug":"tanod-docs-pdf-metadata-read-write-6ee35b51"}