PUT api/NameServer/{id}?user={user}
Change the ip addresses of a name server
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Name server id |
decimal number |
Required |
| user |
Optional user handle - if empty logged in user will be used |
string |
None. |
Body Parameters
Ip addresses
UpdateNameServer| Name | Description | Type | Additional information |
|---|---|---|---|
| Ip1 |
Primary ip address |
string |
Required |
| Ip2 |
Second ip address |
string |
None. |
| Name | string |
None. |
|
| Registry |
Registry info |
string |
None. |
Request Formats
application/json, text/json
{
"Ip1": "sample string 1",
"Ip2": "sample string 2",
"Name": "sample string 3",
"Registry": "sample string 4"
}
application/xml, text/xml
<UpdateNameServer xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Domain"> <Ip1>sample string 1</Ip1> <Ip2>sample string 2</Ip2> <Name>sample string 3</Name> <Registry>sample string 4</Registry> </UpdateNameServer>
application/x-www-form-urlencoded
Response Information
Resource Description
Nameserver object on success
Collection of errors on failure
Return codes
200 - ok
300 - ambiguous
400 - bad request
401 - unauthorized
404 - not found
500 - internal server error
510 - object does not exist
525 - object already registered
530 - invalid attribute value
550 - parameter value policy error
570 - object status does not allow for operation
581 - command failed
| Name | Description | Type | Additional information |
|---|---|---|---|
| Id | decimal number |
None. |
|
| Name | string |
Required |
|
| Ip1 |
Primary ip address |
string |
None. |
| Ip2 |
Second ip address |
string |
None. |
| Registries |
Registry info |
Collection of NSHandle |
None. |
Response Formats
application/json, text/json
{
"Id": 1.0,
"Name": "sample string 2",
"Ip1": "sample string 3",
"Ip2": "sample string 4",
"Registries": [
{
"Registry": "sample string 1",
"Handle": "sample string 2",
"RegisterDate": "2025-12-12T19:16:11.404485+01:00"
}
]
}
application/xml, text/xml
<NameServer xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Domain">
<Id>1</Id>
<Ip1>sample string 3</Ip1>
<Ip2>sample string 4</Ip2>
<Name>sample string 2</Name>
<Registries>
<NSHandle>
<Handle>sample string 2</Handle>
<RegisterDate>2025-12-12T19:16:11.404485+01:00</RegisterDate>
<Registry>sample string 1</Registry>
</NSHandle>
</Registries>
</NameServer>