> For the complete documentation index, see [llms.txt](https://gaffa.dev/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gaffa.dev/docs/features/data-retention.md).

# Data Retention

Anytime Gaffa generates and hosts a URL, it keeps it only for a limited time. After that window, it's gone: the URL or ID stops resolving, and you can't recover it.

### When Data Retention Matters

1. **Actions that return a Gaffa-hosted URL.** [`capture_dom`](/docs/features/browser-requests/actions/capture-dom.md), [`capture_screenshot`](/docs/features/browser-requests/actions/capture-screenshot.md),  [`download_file`](/docs/features/browser-requests/actions/download-file.md), [`generate_markdown`](/docs/features/browser-requests/actions/generate-markdown.md), [`print`](/docs/features/browser-requests/actions/print.md), and more return their output as a `storage.gaffa.dev` URL. That file is only available for as long as your plan's retention window. Check each action's own docs page to see whether it returns an output URL.
2. **Async requests (`async: true`).** The request returns an `id`, which you use to fetch the full result later via `GET /v1/browser/requests/{id}`. That lookup only works within your plan's retention window.
3. **Recorded videos (`record_request: true`).** The video is hosted the same way, and only available for the same window.

### Retention by plan

| Plan    | Retention period |
| ------- | ---------------- |
| Starter | 7 days           |
| Startup | 30 days          |
| Growth  | 3 months         |

### After the window passes

Once the retention period has passed, you can no longer access the URL or ID. 

{% hint style="info" %}

#### A couple of things worth knowing

* Retention starts from when the request completes, not from when you first fetch the result.
* If you need to keep a result beyond your plan's window, save the response and any output files somewhere of your own before it lapses. You can't extend or recover access after the fact.
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gaffa.dev/docs/features/data-retention.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.