Create a network test user

POST

networks

{networkId}

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,
  "target_kind": "domain",
  "connector_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "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.

Scopes

test_users:write

Path Parameters

networkId

string

required

A network connector id, or direct for this install (self-hosted only).

Body

application/json

Credentials for a test user saved to a network.

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>

Available options:

none,

totp

totp_secret

string

Required when mfa_method=totp. Stored encrypted.

Response

Test user created.

A saved test account attached to a domain or network. 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

target_kind

enum<string>

required

Available options:

domain,

network

connector_id

string<uuid> | null

required

Network connector id. A null value means this install.

organization_id

string<uuid>

domain_id

string<uuid> | null

scope_domain_ids

string<uuid>[]

Domain ids this domain test user applies to. An empty array means it applies to every domain in the organization. Network test users do not apply to domains.

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,
  "target_kind": "domain",
  "connector_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "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>"
}

Domains

Analytics

Asset Discovery

Audit

Billing

Chat

CLI

Connectors

Containers

Assets

Test Users

Integrations

Knowledge

License

LLM

Run Logs

Organization

Invitations

Members

PR Reviews

Vulnerabilities

Repositories

Supply Chain

Scans

Schedules

Search

Tokens

Uploads

Webhooks

Workspaces

Create a network test user

Authorizations

Scopes

Path Parameters

Body

Response