Create DNS zone

Create a new DNS zone within an existing organization.

POST

https://api.katapult.io/core/v1/organizations/{organization}/dns_zones

If successful, this endpoint will return a 201 Created status.

Scopes

One of the following scopes are required to use this endpoint.

The following arguments are supported for this endpoint.

Name	Type	Default Value
organization Required The organization to create the new DNS zone inside of	Organization Lookup	None
properties Required The details for the new DNS zone	DNSZoneArguments	None

Name

Type

Default Value

organization Required

The organization to create the new DNS zone inside of

None

properties Required

The details for the new DNS zone

None

The following errors may occur during this request.

Details	HTTP status
organization_not_activated An organization was found from the arguments provided but it wasn't activated yet	403 Forbidden
organization_not_found No organization was found matching any of the criteria provided in the arguments	404 Not Found
organization_suspended An organization was found from the arguments provided but it was suspended	403 Forbidden
permission_denied The authenticated identity is not permitted to perform this action	403 Forbidden
resource_creation_restricted The organization chosen is not permitted to create resources	403 Forbidden
validation_error A validation error occurred with the object that was being created/updated/deleted	422 Unprocessable Entity

When the request is successful, you can expect an object matching the specification below to be returned.

{
    dns_zone: DNSZone {
        id: String
        name: String
        default_ttl: Integer
        verified: Boolean
    }
}