# Account

Canonical HTML: https://anchorshell.com/docs/account

Update your profile, verify a new email address, and choose whether to receive product updates.

Last updated: 2026-09-17

Your account holds your profile, login identity, and email preferences. Changing your display name does not rename the shared Team or alter anyone else's access.

## Dashboard

1. Open **Account → Account**.
2. Edit your name and save.
3. Use the email-change action if you need a new address.
4. Open the verification email sent to the new address and confirm the change.

Password accounts can change email with their current password. For an account created with a login provider, use that provider's account settings.

The email-preference switch controls product updates. Turning it off does not disable verification, password-reset, or security messages.

## API

Use an appropriately scoped [API key](https://anchorshell.com/docs/api) for these requests.

### Read your account

```bash
curl 'https://api.anchorshell.com/api/account' \
  -H 'Authorization: Bearer <API_KEY>'
```

**Response — 200 OK**

Selected response fields shown; IDs and values are illustrative.

```json
{
  "user": {
    "id": "<USER_ID>",
    "name": "Your name",
    "email": "you@example.com",
    "status": "active",
    "marketing_opt_in": false
  },
  "org": {
    "id": "<ORG_ID>",
    "name": "Your team"
  },
  "role": "owner"
}
```

### Update your name

```bash
curl -X PATCH 'https://api.anchorshell.com/api/account' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Your name"
}'
```

**Response — 200 OK**

Selected response fields shown; IDs and values are illustrative.

```json
{
  "user": {
    "id": "<USER_ID>",
    "name": "Your name",
    "email": "you@example.com",
    "status": "active",
    "marketing_opt_in": false
  }
}
```

### Change email preference

```bash
curl -X PATCH 'https://api.anchorshell.com/api/account/preferences' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
  "marketing_opt_in": false
}'
```

**Response — 200 OK**

Selected response fields shown; IDs and values are illustrative.

```json
{
  "user": {
    "id": "<USER_ID>",
    "name": "Your name",
    "email": "you@example.com",
    "status": "active",
    "marketing_opt_in": false
  }
}
```

These operations require `cloud:account:manage`. Email changes remain in the dashboard because they use the password and browser-session security workflow.

## Next

[Security](https://anchorshell.com/docs/security).