Regenerate Domain Nameservers

Creates new Cloudflare zones and generates fresh nameservers for domains that need reconfiguration.

When to Use This Endpoint

This endpoint handles two scenarios:

1. Expired Propagation (`status: 'expired_propagation'`)

Domains where the initial DNS propagation timed out. This typically happens when nameservers weren't configured at the registrar within 12 hours.

2. Moved Nameservers (`nameserver_match_status: 'moved'`)

Domains where our monitoring detected that nameservers at the registrar no longer match the expected Cloudflare nameservers. This can happen if:

Someone manually changed nameservers at the registrar

The domain was transferred to a different registrar

Registrar reset nameservers to default

How It Works

Generates new nameservers (e.g., anna.ns.cloudflare.com, bob.ns.cloudflare.com)

Resets domain status to 'not_connected' and propagation statuses to 'pending'

After Calling This Endpoint

IMPORTANT: You must update the nameservers at your domain registrar with the new values returned in the response. The domain will remain in 'not_connected' status until nameservers are correctly configured and propagated.

Finding Domains That Need Regeneration

Use the List Domains endpoint with filters:

status: ['expired_propagation'] - for timed-out domains

nameserver_match_status: ['moved'] - for domains with changed nameservers

Or check the nameserver_status_counts in the List Domains response to see how many domains need attention.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://api.inboxkit.com/v1/api/domains/nameservers/regenerate' \ --header 'X-Workspace-Id: 550e8400-e29b-41d4-a716-446655440000' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "uids": [ "d1a2b3c4-5678-90ab-cdef-1234567890ab", "e2f3a4b5-6789-01bc-defg-2345678901cd" ], "domains": [ "example.com", "mycompany.net" ] }'

{ "error": false, "message": "Nameservers regenerated successfully", "count": 3, "expired_propagation_count": 1, "moved_nameservers_count": 2, "result": [ { "name": "example.com", "uid": "d1a2b3c4-5678-90ab-cdef-1234567890ab", "status": "not_connected", "nameservers": [ "anna.ns.cloudflare.com", "bob.ns.cloudflare.com" ], "cf_zone_id": "abc123def456", "dns_propagation_status": "pending", "nameservers_propagation_status": "pending", "nameserver_match_status": "pending" } ] }

Regenerate Domain Nameservers