Update the runtime profile without changing management identity or lifecycle.

PATCH

/v1/virtual-users/me

curl --request PATCH \
  --url https://app.everruns.com/api/v1/virtual-users/me \
  --header 'Content-Type: application/json' \
  --data '{ "avatar_url": "https://example.com/avatar.png", "description": "Support team member", "locale": "example", "name": "Alex", "status": "active", "timezone": "example" }'

• Production API

Request Body^required

Media typeapplication/json

Update a runtime account profile or its management lifecycle.

object

avatar_url

Profile image URL.

string | null

Example

https://example.com/avatar.png

description

Human-readable description. Safe to render in user-facing messages.

string | null

Example

Support team member

locale

Locale used for agent-facing defaults.

string | null

name

Human-readable name. Safe to render in user-facing messages.

string | null

Example

Alex

status

One of:

string

Current lifecycle status.

string

Allowed values: active archived deleted

null

null

timezone

IANA time zone used for agent-facing defaults.

string | null

Responses

200

Success

Media typeapplication/json

Organization-scoped runtime account with its own profile and connections.

object

archived_at

Archive timestamp.

string | null format: date-time

avatar_url

Optional avatar URL for UI surfaces.

string | null

created_at

required

Creation timestamp.

string format: date-time

deleted_at

Delete timestamp.

string | null format: date-time

description

Optional description shown in management UI.

string | null

effective_owner

One of:

object

Effective human owner summary derived from the principal lineage.

object

id

required

string

kind

required

Class of principal that can hold permissions or own resources. system is reserved for platform-internal callers and is never minted via the public API.

string

Allowed values: user virtual_user system

metadata

subject_id

string | null format: uuid

null

null

id

required

External identifier (identity_<32-hex>). Shown as id in API.

string

locale

Default locale for unattended runs.

string | null

name

required

Display name used when the identity acts autonomously.

string

organization_id

required

Organization that owns the runtime account.

string

principal

One of:

object

Principal row representing this identity as a durable owner/executor.

object

id

required

string

kind

required

Class of principal that can hold permissions or own resources. system is reserved for platform-internal callers and is never minted via the public API.

string

Allowed values: user virtual_user system

metadata

subject_id

string | null format: uuid

null

null

status

required

Lifecycle status.

string

Allowed values: active archived deleted

timezone

Default timezone for unattended runs.

string | null

updated_at

required

Last update timestamp.

string format: date-time

usage

required

Immutable runtime account purpose.

string

Allowed values: end_user service

Example

{
  "effective_owner": {
    "id": "principal_01933b5a000070008000000000000001",
    "kind": "user"
  },
  "id": "identity_01933b5a000070008000000000000001",
  "organization_id": "org_example",
  "principal": {
    "id": "principal_01933b5a000070008000000000000001",
    "kind": "user"
  },
  "status": "active",
  "usage": "end_user"
}

401

Authentication required

403

Permission denied