Creating Requests

Bruno provides multiple ways to create and manage API requests. This guide covers everything from basic request creation to advanced organization techniques.

Creating a New Request

There are several ways to create a new request in Bruno:

Right-click on a Collection or Folder

In the sidebar, right-click on the collection or folder where you want to create the request.

Select 'New Request'

Choose “New Request” from the context menu. You can also use the keyboard shortcut Cmd/Ctrl + N.

Enter Request Details

Provide a name for your request and select the request type (HTTP, GraphQL, gRPC, or WebSocket).

From the Collection Actions

Click the three-dot menu (IconDots) next to any folder and select “New Request” to create a request in that folder.

Quick Request Creation

Use the CreateUntitledRequest component to quickly create a temporary request for testing:

Untitled requests are transient and won’t be saved until you explicitly save them using Cmd/Ctrl + S.

Request Components

Each request in Bruno consists of several configurable components accessible through tabs in the HttpRequestPane:

Query URL

The QueryUrl component allows you to configure your endpoint:

https://api.example.com/users

Use double curly braces {{variable_name}} to reference environment variables or collection variables.

HTTP Methods

Bruno supports all standard HTTP methods:

GET: Retrieve resources
POST: Create new resources
PUT: Update entire resources
PATCH: Partially update resources
DELETE: Remove resources
HEAD: Retrieve headers only
OPTIONS: Get supported methods

Request Tabs

The HttpRequestPane component provides organized tabs for request configuration:

Params Tab

Configure query parameters using the QueryParams component:

key

string

Parameter name (e.g., page, limit, filter)

value

string

Parameter value. Supports variable interpolation with {{variable}}.

enabled

boolean

default:true

Toggle to enable/disable individual parameters without deleting them.

Example:

Key	Value	Enabled
page	1	✓
limit	✓
sort	created_at	✗

Body Tab

The RequestBody component supports multiple body types:

{
  "name": "{{user_name}}",
  "email": "[email protected]",
  "role": "admin"
}

Uses CodeMirror with application/ld+json mode for syntax highlighting.

<?xml version="1.0" encoding="UTF-8"?>
<user>
  <name>{{user_name}}</name>
  <email>[email protected]</email>
</user>

Uses CodeMirror with application/xml mode.

Managed by the FormUrlEncodedParams component:

Key	Value
username
password
grant_type	password

Managed by the MultipartFormParams component. Supports file uploads.

Plain text body with application/text mode.

Upload a file directly using the FileBody component.

Headers Tab

Configure HTTP headers using the RequestHeaders component:

Example Headers

Content-Type: application/json
Authorization: Bearer {{access_token}}
X-API-Key: {{api_key}}
User-Agent: Bruno/1.0

Headers configured at the collection or folder level are inherited by child requests. You can override them at the request level.

Other Tabs

The request pane includes additional tabs for advanced configuration:

Auth: Authentication configuration (see Authentication)
Vars: Request and response variables (see Vars component)
Script: Pre-request and post-response scripts (see Scripts)
Assert: Inline assertions using the Assertions component
Tests: JavaScript test suite (see Tests)
Docs: Markdown documentation for the request
Settings: Request-specific settings and tags

Organizing Requests

Folders

Organize related requests using folders:

Create a Folder

Right-click a collection, select “New Folder”, and name it (e.g., “Authentication”, “Users”, “Posts”).

Nest Folders

Folders can be nested to create hierarchical structures. The CollectionItem component handles rendering with proper indentation.

Inherit Settings

Configure auth, headers, scripts, and variables at the folder level to apply them to all child requests.

Drag and Drop

The CollectionItem component supports drag-and-drop:

Drag requests between folders
Reorder requests within a folder
Move requests to different collections

Bruno uses React DnD for drag-and-drop functionality. Items can be dropped “adjacent” (before/after) or “inside” folders.

Sequence Ordering

Requests are automatically assigned a seq (sequence) number for ordering. The sidebar uses sortByNameThenSequence() to display items.

Request Examples

For HTTP requests, you can create response examples to document different scenarios:

Create Example

Right-click a request and select “Create Example”. This uses the CreateExampleModal component.

Configure Example

Provide a name, description, and configure the expected response (status, headers, body).

View Examples

Examples appear as collapsible items under the request in the sidebar, rendered by ExampleItem component.

Example in .bru file

meta {
  name: Get User
  type: http
}

get {
  url: {{api_url}}/users/{{user_id}}
}

example:success {
  status: 200
  body: {
    "id": 123,
    "name": "John Doe",
    "email": "[email protected]"
  }
}

example:not-found {
  status: 404
  body: {
    "error": "User not found"
  }
}

Saving Requests

Cmd/Ctrl + S

The saveRequest action in providers/ReduxStore/slices/collections/actions handles saving requests to the filesystem.

Cloning Requests

Duplicate requests to create variations:

Right-click Request

Right-click the request you want to clone in the sidebar.

Select 'Clone'

The CloneCollectionItem modal will open, allowing you to name the cloned request.

Edit Clone

Modify the cloned request as needed. All configuration is copied from the original.

Running Requests

Send requests using multiple methods:

Send Button
Keyboard Shortcut
Context Menu
Folder Run

Click the “Send” button in the request pane.

Right-click a folder and select “Run” to execute all requests in sequence using the RunCollectionItem component.

The sendRequest action uses the Axios HTTP client to execute requests and displays results in the ResponsePane.

Best Practices

Use Descriptive Names

Name requests clearly (e.g., “Create User”, “Get Orders by Date”) to make collections self-documenting.

Organize by Feature

Group related requests in folders by feature or API resource (e.g., “Users”, “Products”, “Orders”).

Leverage Inheritance

Configure common auth, headers, and scripts at the collection or folder level to avoid duplication.

Use Variables

Parameterize URLs, tokens, and values using {{variables}} for flexibility across environments.

Document with Examples

Create response examples to document expected API behavior for different scenarios.

Next Steps

Request Types

Learn about REST, GraphQL, gRPC, and WebSocket requests

Authentication

Configure authentication methods for your requests

Scripts

Automate workflows with pre-request and post-response scripts

Tests

Write test assertions to validate API responses

Get Started

Core Concepts

Desktop App

CLI

Advanced

Integrations

Creating Requests

Creating a New Request

From the Sidebar

From the Collection Actions

Quick Request Creation

Request Components

Query URL

HTTP Methods

Request Tabs

Params Tab

Body Tab

Headers Tab

Other Tabs

Organizing Requests

Folders

Drag and Drop

Sequence Ordering

Request Examples

Saving Requests

Cloning Requests

Running Requests

Best Practices

Next Steps

Request Types

Authentication

Scripts

Tests

Build docs developers (and LLMs) love

Get Started

Core Concepts

Desktop App

CLI

Advanced

Integrations

​Creating a New Request

​From the Sidebar

​From the Collection Actions

​Quick Request Creation

​Request Components

​Query URL

​HTTP Methods

​Request Tabs

​Params Tab

​Body Tab

​Headers Tab

​Other Tabs

​Organizing Requests

​Folders

​Drag and Drop

​Sequence Ordering

​Request Examples

​Saving Requests

​Cloning Requests

​Running Requests

​Best Practices

​Next Steps

Request Types

Authentication

Scripts

Tests

Build docs developers (and LLMs) love

Creating a New Request

From the Sidebar

From the Collection Actions

Quick Request Creation

Request Components

Query URL

HTTP Methods

Request Tabs

Params Tab

Body Tab

Headers Tab

Other Tabs

Organizing Requests

Folders

Drag and Drop

Sequence Ordering

Request Examples

Saving Requests

Cloning Requests

Running Requests

Best Practices

Next Steps