Skip to main content
POST
Create a test group

Authorizations

Authorization
string
header
required

API key authentication using Bearer token format. The CLI's ta auth access tokens are also accepted; because they name a user rather than a workspace, a user in several workspaces selects one with the x-testerarmy-team header (workspace id or slug).

Body

application/json
projectId
string
required

Project ID

name
string
required
Required string length: 1 - 255
runMode
enum<string>
Available options:
concurrent,
sequential
maxConcurrentRuns
integer | null

Concurrent groups only: max tests executing at once per group run. Capped at your team's concurrent-run limit; null follows the plan limit.

Required range: x >= 1
prepTestId
string<uuid> | null

Web test that runs first and saves its browser session. Any web test in the project qualifies; it does not have to be a member of this group.

Response

Group created

group
object
required