> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Zero data retention

> Send zeroDataRetention to keep nothing from a call: no stored copy read or made. Which endpoints take it, what it changes and what it refuses.

Set `zeroDataRetention: true` per call. Stophy reads the page live and keeps no copy. Billing still leaves a record, and some jobs hold results briefly so you can collect them. See [Pricing](https://docs.stophy.dev/account/pricing.md#scrape-add-ons) for what it adds.

```bash theme={null}
curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "formats": ["markdown"], "zeroDataRetention": true}'
```

The answer has the usual shape, with `data.metadata.cacheState` set to `miss` because no stored copy was read. Read the content from this response. A normal scrape can be read for 24 hours with `GET /v1/scrape/{id}`. This one answers `404 notFound`.

## Where to send it

| Endpoint | Field | Refused with |
| - | - | - |
| [Scrape](https://docs.stophy.dev/scrape/overview), [batches](https://docs.stophy.dev/batches/overview) | `zeroDataRetention` | A screenshot |
| [Search](https://docs.stophy.dev/search/overview) | `scrapeOptions.zeroDataRetention` | A screenshot |
| [Extract](https://docs.stophy.dev/extract/overview), [crawl](https://docs.stophy.dev/crawl/overview) | `zeroDataRetention` or `scrapeOptions.zeroDataRetention` | A screenshot |
| [Parse](https://docs.stophy.dev/parse/overview) | `zeroDataRetention` | Nothing |
| [Agent](https://docs.stophy.dev/agent/overview) | `zeroDataRetention` | `threadId` |
| [Browser sessions](https://docs.stophy.dev/browser/overview) | `zeroDataRetention` | `profile`, `recording` |
| [Interact on a scrape](https://docs.stophy.dev/scrape/interact.md) | `zeroDataRetention` on the first call | Nothing |

[Monitors](https://docs.stophy.dev/monitors/overview) do not take it, because a monitor keeps a snapshot to compare with the next one.

## What changes

* **Stored copies.** None is read or made, so every read is live.
* **Results.** `GET /v1/scrape/{id}` answers `404`, and the scrape cannot be interacted with. Open the page in a session from `POST /v1/browser` instead.
* **Jobs.** A crawl, batch or extract keeps its results for 1 hour after it finishes instead of 24. A webhook delivery for it is recorded without its payload.
* **Agent.** The prompt, steps and result are held for one hour at most.
* **Logs.** [`GET /v1/logs`](https://docs.stophy.dev/account/usage#list-calls) shows the request ID, endpoint, method, status and cost, not the content.
* **Browser sessions.** No [replay](https://docs.stophy.dev/browser/overview#recordings-and-replay), no recording, and no [profile](https://docs.stophy.dev/browser/profiles.md), because a profile keeps cookies.
* **Interact.** If the scrape's session is already open without the flag, stop it with `DELETE /v1/scrape/{id}/interact` and start again.

Your app stays responsible for what it stores and logs from the answers.

## Refusals

All are `400 invalidRequest`. Remove the setting that needs a stored copy and send again.

* A screenshot format, a `screenshot` or `pdf` action, or `onlyCleanContent` on scrape, search, extract, crawl or batches.
* `threadId` on agent.
* `profile` or `recording` on a browser session.
* Any monitor.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.