Skip to content
Bitassert
Documentation

API Testing

Guides for authoring, running and analysing tests across web automation, API and performance — plus setup, collaboration and release notes.

Step Groups

A Step Group is a reusable set of API HTTP steps you can maintain once and reference from multiple API testcases. Each group runs its inner steps in order when the parent testcase executes. For Web step groups, see .

Step group vs regular API step

Regular API stepStep group step
HTTP requestsOn the stepInside the group
ReuseOne testcaseMany testcases
Edit locationTestcase detailsAPI Step Groups menu or Open Step Group
Send in testcase viewAvailableUse step group editor to debug requests

Why use step groups

  • Reuse common API flows (auth, setup, teardown) across many testcases.
  • Update the group once; referencing testcases use the updated inner steps after load/save.
  • Keep testcase step lists shorter and easier to maintain.

Create a step group (standalone)

  1. Go to API > Step Groups and click Create.
    2. API Step Groups create modal with name, description, base URL, status, and release tags
  2. Enter Name, Description, Base URL, Status, and optional release tags, then click Create.
    3. API Step Group editor with HTTP steps, request tabs, and Send
  3. Open the new step group and add HTTP steps with + Add Step to create a new step.
  4. Configure each inner step (method, URL, path, Params, Auth, headers, body, Validate Response, Extract Response) — see .
    5. API Step Group editor with HTTP steps, request tabs, and Send
  5. Click Save.

Create from testcase steps

  1. Open an API testcase in Edit and select one or more normal API steps (not another step group).
  2. In the step menu, choose Create Step Group.
    3. Create Step Group from selected API steps in testcase editor
  3. Enter group metadata (name, description, base URL, status, optional release tags) and click Create.
  4. The selected steps are saved as a new group and replaced by a single (Step Group) step in the testcase. Click Save the testcase.
Create Step Group from selected API steps in testcase editor

Note:

Nested step groups are not supported — you cannot place a step group inside another step group.

Use a step group in a testcase

  1. Open API testcase details → Edit.
  2. From a step's menu, choose Add → Add Step Group and pick a group from the project.
    3. Add Step Group from API testcase step menu
  3. Pick a group in the Select Step Group modal.
    4. step group editor
  4. A Step Group row is inserted (expandable in the Test Steps panel). Save the testcase.

Expected outcome

A reusable API Step Group is stored in the project. Testcases reference it as one expandable (Step Group)step, and the group's inner HTTP steps run in order as part of the parent testcase flow.