> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.finrock.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit Whitelist

> Rename a whitelist or turn it on or off.

**[MCP scope](https://apidocs.finrock.io/api-reference/mcp-scopes.md):** `dac.write`

Use this endpoint to rename a whitelist or switch it on or off. Send all three fields, even if only one is changing.

Setting `is_active` to `false` switches the whole whitelist off without deleting it. Its addresses stop appearing in [List Active Whitelisted Addresses](https://apidocs.finrock.io/api-reference/whitelists/list-active-whitelisted-addresses.md) and you can't add addresses to it, but it still appears in [List Whitelists](https://apidocs.finrock.io/api-reference/whitelists/list-whitelists.md). Set `is_active` to `true` to switch it back on. To delete a whitelist instead, use [Remove Whitelist](https://apidocs.finrock.io/api-reference/whitelists/remove-whitelist.md).

## Body Parameters

**guid** `string` *required*

The ID of the whitelist, from [List Whitelists](https://apidocs.finrock.io/api-reference/whitelists/list-whitelists.md).

**title** `string` *required*

The name of the whitelist. Up to 200 characters, and not already used by another whitelist.

**is\_active** `boolean` *required*

`false` switches the whitelist off. `true` switches it on.

```bash cURL theme={null}
curl --request PATCH \
     --url https://api.finrock.io/dac/v1/whitelist \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "guid": "8fb22996-2cd1-4a2a-9773-ebfde21c6982",
       "title": "Cold wallets",
       "is_active": true
     }'
```

## Response

**code** `integer`

`1000` when the whitelist was updated.

**error** `string | null`

`null` on success.

**info** `string | null`

Additional information, if any. `null` on success.

```json 200 theme={null}
{
  "code": 1000,
  "error": null,
  "info": null
}
```

## Errors

| Status | When |
| - | - |
| `400` `INVALID_PAYLOAD` | A required field is missing, for example `is_active`. |
| `400` | The title is longer than 200 characters, or another whitelist already uses it. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.