Modifying Name Servers
Knowledge Base
Modify Domain Name Servers Using the API
When you want to update the name servers of a domain registration order. This article explains how to modify domain name servers using the API, including optional OTP-based two-factor authentication for secure changes.
Description
Modifies the Name Servers of the specified Domain Registration Order.
Parameters
| Name | Data Type | Required / Optional | Description |
|---|---|---|---|
| auth-userid | Integer | Required | Authentication Parameter |
| api-key | String | Required | Authentication Parameter |
| order-id | Integer | Required | Order Id of the Domain Registration Order whose Name Servers you want to modify. |
| ns | Array of Strings | Required | New Name Servers. |
| otp | Integer | Optional | OTP to authenticate the request |
| 2fa-type | String | Optional | Type of 2FA authentication
|
HTTP Method
POST
Example Test URL Request
https://test.httpapi.com/api/domains/modify-ns.json?auth-userid=0&api-key=key&order-id=0&ns=ns1.domain.asia&ns=ns2.domain.asia
Example Test URL Request for OTP authentication
https://test.httpapi.com/api/domains/modify-ns.json?auth-userid=0&api-key=key&order-id=0&ns=ns1.domain.asia&ns=ns2.domain.asia&otp=123456&2fa-type=email
Response
Returns a hash map containing the below details:
-
Domain Name (description)
-
Order ID of the Domain Registration Order (entityid)
-
Action Type (actiontype)
-
Description of the Name Server Modification Action (actiontypedesc)
-
Action ID of the Name Server Modification Action (eaqid)
-
Name Server Modification Action Status (actionstatus)
-
Description of the Name Server Modification Action Status (actionstatusdesc)
In case of any errors, a status key with value as ERROR alongwith an error message will be returned.