Skip to main content
GET
Get 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).

Path Parameters

groupId
string<uuid>
required

Test group ID

Response

Group details

id
string<uuid>
required
name
string
required
isDefault
boolean
required
runMode
enum<string>
required
Available options:
concurrent,
sequential
maxConcurrentRuns
integer | null
required

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
required
projectId
string<uuid>
required
createdAt
string<date-time>
updatedAt
string<date-time>