> For the complete documentation index, see [llms.txt](https://docs.adaptiva.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptiva.com/patch/patching-fundamentals/flex-controls/flex-controls-scan-requests.md).

# Requests

Additionally, you can clear the maximum number of times a patch can fail installation value to allow further installation attempts with **Failure Reset Requests**.

For instance, if you have just installed a new product onto a client device and don't want to wait until the daily scan the following day, you can create a **Scan Request** to immediately run a scan on the client device. Or if you are troubleshooting, you can create a **Failure Reset Request** that will clear the known data of the products installed on a client device, so you can compelete a clean scan and see where there may be an issue.

## Create a scan request

1. Select **Advanced Settings > Flex Controls > Requests > Scan Requests**.
2. Click **Browse** next to **Target Business Units** and select the Business Unit(s).
   * If you have chosen a Target Client(s), selecting a Business Unit(s) is optional.
3. Click **Browse** next to **Target Clients** and select a client(s) for the scan to be applied.
   * If you have chosen a Business Unit, selecting a Target Client(s) is optional.
4. (Optional) Click **Browse** next to **Patching Strategies** and select a patching strategy that you'd like to associate with the selected client devices.
5. Select either **Scan all Software** and optionally select **Reset Data** if you want to reset a previous scan and then run a clean scan.

   Alternatively, you can click **Browse** next to **Software** to scan only selected products. This is useful in the event that a scan is too resource intensive to run during normal business hours and you only want to scan for the new product that was installed on the client.
6. Click **Submit**

   ![](/files/5dzr8yFnhLu5pTHodZqm)

This will now trigger an immediate scan of the chosen target clients.

## Create a failure reset request

1. Select **Advanced Settings > Flex Controls > Requests > Failure Reset Request**.

You can follow the same steps 2-4 as [Scan Requests](#create-a-scan-request) above, then select either **Reset All Software** or choose individual **Products** and **Patches** you'd like to reset. After you submit your request, this will immediately reset the scan and what was previously reported to OneSite Patch from the client device(s). This will give you a clean slate to perform another scan.

![](/files/tJRPXJnAbjzN84RmzCZD)


---

# 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://docs.adaptiva.com/patch/patching-fundamentals/flex-controls/flex-controls-scan-requests.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.