Home
/
API reference
/
API reference
/
Domain

Domain update

EPP API · Updated 2023-09-26

Description

The domain update command allows you to change the information of an existing domain.

The XML tag <hostObj> is not supported.

When removing a name server, you do not have to submit the IP addresses.

The registrant contact can only be changed under certain circumstances and may occur costs.

The number of possible IPv4 and IPv6 addresses of a name server depends on the chosen TLD.

Note

In certain cases an AuthInfo is required to change the registrant.

XML example

<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <command>
        <update>
            <domain:update xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
                <domain:name>example.com</domain:name>
                <domain:add>
                    <domain:ns>
                        <domain:hostAttr>
                            <domain:hostName>ns3.example.com</domain:hostName>
                            <domain:hostAddr ip="v4">192.0.2.2</domain:hostAddr>
                            <domain:hostAddr ip="v6">2001:DB8:0:0:8:800:200C:417A</domain:hostAddr>
                        </domain:hostAttr>
                        <domain:hostAttr>
                            <domain:hostName>ns4.example.com</domain:hostName>
                            <domain:hostAddr ip="v4">192.0.2.2</domain:hostAddr>
                            <domain:hostAddr ip="v6">2001:DB8:0:0:8:800:200C:417A</domain:hostAddr>
                        </domain:hostAttr>
                    </domain:ns>
                    <domain:contact type="admin">23024141</domain:contact>
                    <domain:contact type="tech">23024141</domain:contact>
                    <domain:status s="clientHold" lang="en">Payment overdue.</domain:status>
                </domain:add>
                <domain:rem>
            <domain:ns>
                <domain:hostAttr>
                    <domain:hostName>ns1.example.com</domain:hostName>
                </domain:hostAttr>
                <domain:hostAttr>
                	<domain:hostName>ns2.example.com</domain:hostName>
                </domain:hostAttr>
            </domain:ns>    
                </domain:rem>
            </domain:update>
        </update>
        <clTRID>ABC-12345</clTRID>
    </command>
</epp>

<epp xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:domainrobot="urn:org:domainrobot:ns:ext-1.0" xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" xmlns:ro="urn:org:domainrobot:ns:contact:ro-1.0" xmlns:xxx="urn:org:domainrobot:ns:contact:xxx-1.0" xmlns:ca="urn:org:domainrobot:ns:contact:ca-1.0" xmlns:cat="urn:org:domainrobot:ns:contact:cat-1.0" xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:jobs="urn:org:domainrobot:ns:contact:jobs-1.0" xmlns:rgp="urn:ietf:params:xml:ns:rgp-1.0" xmlns:aero="urn:org:domainrobot:ns:contact:aero-1.0" xmlns:host="urn:ietf:params:xml:ns:host-1.0" xmlns:hk="urn:org:domainrobot:ns:contact:hk-1.0" xmlns:bank="urn:org:domainrobot:ns:contact:bank-1.0" xmlns:it="urn:org:domainrobot:ns:contact:it-1.0" xmlns:barcelona="urn:org:domainrobot:ns:contact:barcelona-1.0" xmlns:au="urn:org:domainrobot:ns:contact:au-1.0" xmlns:uk="urn:org:domainrobot:ns:contact:uk-1.0" xmlns:swiss="urn:org:domainrobot:ns:contact:swiss-1.0" xmlns:ru="urn:org:domainrobot:ns:contact:ru-1.0">
    <response>
        <result code="1001">
            <msg lang="en">Command completed successfully; action pending</msg>
        </result>
        <trID>
            <clTRID>ABC-12345</clTRID>
            <svTRID>20170731-app1-1001</svTRID>
        </trID>
    </response>
</epp>

Request with change of registrant

<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <command>
        <update>
            <domain:update xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
                <domain:name>example.com</domain:name>
                <domain:chg>
                    <domain:registrant>1</domain:registrant>
                    <domain:authInfo>
                        <domain:pw>2BARfoo</domain:pw>
                    </domain:authInfo>
                </domain:chg>
            </domain:update>
        </update>
        <clTRID>ABC-12345</clTRID>
    </command>
</epp>