BlinqIO Documentation

Import Bruno API Tests into BlinqIO Projects ​

BlinqIO supports importing API requests from Bruno, a lightweight and developer-friendly API client. This integration allows you to migrate your existing Bruno API tests into BlinqIO without manually recreating each request.

Follow these steps to import and use Bruno API tests in your BlinqIO project:

  1. Export your collection from Bruno.
  2. Add the exported files to your BlinqIO project.
  3. Use the imported API steps in your test scenarios through the Recorder.

Export Your API Tests from Bruno ​

To begin, export your existing API collection from Bruno.

  1. Open Bruno and navigate to the collection that contains your API requests.

    open-bruno

  2. Click the three-dot menu (⋮) next to the request you want to export, then select Show in folder to locate the .bru file.

    bruno-step-1

  3. Bruno will open the folder containing the .bru file for that request.

  4. Copy the .bru file(s) for the requests you want to import.

    bruno-step-3

    NOTE

    .bru files contain all the necessary request information, including method, URL, headers, body, authentication, variables, scripts, and tests.

Add Bruno Collection Files to Your BlinqIO Project ​

Once you have the exported files, add them to your BlinqIO project.

  1. Open your project in Visual Studio Code (VS Code).

    bruno-step-4

    NOTE

    Refer to the Open Projects in VSCode guide for detailed instructions.

  2. In the root folder of your project, create a new folder named bruno.

    image-20250506152430333

  3. Paste the .bru files you copied into this bruno folder.

    image-20250506152707027

  4. Open the Project Manager in BlinqIO and find the files you just added.

    proj-manager

  5. Select and upload them to your project using the file upload interface.

    bruno-step-upload

    NOTE

    This step is manual. Make sure the files are placed and uploaded correctly before continuing.

Use Bruno API Steps in a Scenario from the Recorder ​

Once the files are uploaded, you can include them in any test scenario using the Recorder.

  1. Launch the AI Recorder and start recording the scenario you wish to create.

    launch-ai-rec

  2. Click on Reuse steps/scenarios.

    reuse-steps-scenarios

  3. Type Bruno in the search field and select the relevant API step from the imported list to add it to your scenario.

    add-bruno-step-rec

  4. Continue recording the remaining steps as required.

Review Execution Results of Bruno API Steps ​

After you run a scenario with Bruno API steps, the Reports page displays the outcome with detailed response data in JSON format. This includes request details, status codes, test results, and assertion summaries.

bruno-reports-page

Example

json
[
  {
    "iterationIndex": 0,
    "summary": {
      "totalRequests": 1,
      "passedRequests": 1,
      "failedRequests": 0,
      "skippedRequests": 0,
      "totalAssertions": 2,
      "passedAssertions": 2,
      "failedAssertions": 0,
      "totalTests": 2,
      "passedTests": 2,
      "failedTests": 0
    },
    "results": [
      {
        "request": {
          "method": "GET",
          "url": "https://jsonplaceholder.typicode.com/posts/1"
        },
        "response": {
          "status": 200,
          "statusText": "OK",
          "data": {},
          "responseTime": 655
        },
        "assertionResults": [{}, {}],
        "testResults": [{}, {}],
        "runtime": 0.69
      }
    ]
  }
]

This helps you verify whether your API step passed or failed and provides full transparency into its execution.