# Update tokens

You can update token details in Ripple Custody using the `v0_UpdateTicker` intent. This allows you to modify token metadata such as the display name or symbol.

## What you can update

| Field | Updatable | Notes |
|  --- | --- | --- |
| `name` | Yes | Token display name |
| `symbol` | Yes | Token ticker symbol |
| `ledgerId` | No | Cannot be changed after creation |
| `kind` | No | Cannot be changed after creation |
| `decimals` | No | Cannot be changed after creation |
| `ledgerDetails` | No | Cannot be changed after creation |


## Prerequisites

Before updating a token, you need the following:

| Prerequisite | Additional information |
|  --- | --- |
| Token ID and current revision | [View tokens](/products/custody/v1.34/api/accounting-entities/token-management/view) |
| API authentication | [Authentication](/products/custody/v1.34/api/authentication) |
| A new intent ID in UUID format |  |


## Update a token

To update token details, follow the steps in [Request a change with an intent](/products/custody/v1.34/resources/tutorials/intent), with a payload similar to the following example.

### Payload example


```json
{
  "payload": {
    "name": "Updated Token Name",
    "symbol": "UTN",
    "type": "v0_UpdateTicker"
  },
  "reference": {
    "id": "ticker-uuid",
    "revision": 1
  }
}
```

### Payload fields

| Field | Type | Required | Description |
|  --- | --- | --- | --- |
| `payload.name` | string | No | Updated token display name |
| `payload.symbol` | string | No | Updated token ticker symbol |
| `payload.type` | string | Yes | Must be `v0_UpdateTicker` |
| `reference.id` | UUID | Yes | Token ID from [Get ticker](https://docs.ripple.com/products/custody/api/reference/openapi/tickers/getticker) |
| `reference.revision` | integer | Yes | Current token revision (from the ticker response) |


Only include the fields you want to update. Omitted fields retain their current values.

The token is updated when the intent is successfully approved and executed.

## Verify the result

After the intent is executed, verify the token was updated:


```http
GET /v1/tickers/{tickerId}
```

See [Get ticker](https://docs.ripple.com/products/custody/api/reference/openapi/tickers/getticker) for the complete API reference.

## Related topics

- [Token Management concepts](/products/custody/v1.34/concepts/token-management)
- [View tokens](/products/custody/v1.34/api/accounting-entities/token-management/view)
- [Add tokens](/products/custody/v1.34/api/accounting-entities/token-management/add)
- [Request a change with an intent](/products/custody/v1.34/resources/tutorials/intent)
- [API reference: List tickers](https://docs.ripple.com/products/custody/api/reference/openapi/tickers/gettickers)
- [API reference: Get ticker](https://docs.ripple.com/products/custody/api/reference/openapi/tickers/getticker)