---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/api/errors/21630#article
headline: "21630: Cannot mutate Address that is linked to a verified Document."
url: https://www.twilio.com/docs/api/errors/21630
inLanguage: en
dateModified: 2026-06-09T11:00:42.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 21630: Cannot mutate Address that is linked to a verified Document.

Log Level: ERROR

## Description

This error occurs when you try to update an existing address that is already tied to verified regulatory compliance data. Some regulatory workflows require an `AddressSid` on a Supporting Document, and addresses already linked to regulatory compliance or emergency address registration cannot be modified or revalidated in place.

### Possible causes

* You sent a `POST` update to an existing address after that address had already been linked to a verified Supporting Document used for regulatory compliance.
* The address is already associated with phone numbers for regulatory compliance, so Twilio blocks direct edits to preserve the approved compliance record. ([help.twilio.com](https://help.twilio.com/articles/31156886116891))
* The address is already being used for emergency address registration, which also prevents modifying or revalidating the existing record. ([help.twilio.com](https://help.twilio.com/articles/31156886116891))

### Possible solutions

* Create a new address with the corrected details instead of updating the existing linked address. Then use the new `AddressSid` anywhere an address is required.
* Before replacing the address, list the phone numbers that depend on it with `GET /2010-04-01/Accounts/{AccountSid}/Addresses/{AddressSid}/DependentPhoneNumbers.json`.
* Update the phone number or provisioning request to reference the new `AddressSid` so the correct address is mapped to the number. ([help.twilio.com](https://help.twilio.com/articles/31155205145243))
* If the address is part of approved regulatory compliance information that must change, create a Bundle Copy, update the copied compliance items, submit the copy for review, and then replace the items on the original bundle after approval.

#### Additional resources

* [REST API: Addresses](/docs/usage/api/address)
* [IncomingPhoneNumber resource](/docs/phone-numbers/api/incomingphonenumber-resource)
* [API Getting Started: Compliance Information Update](/docs/phone-numbers/regulatory/getting-started/api-getting-started-compliance-information-update)
