Getting Started GuideBruno BasicsCreate a Request

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.

create request dialog

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

create-new-request

  1. 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.

Custom Request Filenames

Starting with Bruno v1.40.0 ↗, you can now use special characters in request names and customize how they appear in the filesystem. This gives you more flexibility in organizing your collections while maintaining compatibility.

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.”

file-system-name

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

file-system-name

  1. (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.