PUT api/Zone/{zone_handle}/Record/{id}?user={user}

Update a record belonging to a zone with the given record id

Request Information

URI Parameters

Name	Description	Type	Additional information
zone_handle	Handle of zone	string	Required
id	Id of record	integer	Required
user	Optional user handle - if empty logged in user will be used	string	None.

Body Parameters

Details to update

Record

Name	Description	Type	Additional information
Id	Record id	integer	None.
ZoneId	Zone id	integer	None.
Host	Host	string	Required String length: inclusive between 1 and 200
Data	Data	string	Required String length: inclusive between 1 and 4096
Type	Record type	string	Required String length: inclusive between 1 and 8
Weight	Weight for MX records	integer	None.
DateCreated	Date created	date	None.
NaptrPreference		string	None.
NaptrFlag		string	None.
NaptrRegExp		string	None.

Request Formats

application/json, text/json

Sample:

{
  "Id": 1,
  "ZoneId": 2,
  "Host": "sample string 3",
  "Data": "sample string 4",
  "Type": "sample string 5",
  "Weight": 1,
  "DateCreated": "2025-11-05T13:07:16.8415574+01:00",
  "NaptrPreference": "sample string 7",
  "NaptrFlag": "sample string 8",
  "NaptrRegExp": "sample string 9"
}

application/xml, text/xml

Sample:

<Record xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Zone">
  <Data>sample string 4</Data>
  <DateCreated>2025-11-05T13:07:16.8415574+01:00</DateCreated>
  <Host>sample string 3</Host>
  <Id>1</Id>
  <NaptrFlag>sample string 8</NaptrFlag>
  <NaptrPreference>sample string 7</NaptrPreference>
  <NaptrRegExp>sample string 9</NaptrRegExp>
  <Type>sample string 5</Type>
  <Weight>1</Weight>
  <ZoneId>2</ZoneId>
</Record>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'Record'.

Response Information

Resource Description

record object on success
Collection of errors on failure
Return codes
200 - ok
300 - ambiguous
401 - unauthorized
404 - not found
500 - internal server error
702 - Zone not found
703 - Zone is inactive
704 - Record malformed (type unknown)
705 - Record not added to zone
706 - Unexpected error
712 - You're neither Owner, Tech, Admin nor Reseller of the domain
713 - You don't have Advanced DNS Management active for the domain
715 - The record doesn't belong to the zone
716 - The record is invalid for the zone

Record

Name	Description	Type	Additional information
Id	Record id	integer	None.
ZoneId	Zone id	integer	None.
Host	Host	string	Required String length: inclusive between 1 and 200
Data	Data	string	Required String length: inclusive between 1 and 4096
Type	Record type	string	Required String length: inclusive between 1 and 8
Weight	Weight for MX records	integer	None.
DateCreated	Date created	date	None.
NaptrPreference		string	None.
NaptrFlag		string	None.
NaptrRegExp		string	None.

Response Formats

application/json, text/json

Sample:

{
  "Id": 1,
  "ZoneId": 2,
  "Host": "sample string 3",
  "Data": "sample string 4",
  "Type": "sample string 5",
  "Weight": 1,
  "DateCreated": "2025-11-05T13:07:16.8571895+01:00",
  "NaptrPreference": "sample string 7",
  "NaptrFlag": "sample string 8",
  "NaptrRegExp": "sample string 9"
}

application/xml, text/xml

Sample:

<Record xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Zone">
  <Data>sample string 4</Data>
  <DateCreated>2025-11-05T13:07:16.8571895+01:00</DateCreated>
  <Host>sample string 3</Host>
  <Id>1</Id>
  <NaptrFlag>sample string 8</NaptrFlag>
  <NaptrPreference>sample string 7</NaptrPreference>
  <NaptrRegExp>sample string 9</NaptrRegExp>
  <Type>sample string 5</Type>
  <Weight>1</Weight>
  <ZoneId>2</ZoneId>
</Record>