Creating a Request

Bruno makes it easy to work with various API protocols - whether you’re building RESTful services with HTTP, designing GraphQL APIs, or converting cURL commands into reusable requests. With support for all standard HTTP methods (GET, POST, PUT, DELETE, etc.), you can create, test, and manage your API requests efficiently.

Let’s walk through how to create your first request:

Create a New Request in Bruno

1. Go to your Collection, and click on the ··· button.
2. Select New Request in the dropdown menu.

3. In the dialog that appears, choose:
   • Request Type (HTTP, GraphQL, or from cURL)
   • Request Name
   • HTTP Method (GET, POST, PUT, etc.)
   • URL

4. Click Create to finish.

You have successfully created your first request in Bruno! Feel free to add headers, query parameters, and a request body to your request, or play around with the other options available.

Quick Create via Inline ”+” Button

For rapid prototyping and testing, you can create requests inline without going through the full creation dialog:

Creating HTTP Requests (Default)

• Click on the ”+” icon next to the request tabs to instantly create an HTTP request

Creating Other Request Types

To create GraphQL, gRPC, or WebSocket requests:

1. Right-click the ”+” icon next to the request tabs
2. A toolbar appears with all request type options:
   • HTTP
   • GraphQL
   • gRPC
   • WebSocket

3. Click on any option to instantly create a new request of that type

How It Works

When you create a request using the inline ”+” button:

• A new “Untitled” request opens immediately in a new tab
• The request is filled with presets if configured in your collection settings
• No file is created yet in your collection folder - the request exists only in memory
• The request automatically inherits all collection-level settings (authentication, headers, etc.)

Saving Your Request

Before the request is persisted to your collection:

1. You can rename the request from “Untitled” to any name you prefer
2. Make changes, add parameters, test the request
3. When you’re ready to save, Bruno will prompt you to:
   • Choose a location: Save to the collection root or a specific folder
   • Confirm the name: The request name you’ve set will be used

This workflow allows you to quickly experiment with requests and only save them when you’re satisfied with the setup.

Custom Request Filenames

You can use any characters in your request names, including special characters like /, [, ], *, etc. Bruno automatically handles filesystem compatibility by replacing unsupported characters with - in the filenames while preserving your original request name.

To view or customize the filesystem name

1. Select Show Filesystem Name.

2. You can now see how your request name is stored on the filesystem.

3. (Optional) Click the edit icon to customize the filename while keeping your display name intact.

This feature gives you complete freedom in naming your requests while ensuring filesystem compatibility.