Home ›
Registrars ›
Registrar Systems ›
Automaton ›
~ Modify object
Object modify operations can be used to make changes to the account, contact and nameserver objects in our registry. We recommend that you read about our object based data structure which will explain how modifying these objects differs from the standard domain modify. There are three different object modify operations available:
When you use an object modify operation, please be aware of the following:
You will receive a confirmation from the Automaton if the operation is successful.
You will receive an error from the Automaton if the operation is unsuccessful. For assistance identifying and resolving an unsuccessful operation, see the error messages page.
How to modify a nameserver object:
You will receive a confirmation from the Automaton if the operation is successful.
You will receive an error from the Automaton if the operation is unsuccessful. For assistance identifying and resolving an unsuccessful operation, see the error messages page.
- Account modify
Account modify is used to make changes to the fields we store in the account object, such as 'opt-out' settings. Any changes made using account modify will affect all domain names merged onto the account. Please see our account overview for more information.
- Nameserver modify
Nameserver modify is used to make changes to any of the fields we store in the nameserver object, such as the hostname of a nameserver. Any changes made using a nameserver modify will affect all domain names that use that nameserver. Please see our nameserver overview for more information.
When you use an object modify operation, please be aware of the following:
- Modifying an object will affect all of the domain names linked to that object.
Account modify
How to modify an account object:
- Create a new email message to applications@nic.uk
- Use the subject TAG account Modify (replace TAG with your tag name in capital letters).
- Copy the fields you require from the following template to your email message:
operation: modify
account-id:
trad-name:
type:
co-no:
opt-out:
addr:
locality:
city:
county:
postcode:
country:
a1-id:
a1-name:
a1-email:
a1-phone:
Notes:
- It is mandatory to include values for the 'operation:' and 'account-id:' fields. For more information on template fields, see our field definitions.
- We also require all accounts to have values set for the 'addr:', 'country:', 'a1-name:' and 'a1-email:' fields. These fields cannot be set to 'NULL'.
- The 'postcode:' field is required if the country code is GB, JE, GG or IM.
- The 'co-no:' field is required if modifying a net.uk, ltd.uk or a plc.uk domain name. This field is also required for certain values of the 'type' field.
- All other fields are optional and will be ignored by the Automaton if left blank.
- Optional contacts can be removed by setting their email field to 'NULL'.
- The values for optional fields can be removed by setting them to 'NULL'.
- To modify multiple accounts, you can repeat the account modify template separated by a blank line up to 100 times.
- PGP sign the message and send the email.
You will receive a confirmation from the Automaton if the operation is successful.
You will receive an error from the Automaton if the operation is unsuccessful. For assistance identifying and resolving an unsuccessful operation, see the error messages page.
Nameserver modify
How to modify a nameserver object:
- Create a new email message to applications@nic.uk
- Use the subject TAG nameserver Modify (replace TAG with your tag name in capital letters).
- Paste the following template into your email message:
operation: modify
dns-name:
dns:
Notes:
- The dns-name: field should contain the existing host name of the nameserver to be modified
- The dns: field should contain the desired details of the nameserver after the modification.
- It is not possible to modify a nameserver to use a hostname which is used by another nameserver.
- It is only possible to modify a nameserver object if one or both of the following conditions is true:
- You have the super-ordinate domain name registered to your tag.
- All domain names linked to the nameserver are registered to your tag.
- It is mandatory to include values for all the fields in this template. For more information on template fields, see our field definitions.
- To modify multiple nameservers, you can repeat nameserver modify template separated by a blank line up to 100 times.
- PGP sign the message and send the email.
You will receive a confirmation from the Automaton if the operation is successful.
You will receive an error from the Automaton if the operation is unsuccessful. For assistance identifying and resolving an unsuccessful operation, see the error messages page.
Nameserver modify example
In this example, the nameserver object 'ns0.example.co.uk' will be modified to use the hostname 'ns2.example.co.uk' and the IP address 121.121.121.121. All domain names linked to this nameserver object will be affected by this modification.operation: modify
dns-name: ns0.example.co.uk
dns: ns2.example.co.uk 121.121.121.121
More pages
- Acceptable Use Policy
- Automaton Options
- Deprecated Fields
- Error Messages
- Field definitions
- FAQ
- Email notifications
- Operations Overview
- ~ Create
- ~ Delete
- ~ Fork
- ~ List
- ~ Modify
- ~ Query
- ~ Receive
- ~ Release
- ~ Renew
- ~ Tag list
- ~ Lock - investigation
- ~ Lock - opt-out
- ~ Unlock
- ~ Unrenew
- ~ Bulk
- DNSSEC Operations
- PGP Key
- Responses
Related contacts
For questions from our members and registrars Telephone: 01865 332233 Email: support@nominet.org.uk To make a payment Telephone: 01865 332348 Email: payments@nominet.org.uk Emergency out of hours support for registrars Telephone: 01606 866663
If you need any more advice, request a call back and discuss your query with one of our advisors.
Request call back ›