Building Requests

The request builder is the heart of Flamingo. It is divided into several sections, each accessible via the tab bar below the URL bar.

Request Name

Click the request name input at the top to give your request a meaningful name. This is used when saving to collections and in history entries.

HTTP Method

Select the HTTP method from the dropdown next to the URL bar. Methods are color-coded:

• GET — green
• POST — blue
• PUT — amber
• PATCH — purple
• DELETE — red
• OPTIONS / HEAD — gray

URL Input

Enter the target URL in the address bar. You can paste a cURL command directly — Flamingo auto-detects and parses it.

Request Sections

Each tab in the request builder controls a different aspect of the request:

Tab	What it configures
Params	URL query parameters
Headers	HTTP request headers
Auth	Authentication configuration
Body	Request payload
Scripts	Pre-request and post-response JavaScript

Sending

Click Send or press Ctrl + Enter to execute the request. Flamingo:

1. Resolves {{variable}} placeholders using the active environment
2. Runs the pre-request script (if any)
3. Sends the HTTP request via fetch()
4. Captures the response (status, headers, body, timing, size)
5. Runs the post-response script (if any)
6. Saves the request to history
7. Displays the response in the right panel

Example: Sending a GET Request

// Method: GET
// URL: https://api.example.com/users?page=1
// Params tab:
//   page = 1
// Headers tab:
//   Authorization = Bearer {{token}}
// Click Send => response displayed in right panel