# Set Domain Nameservers

> Set Domain Nameservers is a free API for AI agents from domains.rapidruntime.com, callable via MPP, Free, status unknown (last checked 2026-09-15).

Replaces all nameservers for a specified domain, overwriting the existing nameserver configuration entirely.

## Facts

- Endpoint: POST https://domains.rapidruntime.com/api/v1/domains/{domain}/nameservers
- Price: Free
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Provider: domains.rapidruntime.com
- Website: https://domains.rapidruntime.com
- Canonical page: https://www.zero.xyz/c/domains-rapidruntime-com-set-domain-nameservers-c673c880
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W6LrWx6DtTqtEDMrLtGSj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability domains-rapidruntime-com-set-domain-nameservers-c673c880 -d '<json body>'
```

Example prompt: Update the nameservers for mydomain.com to ns1.cloudflare.com and ns2.cloudflare.com, replacing whatever is there now.

## When to prefer this

Use this endpoint when you need to fully replace the nameserver delegation for a domain registered via MPP/RapidRuntime — for example, switching DNS hosting to Cloudflare, AWS Route 53, or a custom DNS provider. This is a full replacement operation (not additive), so all desired nameservers must be submitted together. Choose this over DNS record endpoints when the goal is to change the authoritative DNS delegation at the registrar level rather than managing individual DNS records within a zone.

## Known failure modes

- Domain not found — invalid or unowned domain in path returns 404
- Invalid nameserver hostname format causes validation error
- Empty nameservers array rejected (minItems:1 required)
- Domain is locked and cannot be modified — returns error indicating transfer/update lock
- Authentication failure if MPP identity credentials are missing or invalid
- Nameserver hostname unreachable or unresolvable may cause propagation issues without explicit API error

## How this service works

Replace all nameservers for the domain.

## Output

Returns the updated domain record including domain name, lock status, autorenew setting, expiry date, creation date, WHOIS contacts (registrant, admin, tech, billing), and any active locks after the nameserver change is applied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "nameservers"
 ],
 "properties": {
  "nameservers": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "minItems": 1,
   "description": "Nameserver hostnames"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "domainName",
  "locked",
  "autorenewEnabled",
  "expireDate",
  "createDate"
 ],
 "properties": {
  "locks": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "locked": {
   "type": "boolean"
  },
  "contacts": {
   "type": "object",
   "required": [
    "registrant",
    "admin",
    "tech",
    "billing"
   ],
   "properties": {
    "tech": {
     "type": "object",
     "required": [
      "firstName",
      "lastName",
      "address1",
      "city",
      "state",
      "zip",
      "country",
      "email",
      "phone"
     ],
     "properties": {
      "fax": {
       "type": "string"
      },
      "zip": {
       "type": "string"
      },
      "city": {
       "type": "string"
      },
      "email": {
       "type": "string"
      },
      "phone": {
       "type": "string"
      },
      "state": {
       "type": "string"
      },
      "country": {
       "type": "string"
      },
      "address1": {
       "type": "string"
      },
      "address2": {
       "type": "string"
      },
      "lastName": {
       "type": "string"
      },
      "firstName": {
       "type": "string"
      },
      "companyName": {
       "type": "string"
      }
     }
    },
    "admin": {
     "type": "object",
     "required": [
      "firstName",
      "lastName",
      "address1",
      "city",
      "state",
      "zip",
      "country",
      "email",
      "phone"
     ],
     "properties": {
      "fax": {
       "type": "string"
      },
      "zip": {
       "type": "string"
      },
      "city": {
       "type": "string"
      },
      "email": {
       "type": "string"
      },
      "phone": {
       "type": "string"
      },
      "state": {
       "type": "string"
      },
      "country": {
       "type": "string"
      },
      "address1": {
       "type": "string"
      },
      "address2": {
       "type": "string"
      },
      "lastName": {
       "type": "string"
      },
      "firstName": {
       "type": "string"
      },
      "companyName": {
       "type": "string"
      }
     }
    },
    "billing": {
     "type": "object",
     "required": [
      "firstName",
      "lastName",
      "address1",
      "city",
      "state",
      "zip",
      "country",
      "email",
      "phone"
     ],
     "properties": {
      "fax": {
       "type": "string"
      },
      "zip": {
       "type": "string"
      },
      "city": {
       "type": "string"
      },
      "email": {

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/domains-rapidruntime-com-set-domain-nameservers-c673c880/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from domains.rapidruntime.com](https://www.zero.xyz/host/domains.rapidruntime.com/llms.txt)