> ## Documentation Index > Fetch the complete documentation index at: https://docs.markapidown.net/llms.txt > Use this file to discover all available pages before exploring further. # rqb request > Send an ad-hoc HTTP request from the terminal without creating a spec file first. ## Overview `rqb request` lets you fire off any HTTP request from the terminal no spec file needed. It feels like `curl` but with automatic variable resolution and optional spec saving. ## Usage ```bash theme={null} rqb request [options] ``` ## Examples ```bash theme={null} # Simple GET rqb request GET https://api.example.com/users # POST with JSON body rqb request POST https://api.example.com/users \ -H "Content-Type: application/json" \ -d '{"name":"Ada Lovelace"}' # Use variables from env.md rqb request GET https://api.example.com/users/{{userId}} --var userId=42 # Dry-run (print resolved request, don't send) rqb request GET https://api.example.com/users --dry-run # Save result as a spec file rqb request GET https://api.example.com/users --save api-docs/apis/users/get-users.md # Auto-save to current collection rqb request GET https://api.example.com/users --save ``` ## Default output Compact by default (agent-friendly): ``` 200 OK 147ms [{"id":1,"name":"Ada Lovelace"}] ``` Add `--verbose` for the full diff view. ## Options | Flag | Description | | ---------------------------- | ----------------------------------------------------------------- | | `-H, --header ` | Add a request header. Repeatable. | | `-d, --data ` | Request body string, or `@file` to read from a file. | | `--var ` | Variable override. Repeatable. | | `--env ` | Environment for variable resolution (default: `dev`). | | `--dry-run` | Print the resolved request without sending. | | `--timeout ` | Timeout override in milliseconds. | | `--save [path]` | Save result as a spec file. Omit path to auto-save to collection. | | `--verbose` | Full diff output. | ## Workspace behaviour * **Inside a git repo**: the collection is at `/api-docs/`. Auto-saved requests go to `/api-docs/apis/scratch/`. * **Outside a git repo**: the collection is at `~/.rqb/workspace/default/api-docs/`. Unsaved requests go to `~/.rqb/workspace/scratch/api-docs/`.