Update a network test user

PATCH

networks

{networkId}

test-users

{userId}

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).

userId

string<uuid>

required

Test user id.

Body

application/json

Credentials for a test user saved to a network.

label

string

New display label for the test user.

username

string

New login username or email.

password

string

New password. Stored encrypted and never returned.

notes

string

New free-text hints for the agent.

New URL of the login page.

mfa_method

enum<string>

Available options:

none,

totp

totp_secret

string

New TOTP secret. Required when mfa_method is totp. Stored encrypted and never returned.

Response

Updated test user.

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

Update a network test user

Authorizations

Scopes

Path Parameters

Body

Response