Zum Inhalt springen
NimbusNexus

DNS zones

A DNS zone is an authoritative domain hosted on NimbusNexus nameservers. Create a zone for example.com, point your domain registrar at our nameservers, then add records to publish addresses, mail routing, and verification tokens for that domain.

Delegation

After creating a zone, the response carries the four nameservers you need to configure at your registrar:

ns1.dns.nimbusnexus.net
ns2.dns.nimbusnexus.net
ns3.dns.nimbusnexus.net
ns4.dns.nimbusnexus.net

Set these as the NS records for your domain at your registrar (GoDaddy, Cloudflare Registrar, Porkbun, etc.). Once propagation completes (typically minutes to a few hours, depending on the registrar's TTLs), our nameservers become authoritative for the domain.

You can keep using your existing DNS provider in parallel during a migration — both providers' NS records can coexist for a short period if you set the registrar to use both sets, then drop the old set once you've moved every record.

Zone vs subdomain

One zone = one domain. example.com is one zone; api.example.com is a subdomain handled by an A or CNAME record inside the example.com zone, not a separate zone — unless you specifically want to delegate api.example.com to a different DNS provider, in which case you'd create both example.com (with NS records pointing at the other provider for the subdomain) and the subdomain zone separately.

For typical use, one zone per registered domain is the right shape.

DNSSEC

DNSSEC is enabled by default on every zone we host. The DS records to publish at your registrar are returned in the zone record and can be re-fetched at any time. We rotate ZSK + KSK on a 90-day cadence; KSK rollovers require a DS update at the registrar.

Pricing

  • Zones: $0.50 per zone per month.
  • Queries: First 1 million queries/month free per zone, $0.40 per million after.

For comparison: Cloudflare's authoritative DNS is free at the basic tier, Route 53 is $0.50/zone + per-query, AWS Cloud Map is more expensive. Our pricing puts us between Cloudflare and Route 53.

What's next

Reference

GET/api/v1/zones/

Zones List

Lists DNS zones accessible to the calling project.

Parameters

NameInRequiredDescription
namequeryno—
emailqueryno—
statusqueryno—
descriptionqueryno—
ttlqueryno—
limitqueryno—
markerqueryno—

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/

POST/api/v1/zones/

Zone Create

Creates a new DNS zone for the calling project.

Request body

JSON body required.

Responses

  • 201Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/

GET/api/v1/zones/artifacts

Get Zones Create Artifacts

Returns the DNS zone domain artifacts available for zone creation.

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/artifacts

GET/api/v1/zones/{zone_id}

Zone Retrieve

Retrieves a single DNS zone by its identifier.

Parameters

NameInRequiredDescription
zone_idpathyes—

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}

PUT/api/v1/zones/{zone_id}

Zone Update

Updates the editable attributes of a DNS zone.

Parameters

NameInRequiredDescription
zone_idpathyes—

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}

DELETE/api/v1/zones/{zone_id}

Zone Delete

Deletes a DNS zone, optionally removing its shares first.

Parameters

NameInRequiredDescription
zone_idpathyes—
delete_sharesquerynoDelete all zone shares before deleting the zone

Responses

  • 204Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}

GET/api/v1/zones/{zone_id}/shares/

Shared Zones List

Lists the projects a DNS zone is shared with.

Parameters

NameInRequiredDescription
zone_idpathyes—
admin_domainqueryno—
admin_projectqueryno—
target_project_idqueryno—
limitqueryno—
markerqueryno—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}/shares/

POST/api/v1/zones/{zone_id}/shares/

Shared Zones Create

Shares a DNS zone with another project.

Parameters

NameInRequiredDescription
zone_idpathyes—

Request body

JSON body required.

Responses

  • 201Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}/shares/

GET/api/v1/zones/{zone_id}/shares/{shared_zone_id}

Shared Zone Retrieve

Retrieves details of a single DNS zone share.

Parameters

NameInRequiredDescription
zone_idpathyes—
shared_zone_idpathyes—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}/shares/{shared_zone_id}

DELETE/api/v1/zones/{zone_id}/shares/{shared_zone_id}

Shared Zone Delete

Revokes a DNS zone share from a target project.

Parameters

NameInRequiredDescription
zone_idpathyes—
shared_zone_idpathyes—

Responses

  • 204Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}/shares/{shared_zone_id}

Need to make a real call? Try these endpoints in the live Swagger UI →