> For the complete documentation index, see [llms.txt](https://docs.stoobly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stoobly.com/core-concepts/agent/intercept-modes/recording.md).

# Recording

In the context of Stoobly, recording means to intercept HTTP requests with the agent and save them to the local filesystem.

## Why record HTTP requests?

Recording HTTP requests saves previously seen requests and their responses. This enables you to:

* Mock future requests that match and return realistic data
* Replay requests at any time
* Gain deeper insight into a scenario's requests

## What gets recorded?

The following HTTP request components get recorded:

* Hostname
* Port number
* Path
* Headers
* Query Parameters
* Body
* Response Headers
* Response Body

## When are HTTP requests recorded?

<figure><img src="/files/amvKhodUXdINJUU6Svmq" alt=""><figcaption><p>Recording a HTTP request with Stoobly</p></figcaption></figure>