Sending requests
The request panel is where you define what to send. This page walks through each part of the builder.
Method and URL
- Choose a method: GET, POST, PUT, PATCH, DELETE, OPTIONS, or HEAD.
- Enter the full URL in the address field. You can use
placeholders; they resolve from environments and collection variables before the request runs.
TIP
For quick tests, public endpoints like https://httpbin.org/ are useful. Replace with your real API base URL in day-to-day work.
Import from cURL
Paste a cURL command directly into the URL bar. Gud API auto-detects curl ... on paste and fills in the method, URL, headers, body, and auth fields automatically.
For long or multi-line cURL commands, click the clipboard button next to the URL bar to open a dedicated import dialog where you can paste the full command.
See Import & export for more details on cURL and file-based import.
Copy as cURL
Click the cURL button in the URL bar to copy the current request as a cURL command to your clipboard. This is useful for sharing requests with teammates, pasting into terminal, or saving to documentation. cURL export is also available in the Code Snippets dialog.
Query parameters
Use the Params section for query string parameters:
- Add rows for name and value
- Toggle rows on or off without deleting them
- The URL stays in sync with the param table
Headers
Add headers as key/value rows. Common cases:
Content-Typefor JSON, form data, or multipart (the UI sets this automatically when you pick a body mode)Acceptif your API requires explicit content negotiation- Custom API keys or tokens when not using the Auth helper
Body
Depending on the method and API, you may send:
| Mode | When to use |
|---|---|
| None | GET/HEAD or APIs with no body |
| JSON | Typical REST JSON payloads |
| JSON5 | JSON with comments, trailing commas, or relaxed syntax -- a validity indicator helps while you type |
| Form URL encoded | application/x-www-form-urlencoded |
| Multipart | File uploads and mixed fields -- use the file picker for binary parts |
| GraphQL | Often combined with a dedicated GraphQL layout -- see GraphQL |
| Plain text | Raw text or non-JSON payloads |
Relaxed JSON
When using the JSON body mode, Gud API automatically inserts missing commas between properties on separate lines. You can type relaxed JSON without worrying about trailing comma errors.
Authentication
Built-in helpers include:
- Bearer token --
Authorization: Bearer ... - Basic -- username/password encoded for Basic auth
- API key -- sent as a header or query parameter, depending on your choice
Use the auth section so secrets are not pasted into random header rows (easier to change later).
Send
Click the Send button or press Enter when the URL bar is focused.
After the response
Status code, duration, and size appear with the body. See Responses for Pretty / Raw / Preview, search, cookies, and large body handling.