Tailscale icon

Tailscale

Manage your Tailscale tailnet — devices, routes, and more

DNS → Set Nameservers

AI-generated

Summary

Replace the global DNS nameservers of a specified Tailscale tailnet with a new list of IP addresses.

Inputs

  • Authentication (required) — Select the authentication method (API Key or OAuth2) to authorize the request.
  • Tailnet Name or ID (required) — Specify the tailnet organization name or ID to update. Use '-' for the default tailnet of the authenticated user.
  • Nameservers (required) — Provide one or more DNS server IP addresses to set as the new global nameservers, replacing the current list.

Output shape

A single response object confirming the operation's success, typically reflecting the updated nameserver configuration from the Tailscale API.

The request body includes a 'dns' property with an array of the specified IP addresses. No pagination applies; errors are returned as standard API error responses.

Examples

Example 1: Set the global DNS nameservers to Google's and Cloudflare's DNS for the default tailnet using API Key authentication.

Authentication: API Key; Tailnet Name or ID: '-'; Nameservers: ['8.8.8.8', '1.1.1.1']

Links

Discussion