# Update your organization profile

Source: <https://everruns.com/docs/api/operations/update_own_virtual_user_profile/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Identity & access](https://everruns.com/docs/api/groups/identity-access/)/Update your organization profile

# Update your organization profile

Preview

Update your own organization profile without changing lifecycle.

Public APIEverruns Cloud and self-hosted Platform

PATCH`/v1/virtual-users/{id}/self-profile`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Path Parameters

**id**

required

string

Prefixed public identifier

## Request Bodyrequired

Media typeapplication/json

Update a runtime account profile or its management lifecycle.

object

**avatar_url**

Profile image URL.

string | null

### Example

```plaintext
https://example.com/avatar.png
```

**description**

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

string | null

### Example

```plaintext
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

```plaintext
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

200Success

### 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

```json
{
  "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"
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/virtual-users/example/self-profile';
const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: '{"avatar_url":"https://example.com/avatar.png","description":"Support team member","locale":"example","name":"Alex","status":"active","timezone":"example"}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request PATCH \
  --url https://app.everruns.com/api/v1/virtual-users/example/self-profile \
  --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" }'
```

Additional language examples require JavaScript. The default request example is available above.

200

200 · Success

```json
{
  "created_at": "2026-10-12T09:00:00Z",
  "id": "identity_01933b5a000070008000000000000001",
  "name": "string",
  "organization_id": "org_example",
  "status": "active",
  "updated_at": "2026-10-12T09:00:00Z",
  "usage": "end_user"
}
```

## Matching endpoints