---
title: "Domain update"
url: "https://help.internetx.com/en/api/core-domain-update/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Tasks > Domain tasks"
updated: "2023-09-18"
---

# Domain update

## Function

The task _DomainUpdate_ updates the data of a domain.

With the _DomainUpdatePlus_ task, unlike _DomainUpdate_, you can specify the data of a domain contact (handle) in order to have it created automatically. If a contact already exists with this data, a new one is not created, but the existing one is used. Within the "Domain" element all keywords are possible, which you can also use for the _DomainUpdate_. In the respective domain contact elements (ownerc, adminc, techc, zonec) you can use all keywords that are also valid when editing a domain contact.

If you do not specify certain keywords, they are loaded from the database.

If an ownerchange is sent to the system, an existing AuthInfo1 is deleted. If there is a cancelation order of type PREACK in the system, a new AuthInfo1 is automatically generated.

The keywords for the domain element are described on the [Domain](/en/api/core-domain-object/) object page.  
The keywords for the domain contact elements (ownerc, adminc, techc, zonec) for the DomainCreatePlus task are described on the [Contact](/en/api/core-contact-object/) page.  
The keyword description for DNSSsec can be found on the [DNSSec](/en/api/core-dnssec-object/) object page.  

## Description

Route: PUT /domain/ {name}

```
{
   "name": "example.com",
   "ownerc": {
      "id": 23142212
   },
   "adminc": {
      "id": 21606248
   },
   "techc": {
      "id": 21606248
   },
   "confirmOrder": false,
   "nameServers": [
      {
         "name": "ns1.example.com"
      },
      {
         "name": "ns2.example.com"
      }
   ]
}
```

```
{
    "stid": "20190701-app3-dev-9048",
    "status": {
        "code": "N0102",
        "text": "Domain update has been started successfully.",
        "type": "NOTIFY"
    },
    "object": {
        "type": "Domain",
        "value": "example.com"
    },
    "data": [
        {
            "created": "2019-07-01T09:41:58.000+0200",
            "updated": "2019-07-01T09:41:58.000+0200",
            "owner": {
                "context": 4,
                "user": "customer"
            },
            "updater": {
                "context": 4,
                "user": "customer"
            },
            "status": "RUNNING",
            "execution": "2019-07-01T09:41:57.000+0200",
            "id": 4297543151
        }
    ]
}
```

Task code: 0102  
Uses [Domain](/en/api/core-domain-object/) object  

**Single request**  

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0102</code>
		<domain>
			<name>example.com</name>
			<ownerc>9925345</ownerc>
			<adminc>9925345</adminc>
			<techc>9925346</techc>
			<zonec>9925346</zonec>
			<nserver>
				<name>ns1.example.com</name>
			</nserver>
			<nserver>
				<name>ns2.example.com</name>
				<ip>172.16.100.1</ip>
				<ip6>2001:0DB8::1</ip6>
			</nserver>
			<use_privacy>1</use_privacy>
			<confirm_owner_consent>1</confirm_owner_consent>
			<dnssec>
				<flags>257</flags>
				<protocol>3</protocol>
				<algorithm>5</algorithm>
				<publickey>key...</publickey>
			</dnssec>
		</domain>
		<reply_to>customer@example.com</reply_to>
	</task>
</request>
```

```
<response>
	<result>
		<data>
			<domain_job>
				<job>
					<id>4295210826</id>
					<status>NOT_SET</status>
				</job>
			</domain_job>
		</data>
		<status>
			<code>N0102</code>
			<text>Domain update has been started successfully.</text>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.com</value>
			</object>
		</status>
	</result>
	<stid>20180213-app2-17296</stid>
</response>
```

**Bulk request**

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0102</code>
		<ctid></ctid>
		<default>
			<ownerc>9925345</ownerc>
			<adminc>9925345</adminc>
			<techc>9925345</techc>
			<zonec>9925345</zonec>
			<nserver>
				<name>ns1.example.org</name>
				<ip>172.16.100.1</ip>
			</nserver>
			<nserver>
				<name>ns2.example.org</name>
				<ip>172.16.100.2</ip>
			</nserver>
			<dns_checks>soa</dns_checks>
			<confirm_owner_consent>1</confirm_owner_consent>
		</default>
		<domain>
			<name>example.org</name>
		</domain>
		<domain>
			<name>example.net</name>
		</domain>
		<domain>
			<name>example.biz</name>
		</domain>
		<reply_to>customer@example.com</reply_to>
	</task>
</request>
```

```
<response>
	<result>
		<msg>
			<text>Domain update has been started successfully.</text>
			<code>N0102</code>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.org</value>
			</object>
		</msg>
		<msg>
			<text>Domain update has been started successfully.</text>
			<code>N0102</code>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.net</value>
			</object>
		</msg>
		<msg>
			<text>Domain update has been started successfully.</text>
			<code>N0102</code>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.biz</value>
			</object>
		</msg>
		<status>
			<code>N0102001</code>
			<text>Domain update has been started successfully.</text>
			<type>notify</type>
		</status>
	</result>
	<ctid/>
	<stid>20180213-app3-10304</stid>
</response>
```