Create a domain test user

POST

domains

{domainId}

test-users

Error

A valid request URL is required to generate request examples

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "label": "<string>",
  "username": "<string>",
  "mfa_method": "none",
  "has_password": true,
  "has_totp_secret": true,
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "scope_domain_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "notes": "<string>",
  "mfa_email": "<string>",
  "login_url": "<string>",
  "created_by": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

Authorizations

Authorization

string

header

required

API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.

Path Parameters

domainId

string<uuid>

required

Domain id.

Body

application/json

label

string

required

Display label for the test user.

username

string

required

password

string

Stored encrypted. Never returned.

notes

string

Free-text hints for the agent, for example which role the account has.

URL of the login page where the agent signs in with this account.

mfa_method

enum<string>

Second factor the account uses. none for password only.

Available options:

none,

totp,

email_otp,

magic_link

totp_secret

string

Required when mfa_method=totp. Stored encrypted.

mfa_email

string

Required for email_otp/magic_link. Must be a Strix-managed inbox in the caller's org pod (see provision-inbox).

scope_domain_ids

string<uuid>[]

Domain ids this test user applies to. Empty array = every domain in the organization (requires unrestricted access). Defaults to the route's domain.

Response

Test user created.

A domain test account. Secrets are never returned — only boolean presence flags.

string<uuid>

required

label

string

required

username

string

required

mfa_method

enum<string>

required

Available options:

none,

totp,

email_otp,

magic_link

has_password

boolean

required

has_totp_secret

boolean

required

organization_id

string<uuid>

domain_id

string<uuid>

scope_domain_ids

string<uuid>[]

Domain ids this test user applies to. An empty array means it applies to every domain in the organization.

notes

string | null

mfa_email

string | null

created_by

string | null

created_at

string<date-time>

updated_at

string<date-time>

Error

A valid request URL is required to generate request examples

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "label": "<string>",
  "username": "<string>",
  "mfa_method": "none",
  "has_password": true,
  "has_totp_secret": true,
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "scope_domain_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "notes": "<string>",
  "mfa_email": "<string>",
  "login_url": "<string>",
  "created_by": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

Scans

Audit

Vulnerabilities

Assets

Schedules

Tokens

Webhooks

Organization

Members

Invitations

Analytics

LLM

Connectors

Chat

PR Reviews

Knowledge

Integrations

Uploads

Test Users

License

Supply Chain

CLI

Billing

Workspaces

Create a domain test user

Authorizations

Path Parameters

Body

Response