POST api/Zone?user={user}

Create a new zone, only takes a name in the body, domain must exist and have namebay primary ns.

Request Information

URI Parameters

Name	Description	Type	Additional information
user	Optional user handle - if empty logged in user will be used	string	None.

Body Parameters

Zone to create

NewZone

Name	Description	Type	Additional information
Name	Zone name	string	Required String length: inclusive between 1 and 255

Name

Description

Type

Additional information

Name

Zone name

string

Required

String length: inclusive between 1 and 255

Request Formats

application/json, text/json

Sample:

{
  "Name": "sample string 1"
}

application/xml, text/xml

Sample:

<NewZone xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Zone">
  <Name>sample string 1</Name>
</NewZone>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

zone object on success
Collection of errors on failure
Return codes
200 - ok
300 - ambiguous
401 - unauthorized
404 - not found
500 - internal server error
707 - Zone already exists
712 - You're neither Owner, Tech, Admin nor Reseller of the domain
713 - You don't have Advanced DNS Management active for the domain
714 - The primary NS is not Namebay's

Zone

Name	Description	Type	Additional information
Handle	Zone handle	string	None.
Name	Zone name	string	Required String length: inclusive between 1 and 255
SoaExpire		integer	Range: inclusive between 1209600 and 2419200
SoaMinimum		integer	Range: inclusive between 3600 and 86400
SoaPrimaryNs		string	Required String length: inclusive between 1 and 200
SoaSerial	Used To refresh the zone, When the serial changes Bind knows the zone has to be refreshed. This field is updated automaticaly on zone changes	string	None.
SoaRefresh		integer	Range: inclusive between 1200 and 43200
SoaRespPerson		string	String length: inclusive between 0 and 200
SoaRetry		integer	Range: inclusive between 180 and 900
Ttl	Time to live	integer	Range: inclusive between 0 and 2147483647

Response Formats

application/json, text/json

Sample:

{
  "Handle": "sample string 1",
  "Name": "sample string 2",
  "SoaExpire": 3,
  "SoaMinimum": 4,
  "SoaPrimaryNs": "sample string 5",
  "SoaSerial": "sample string 6",
  "SoaRefresh": 7,
  "SoaRespPerson": "sample string 8",
  "SoaRetry": 9,
  "Ttl": 10
}

application/xml, text/xml

Sample:

<Zone xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Zone">
  <Handle>sample string 1</Handle>
  <Name>sample string 2</Name>
  <SoaExpire>3</SoaExpire>
  <SoaMinimum>4</SoaMinimum>
  <SoaPrimaryNs>sample string 5</SoaPrimaryNs>
  <SoaRefresh>7</SoaRefresh>
  <SoaRespPerson>sample string 8</SoaRespPerson>
  <SoaRetry>9</SoaRetry>
  <SoaSerial>sample string 6</SoaSerial>
  <Ttl>10</Ttl>
</Zone>