{"uid":"cap_W6LrWx6DtTqtEDMrLtGSj","slug":"domains-rapidruntime-com-set-domain-nameservers-c673c880","name":"Set Domain Nameservers","description":"Replace all nameservers for the domain.","url":"https://domains.rapidruntime.com/api/v1/domains/{domain}/nameservers","method":"POST","headers":{},"bodySchema":{"type":"object","required":["nameservers"],"properties":{"nameservers":{"type":"array","items":{"type":"string"},"minItems":1,"description":"Nameserver hostnames"}}},"responseSchema":{"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":{"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"}}},"registrant":{"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"}}}}},"createDate":{"type":"string"},"domainName":{"type":"string"},"expireDate":{"type":"string"},"nameservers":{"type":"array","items":{"type":"string"}},"renewalPrice":{"type":"number"},"privacyEnabled":{"type":"boolean"},"autorenewEnabled":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"0x20C000000000000000000000b9537d11c60E8b50","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_1Lnc3sflIS9Emqz7YhDcp","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"domains.rapidruntime.com","brandSlug":"domains-rapidruntime-com-mpp","brandBaseUrl":"https://domains.rapidruntime.com","brandDocsUrl":null,"whatItDoes":"Replaces all nameservers for a specified domain, overwriting the existing nameserver configuration entirely.","exampleAgentPrompt":"Update the nameservers for mydomain.com to ns1.cloudflare.com and ns2.cloudflare.com, replacing whatever is there now.","exampleUseCases":[{"title":"Migrate domain to new hosting provider","prompt":"I'm switching our website hosting to AWS. Can you update the nameservers for our company domain to point to the AWS nameservers they gave us?"},{"title":"Delegate subdomain to external DNS manager","prompt":"We need to move our staging environment to a different DNS provider. Set the nameservers for staging.example.com to use their nameserver addresses instead of ours."},{"title":"Restore domain after DNS service outage","prompt":"Our DNS provider went down. Switch all nameservers for our domain back to our backup DNS service right away."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:30:22.421Z","isFirstParty":false}