The EPP update command allows you to modify the attributes of a domain, account, nameserver or contact object.

Domains

In order to modify the attributes of a domain name, the update command must contain a <domain:update> element that identifies the domain namespace and location of the domain schema.

<domain:update> element

The domain:update element contains the following child elements:

• A <domain:name> element.
• An optional <domain:account> element containing an <account:update> element with account attributes to be modified. This is described below. Note that modifying account attributes will affect any other domain names that are associated with that account.
• An optional <domain:ns> element which contains the nameservers in order for the domain name after the modification. This contains one to ten elements containing a <domain:host> sub-element with the following child elements:
  • A <domain:hostName> element giving the name of the host object. 
  • Optional <domain:hostAddr> elements giving the ip addresses of the host object. This element should be provided only if the nameserver needs glue records. It should have an "ip" attribute of "v4" or "v6" indicating the ip version. A maximum of one ipv4 and one ipv6 address can be provided.
• An optional <domain:first-bill> element.
  
• An optional <domain:recur-bill> element.
  
• An optional <domain:auto-bill> or <domain:next-bill> element. Only one of these two elements should be present.
  
• An optional <domain:notes> element.
• An optional <domain:renew-not-required> element. Note that this is only available in the 1.2 versions of the nom- schemas.
• An optional <domain:reseller> element. Note that this is only available in the 2.0 versions of the nom- schemas

Example of a domain:update command

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
      epp-1.0.xsd">
   <command>
     <update>
      <domain:update
       xmlns:domain="http://www.nominet.org.uk/epp/xml/nom-domain-2.0"
       xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-2.0
       nom-domain-2.0.xsd">
       <domain:name>example.co.uk</domain:name>
       <domain:account>
        <account:update
         xmlns:account="http://www.nominet.org.uk/epp/xml/nom-account-2.0"
         xmlns:contact="http://www.nominet.org.uk/epp/xml/nom-contact-2.0">
         <account:contact>
          <contact:update>
           <contact:email>admin@strant.co.uk</contact:email>
          </contact:update>
         </account:contact>
        </account:update>
       </domain:account>
       <domain:ns>
        <domain:host>
          <domain:hostName>ns0.epp-example.com</domain:hostName>
        </domain:host>
        <domain:host>
         <domain:hostName>ns0.epp-example.co.uk</domain:hostName>
         <domain:hostAddr ip="v4">111.123.145.121</domain:hostAddr>
         <domain:hostAddr ip="v6">abcd::1234</domain:hostAddr>
        </domain:host>
       </domain:ns>
       <domain:auto-bill/>
       <domain:next-bill>5</domain:next-bill>
      </domain:update>
     </update>
     <clTRID>ABC-12345</clTRID>
   </command>
 </epp>

Example of a successful domain:update response

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
      epp-1.0.xsd">
   <response>
     <result code="1000">
       <msg>Command completed successfully</msg>
     </result>
     <trID>
       <clTRID>ABC-12345</clTRID>
       <svTRID>123456</svTRID>
     </trID>
   </response>
 </epp>

Registrant contacts

The EPP update command allows you to modify the attributes of a registrant contact object. You can modify any of the following field: 

• trad-name
• type
• co-no
• opt-out
• addresses
• contact name
• phone
• email address
  

account:update element

The update command must contain an account:update element that identifies the account namespace and location of the account schema. This element contains the following child elements:

• An <account:roid> element to contain the identifier of the account object to be modified. (Note this may be omitted when the account:update element sits inside a domain:update element).
• An optional <account:trad-name> element.
• An optional <account:type> element.
• An optional <account:co-no> element.
• An optional <account:opt-out> element.
• An optional <account:contact> elements containing a <contact:update> element described below
  
• An optional <account:addr> field with the following sub-elements:
  • <account:street>
  • <account:city>
  • <account:county>
  • <account:postcode>
  • <account:country>
    

<contact:update> element

• <contact:name>
• <contact:phone>
• <contact:mobile>
• <contact:email>
  

Example of an account:update command

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
      epp-1.0.xsd">
   <command>
     <update>
       <account:update
        xmlns:account="http://www.nominet.org.uk/epp/xml/nom-account-2.0"
        xmlns:contact="http://www.nominet.org.uk/epp/xml/nom-contact-2.0"
        xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-account-2.0
        nom-account-2.0.xsd">
         <account:roid>286467</account:roid>
         <account:trad-name>R. S. Industries</account:trad-name>
         <account:type>STRA</account:type>
         <account:co-no>NI123456</account:co-no>
         <account:contact>
           <contact:update>
             <contact:name>Ms S. Strant</contact:name>
             <contact:phone>01865 123457</contact:phone>
             <contact:email>s.strant@strant.co.uk</contact:email>
           </contact:update>
         </account:contact>
       </account:update>
     </update>
     <clTRID>ABC-12345</clTRID>
   </command>
 </epp>

Example of a successful account:update response

    <?xml version="1.0" encoding="UTF-8" standalone="no"?>
      <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
           epp-1.0.xsd">
        <response>
          <result code="1000">
            <msg>Command completed successfully</msg>
          </result>
          <trID>
            <clTRID>ABC-12345</clTRID>
            <svTRID>65789465</svTRID>
          </trID>
        </response>
      </epp>

Nameservers

• Modify the name field
• Modify the ipv4 field
• Modify the ipv6 field