diff --git a/bru-cli/commandOptions.mdx b/bru-cli/commandOptions.mdx index 775904b7..a60313be 100644 --- a/bru-cli/commandOptions.mdx +++ b/bru-cli/commandOptions.mdx @@ -56,7 +56,7 @@ bru run -h | `--ignore-truststore` | Use custom CA certificate exclusively and ignore default truststore [boolean] [default: false] | | `--client-cert-config` | Path to the Client certificate config file used for securing the connection | | `--insecure` | Allow insecure server connections | -| `--disable-cookies` | Automatically save and send cookies with requests [boolean] [default: false] | +| `--disable-cookies` | Disable automatic saving and sending of cookies between requests [boolean] [default: false] | | `--noproxy` | Disable all proxy settings (both collection-defined and system proxies) [boolean] [default: false] | ### Output & Reporting options diff --git a/send-requests/res-data-cookies/cookies.mdx b/send-requests/res-data-cookies/cookies.mdx index c6ee97cb..8d102f9d 100644 --- a/send-requests/res-data-cookies/cookies.mdx +++ b/send-requests/res-data-cookies/cookies.mdx @@ -51,4 +51,16 @@ You can update and delete cookie(s) by clicking the icons next to it. ![cookie-delete](/images/screenshots/send-request/res-data-and-cookie/cookies/6-delete-cookie.webp) +## Cookies in collection runs + +When you run a collection (via the Collection Runner or the [Bruno CLI](/bru-cli/overview)), Bruno automatically saves and forwards cookies between requests. This includes cookies set by responses with **any** status code — 2XX, 4XX, and 5XX responses all have their `Set-Cookie` headers processed. + +To disable automatic cookie handling in the CLI, use the `--disable-cookies` flag: + +```bash +bru run --disable-cookies +``` + +In the desktop app, you can toggle cookie storage off in **Settings > General**. + To manage cookies programmatically, see the [Cookie Management](/testing/script/javascript-reference#cookie-management) section in the JavaScript API Reference.