# Tanod Docs PDF Metadata Read/Write

> Tanod Docs PDF Metadata Read/Write is a paid API for AI agents from docs.tanod.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-13).

Reads, sets, or strips metadata fields (title, author, subject, keywords, etc.) from a PDF document.

## Facts

- Endpoint: POST https://docs.tanod.dev/v1/pdf/metadata?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-docs-pdf-metadata-read-write-6ee35b51
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7fCCAZyAyBubHOhWY8vtz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tanod-docs-pdf-metadata-read-write-6ee35b51 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Documents: DOCX template fill, Office to PDF, any file to Markdown, PDF to Word, OCR, PDF pipeline.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "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
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-docs-pdf-metadata-read-write-6ee35b51/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from docs.tanod.dev](https://www.zero.xyz/host/docs.tanod.dev/llms.txt)