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

# How do I scope a scan to one route?

> Keep Qodex focused on one route by using a clear chat instruction, tags, or a pre-authored scenario.

# How do I scope a scan to one route?

Use the lightest control that matches how precise you need the run to be.

For one-off work, tell Qodex the exact route in chat. For repeatable subsets, use tags. For strict control, run one pre-authored scenario.

![Qodex scenario run controls for a focused scenario](https://mintcdn.com/qodexai/rhkO1RmGEPTQ07wr/images/docs/run-tests/run-scenario.png?fit=max\&auto=format\&n=rhkO1RmGEPTQ07wr\&q=85\&s=df6fd3c84e77c07cf3aacda8258704fc)

## Option 1: Tell Qodex in chat

Use this while Qodex is exploring or authoring tests.

```text theme={null}
Test only POST /api/orders. Skip everything else in the collection.
```

```text theme={null}
Run the security skill against /api/v1/users/{id}. Focus on BOLA.
```

This tells the coordinator and sub-agents to keep the run focused.

## Option 2: Use tags

Use tags when the same scope should run again.

```text theme={null}
Run the scenarios tagged checkout.
```

```bash theme={null}
curl -X POST \
  https://agents.qodex.ai/api/projects/my-project-slug/webhooks/trigger \
  -H "Authorization: Bearer qk_xxx..." \
  -H "Content-Type: application/json" \
  -d '{"environment":"staging","tags":["checkout"]}'
```

In the web app, open **Test > Scenarios**, set the **Tags** filter, and click **Run all**.

Tags work well for scopes like `smoke`, `checkout`, `security`, `critical`, or `auth`.

## Option 3: Run one scenario

Use this when you know exactly what should execute.

A single pre-authored scenario gives the tightest scope: one route, one test shape, and no extra exploration. Open **Test > Scenarios**, hover the scenario, and click **Run**.

A whole-target Security scan cannot be narrowed to one route. It covers the verified origin you pick, so use chat or a saved scenario when you need one route.

## Which option should I choose?

| Need | Best option |
| - | - |
| One-time route investigation | Chat instruction |
| Recurring subset of tests | Tags |
| Exact route and exact assertions | Single scenario |

## Next steps

> [card] [API testing scenarios](https://qodex.ai/docs/api-testing-scenarios.md)
>
> Learn the API scenario model.

> [card] [Run a single scenario](https://qodex.ai/docs/run-tests-single-scenario.md)
>
> Execute one saved test.

> [card] [Run tag-filtered scenarios](https://qodex.ai/docs/run-tests-tag-filtered.md)
>
> Run a reusable subset.

> [card] [API governance](https://qodex.ai/docs/api-testing-governance.md)
>
> Keep endpoint coverage organized.


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