v2

latestSwagger 2.02026-08-08121119168.6 KB

Team

Create a user in your team

Provisions a new sub-account inside the team, copying the caller's subscription level and assigning a slice of the credit pool. Requires an upgraded plan and admin role.

post/v1/team-management/users

Request body

emailstring required

Email address for the new account; must be unique across TestingBot.

passwordstring required

Initial password for the new user.

first_namestring

New user's given name.

last_namestring

New user's family name.

concurrencyinteger

Max parallel VM sessions (≤ team owner's maxParallel).

concurrencyPhysicalinteger

Max parallel physical-device sessions (≤ team owner's maxParallelDevice).

Response

Create a user in your team

idinteger required

Unique numeric user ID. Also the path param for team endpoints (e.g. /users/:id) and the parent_id reference on team members.

first_namestring required

Given name on the account.

last_namestring required

Family name on the account.

secondsinteger required

Remaining test seconds (credit balance) on the account; -1 means unlimited (e.g. Live plans).

last_loginstring date-time required

ISO-8601 timestamp of the most recent dashboard login.

planstring required

Subscription plan name (e.g. "Free Trial", "Live - 5 Sessions - Unlimited", "Automated Pro ..."). For a sub-account this is the team owner's plan.

max_concurrentinteger required

Maximum number of parallel VM-based sessions allowed by the plan. For a sub-account this is the team owner's cap.

max_concurrent_mobileinteger required

Maximum number of parallel physical device sessions allowed by the plan. For a sub-account this is the team owner's cap.

companystring required

Optional company name for billing.

streetstring required

Billing address line.

citystring required

Billing city.

countrystring required

Billing country.

vatstring required

VAT number (EU only).

read_onlyboolean required

Whether this account has read-only access within the team.

rolesstring[] required

Roles held by the account: "admin" and/or "owner".

current_vm_concurrencyinteger required

VM-based sessions this account is running right now.

current_physical_concurrencyinteger required

Physical-device sessions this account is running right now.