AI Test Engineer Docs

Import Bruno API Tests into Amdocs Projects ​

Amdocs 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 Amdocs without manually recreating each request.

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

  1. Export your collection from Bruno.
  2. Add the exported files to your Amdocs 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 Amdocs Project ​

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

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

    image-20250629122718172

    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 Amdocs and find the files you just added.

    INFO

    On Windows, the Editor hides the top menu bar by default. Press the Alt key to show it.

    proj-manager

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

    bruno-upload-2

    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.

    image-20250629125016188

  2. Click on Reuse steps/scenarios.

    image-20250629130115424

  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.

api-reports-bruno

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.