# How to Record Requests

This page provides a guide on how to configure the [agent](https://docs.stoobly.com/core-concepts/agent) to create cequests.

## Background

{% content-ref url="../core-concepts/mock-api/requests" %}
[requests](https://docs.stoobly.com/core-concepts/mock-api/requests)
{% endcontent-ref %}

## Prerequisites

1. [Run the agent](https://docs.stoobly.com/guides/how-to-run-the-agent)
2. [Configure the agent](https://docs.stoobly.com/guides/proxy-configuration)

## Getting Started

### Create a Scenario

{% hint style="info" %}
This step is optional but recommended
{% endhint %}

{% content-ref url="how-to-record-requests/how-to-create-scenarios" %}
[how-to-create-scenarios](https://docs.stoobly.com/guides/how-to-record-requests/how-to-create-scenarios)
{% endcontent-ref %}

### Record Requests

Requests can be recorded from either the UI or the CLI:

{% content-ref url="how-to-record-requests/recording-from-the-ui" %}
[recording-from-the-ui](https://docs.stoobly.com/guides/how-to-record-requests/recording-from-the-ui)
{% endcontent-ref %}

{% content-ref url="how-to-record-requests/recording-from-the-cli" %}
[recording-from-the-cli](https://docs.stoobly.com/guides/how-to-record-requests/recording-from-the-cli)
{% endcontent-ref %}

### Configure Recording

By default, no additional configuration is needed. However, to configure recording to specific needs, please see:

{% content-ref url="../core-concepts/agent/proxy-settings" %}
[proxy-settings](https://docs.stoobly.com/core-concepts/agent/proxy-settings)
{% endcontent-ref %}

### Send Requests

The following are some suggested ways to send requests to for Stoobly to intercept and record:

* Navigate to your application's web interface
* Send requests with cURL
* Run existing test suites

After sending requests, they are intercepted by the agent and then recorded. You should then see the requests appear in the Stoobly UI.

## Next Steps

{% tabs %}
{% tab title="API Mocking" %}
{% content-ref url="how-to-mock-apis" %}
[how-to-mock-apis](https://docs.stoobly.com/guides/how-to-mock-apis)
{% endcontent-ref %}
{% endtab %}

{% tab title="E2E Testing" %}
{% content-ref url="how-to-integrate-e2e-testing" %}
[how-to-integrate-e2e-testing](https://docs.stoobly.com/guides/how-to-integrate-e2e-testing)
{% endcontent-ref %}
{% endtab %}

{% tab title="Replaying" %}
{% content-ref url="how-to-replay-requests" %}
[how-to-replay-requests](https://docs.stoobly.com/guides/how-to-replay-requests)
{% endcontent-ref %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions: 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:

```
GET https://docs.stoobly.com/guides/how-to-record-requests.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.