> For the complete documentation index, see [llms.txt](https://api.docs.fan/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.docs.fan/profile/legacy/update.md).

# Update

{% hint style="warning" %}
**Legacy endpoint.** For preferences, favorites, and other profile data, prefer the v2 profile endpoints. Use this only for account fields not yet available in v2 (login email, phone, address, 2FA settings).
{% endhint %}

Use this endpoint to update an existing FanID account. Only the fields present in the body are changed.

### Required Scopes

`account:update`

## Request

### URL

`PATCH /v1/{ID}`

### Path Parameters

| Name | Required | Description                                                                                                                            |
| ---- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `ID` | true     | Unique FanID for the customer's account (tenant-specific). This value is a property of the ID Token returned in the SSO login process. |

### Headers

<table><thead><tr><th width="177">Name</th><th>Description</th></tr></thead><tbody><tr><td>Authorization</td><td>User or server-to-server access Bearer token.</td></tr></tbody></table>

### Data

<table><thead><tr><th width="280">Name</th><th width="104" data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td>first_name</td><td>false</td><td>The account holder's first name.</td></tr><tr><td>last_name</td><td>false</td><td>The account holder's last name.</td></tr><tr><td>email.address</td><td>false</td><td>New login email address.</td></tr><tr><td>phone.number</td><td>false</td><td>New login phone number. E.164 format preferred; other common formats are accepted.</td></tr><tr><td>phone.country</td><td>false</td><td>ISO 3166-1 alpha-2 country for the phone number. If blank, determined from the number's country code.</td></tr><tr><td>address</td><td>false</td><td>Postal address object: <code>address_line_1</code>, <code>address_line_2</code>, <code>city</code>, <code>subdivision</code>, <code>postal_code</code>, <code>country</code>.</td></tr><tr><td>preferred_language</td><td>false</td><td>The account holder's preferred language.</td></tr><tr><td>require_login_2fa</td><td>false</td><td>Whether MFA is required on every login.</td></tr><tr><td>set_login_factor_default</td><td>false</td><td>Sets the preferred default 2FA method (<code>email</code> or <code>sms</code>). May only be set if <code>login_factor_default_exists</code> is false on the account, and the requested factor must be verified.</td></tr></tbody></table>

## Response

Returns `200 OK` with an empty object on success.

## Full Spec

{% openapi src="/files/Rvz5AclbuaMMsKqc2MTO" path="/v1/{ID}" method="patch" %}
[openapi-profile-gw.json](https://3657007978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1G9XmPfyfOHS6i6FdlzL%2Fuploads%2Fgit-blob-a68e994e124ac5da5f3535adc09057feef8b39a3%2Fopenapi-profile-gw.json?alt=media)
{% endopenapi %}