Making Requests
The URL bar
Click the URL bar to enter edit mode, or press Cmd+E when a tab is focused. The bar highlights tokens in your URL — resolved tokens appear in the accent colour, unresolved ones in red.
Press Enter or click Send (or Cmd+Enter) to send the request.
Request tabs
The bottom panel has tabs for configuring different parts of the request. You can reorder them in Settings → Tabs.
| Tab | Purpose |
|---|---|
| Body | Request body — JSON, form data, raw text, binary |
| Params | Query parameters as key-value pairs |
| Headers | Request headers |
| Security | Auth configuration to attach |
| Settings | Per-request overrides (timeout, SSL, redirects) |
Additional tabs in the top toolbar:
| Tab | Purpose |
|---|---|
| Script | Pre/post-request JavaScript |
| Tests | Assertions on the response |
| Docs | Notes and documentation for this request |
| Examples | Saved example request/response pairs |
| History | Per-request history |
Body types
| Type | Use for |
|---|---|
| JSON | application/json with syntax highlighting and formatting |
| Form Data | multipart/form-data with file upload support |
| URL Encoded | application/x-www-form-urlencoded |
| Raw | Any content type — XML, plain text, etc. |
| Binary | Upload a file directly as the body |
| GraphQL | GraphQL query and variables |
Headers
The headers editor shows active headers at the top and inactive (toggled off) headers below a divider. Click Add common header to pick from a library of 44 pre-built headers across categories like Content-Type, Authentication, Caching, and CORS.
Response panel
After sending, the response panel shows:
- Status — HTTP status code and reason phrase, colour-coded
- Time — round-trip time in milliseconds
- Size — response body size
Response tabs:
| Tab | Shows |
|---|---|
| Preview | Rendered JSON (collapsible tree) or HTML preview |
| Raw | Raw response body text |
| Headers | Response headers |
| cURL | Equivalent cURL command, ready to copy |
| Compare | Diff against another response from history |
| Tests | Test assertion results |
Saving requests
Press Cmd+S to save. The first save prompts for a name and folder. Subsequent saves update the file in place.
The tab title shows an unsaved indicator (dot) when there are unsaved changes.