Running Tests Manually
Running tests manually in Bruno allows you to quickly validate functionality and immediately view results. The most common example of this would be simply hitting an endpoint and seeing if it is working.
Running a Single Test
The smallest unit of testing in Bruno is a single request. The request itself tests the functionality of any given endpoint. You can add additional logic to requests by using the Tests
tab.
To manually trigger a single test:
- Open a Collection
- Select the Request that you would like to run
- Click Enter or press the send icon
- View the results in the
Tests
section of the response pane
Running a Test Suite
Often times a Bruno Collection can represent a test suite of different actions or workflows of an API. You can use the Collection Runner to execute this entire suite, and also iterate through data using data driven testing.
Follow these steps to run your collection, view the results, and optionally download the test report as an HTML document.
- Open the Bruno collection
- Click on the Run option from the dropdown menu.
-
Click Run Collection to initiate the test.
-
Once the test run is complete, a test report will be automatically generated.
Download Test Report Premium

After the test report is generated, you can download it as an HTML document (report.html
).
- Click the Download Report button to save the report.
Controlling Request Execution with Tags
Bruno allows you to filter which requests to run in your collection using tags. You can add tags to your requests and then filter them during collection runs.
This feature requires Bruno version 2.8.0 or higher.
Filtering by Tags in GUI
When running a collection in the Bruno app, you can filter requests by tags:
-
Add tags to your requests: Go to request settings and add tags to categorize your requests
-
Go to Collection Runner: Open the collection runner to start filtering requests
-
Use tag filter options: Use the tag filter options to include or exclude requests based on their tags
-
Run filtered collection: Only requests matching your tag criteria will be executed
Tag Filtering Options
- Include tags: Only run requests that have ALL of the specified tags
- Exclude tags: Skip requests that have ANY of the specified tags
- Combined filtering: Use both include and exclude filters together
Learn more about tag filtering in Bruno CLI in the CLI tag filtering documentation.
View Test Report
Once the report is downloaded, you can open the report.html
file in any web browser to review the detailed test results.