# 21 Domains API: How to update domain's attributes

*This is a series of articles dedicated to demonstrating how to get acquainted with Openprovider Domains API methods.* *To get more information about our API in general, please use our [documentation portal](https://docs.openprovider.com) as your reference.*

If you need to modify contact data of the domain or the nameservers as well as to set or remove a transfer lock or special parameters associated with the domain, you should utilise Update Domain method of the API.

<div id="bkmrk-use-endpoint-path-be">![Entering Geo Fence icon](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-skqgrdiw.png)Use endpoint path below. Base URL is determined by both the target environment and API version.</div><div id="bkmrk-put-%7Bbase_url%7D%2Fdomai">```
<span><strong>PUT</strong> <a href="http://docs.openprovider.com/#operation/"><strong>{base_url}</strong></a>/domains/{id}</span>
```

</div><div id="bkmrk-request-values-name-"><details><summary>REQUEST VALUES</summary>

<table><tbody><tr><td>**<span>Name</span>**</td><td>**<span>Type</span>**</td><td>**<span>Description</span>**</td></tr><tr><td>domain</td><td>string</td><td>Optional.</td></tr><tr><td>auth\_code</td><td>varchar</td><td>Optional.</td></tr><tr><td>owner\_handle</td><td>varchar</td><td>Optional.</td></tr><tr><td>admin\_handle</td><td>varchar</td><td>Optional.</td></tr><tr><td>tech\_handle</td><td>varchar</td><td>Optional.</td></tr><tr><td>billing\_handle</td><td>varchar</td><td>Optional.</td></tr><tr><td>reseller\_handle</td><td>varchar</td><td>Optional.</td></tr><tr><td>ns\_group</td><td>string</td><td>Optional.</td></tr><tr><td>ns\_template\_name</td><td>string</td><td>Optional. N<span>ame of the template to use to automatically create DNS zone for the domain; only applicable if nsGroup is </span>*dns-openprovider*</td></tr><tr><td>ns\_template\_id</td><td>integer</td><td>Optional.</td></tr><tr><td>name\_servers</td><td>dot separated integer</td><td>Required only if nsGroup field is empty</td></tr><tr><td>autorenew</td><td>custom</td><td>*on | off | default* </td></tr><tr><td>is\_dnssec\_enabled</td><td>boolean</td><td>0 (default) or 1 - Only accepted when nameservers of Openprovider are used</td></tr><tr><td>dnssec\_keys</td><td>varchar</td><td>when using your own nameservers</td></tr><tr><td>use\_domicile</td><td>boolean</td><td>0 or 1</td></tr><tr><td><span>accept\_premium\_fee</span></td><td>int or double</td><td>Required in case when domain is premium, value is the price returned in the response for createDomainRequest without acceptPremiumFee</td></tr><tr><td>is\_private\_whois\_enabled </td><td>boolean</td><td>default value is 0</td></tr><tr><td>is\_locked</td><td>boolean</td><td>default value is 0</td></tr></tbody></table>

</details>***NB** The owner, admin and tech handles can be retrieved via the [customers endpoint](https://openprovider.help/books/api-plugins/page/7-customers-api-how-to-get-an-existing-handle) and will be the registered contacts for this domain.*

<div id="bkmrk-request-examplecurl-"><div><details><summary>REQUEST EXAMPLE</summary>

```
curl -X PUT \<br></br> 'http://api.openprovider.eu/v1beta/domains/123456' \<br></br> -H 'Accept: */*' \<br></br> -H 'Authorization: ,Bearer 2f4c1c3a9******15d22b378a64' \<br></br> -H 'Connection: keep-alive' \<br></br> -H 'Content-Type: application/json' \<br></br> -d '{<br></br> "admin_handle": "XX123456-XX",<br></br> "auth_code": "2FIXQ63NCQNT",<br></br> "autorenew": "default",<br></br> "comments": "Any comments go",<br></br> "domain": {<br></br> "extension": "com",<br></br> "name": "domain",<br></br> },<br></br> "is_locked": true,<br></br> "is_private_whois_enabled": false,<br></br> "is_spamexperts_enabled": true,<br></br> "ns_template_name": "Default",<br></br> "owner_handle": "XX123456-XX",<br></br> "reseller_handle": "XX123456-XX",<br></br>}
```

</details></div><details><summary>RESPONSE EXAMPLE</summary>

```
{<br></br> "data": {<br></br> "id": 11195838,<br></br> "status": "ACT"<br></br> }<br></br>}
```

</details></div></div>