# Remove PDF metadata

Remove the hidden details from a PDF: title, author, dates, the program that made it, and optionally scripts and attached files.

- Endpoint: `POST https://setget.net/v1/tools/pdf-strip-metadata` with JSON `{"input": {...}}` (add `"wait": 30` to hold the reply until the job finishes)
- MCP: `run_tool` with `slug` = `pdf-strip-metadata`
- Page: https://setget.net/tools/pdf-strip-metadata

## Files in, files out

This is a file tool. Its file inputs take file references, not file contents and not web addresses.

- Get a reference by uploading: `curl -T FILE https://setget.net/drop/` prints a line `ref  <id>/f1`. Or `POST https://setget.net/v1/drops` with `{"files":[{"name","size"}]}`, PUT the bytes to the returned `upload.url` with the listed headers, and use the file's `ref`. Over MCP use the `drop` tool. A file under about 700 KB can also be sent in place as a `data:<type>;base64,<content>` URI.
- Uploads are at most 100 MB per file, are readable by anyone with the link, and expire (one hour by default). Programs are refused.
- The tool runs as a job. The reply is `{"tool", "ms", "result", "files", "job"}`: `result` is JSON, and every result file comes back in `files` as `{"name", "size", "content_type", "kind", "url", "ref"}`. Download it from `url`, or pass `ref` as the input of another file tool.
- A job still running when the wait ends answers 202 with `job`. Follow it with `GET https://setget.net/v1/jobs/<id>?wait=30`, or stream progress from `GET https://setget.net/v1/jobs/<id>/events` (over MCP: the `job` tool). A person can watch it at `job.url`.

## Inputs

- `file` (required, file, a file reference such as `DROP_ID/f1`, accepts pdf): The PDF to clean.
- `javascript` (optional, boolean, default `true`): Also remove scripts and the actions that run them when the PDF is opened, printed or clicked.
- `attachments` (optional, boolean, default `false`): Also remove files attached inside the PDF.
- `password` (optional, string): The password of the PDF, if it is locked. It is used once to open the file and is never stored or shown. The result is not locked.

## Example 1: Remove title, author, dates and scripts

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.pdf](https://setget.net/static/samples/sample.pdf).

```json
{"input":{"file":"DROP_ID/f1"},"wait":30}
```

## Example 2: Remove metadata and attached files, keep scripts

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.pdf](https://setget.net/static/samples/sample.pdf).

```json
{"input":{"file":"DROP_ID/f1","attachments":true,"javascript":false},"wait":30}
```

**What exactly is removed?** The document properties (title, author, subject, keywords, creating program, dates), the XMP metadata block that repeats them, and metadata attached to single pages and pictures. With javascript on, scripts and automatic actions go too; with attachments on, attached files. The result lists what was found and removed.

**Is the visible content changed?** No. Pages, text, pictures, links and bookmarks stay as they are.

**Does this remove names written on the pages?** No. Only hidden details are removed. Text you can see on a page, comments and the contents of pictures are untouched, and so is metadata inside photos placed in the PDF.

**Does a signed PDF stay signed?** No. Any change to a signed PDF makes its digital signature invalid.

**Can I use a PDF that is locked with a password?** Yes. Give the password in the password input. It is used once to open the file, is not stored and is not shown anywhere. The result is not locked. Without the right password a locked PDF cannot be read.
