Tailscale icon

Tailscale

Manage your Tailscale tailnet — devices, routes, and more

DNS → Set Split DNS

AI-generated

Summary

Set or replace the entire split DNS configuration for a Tailscale tailnet, specifying domain-to-nameserver mappings.

Inputs

  • Authentication — Choose the authentication method: API Key or OAuth2.
  • Tailnet Name or ID (required) — Your tailnet organization name or ID to set the split DNS for. Can be chosen from the list or set via expression. Use "-" for the default tailnet of the authenticated user.
  • Split DNS Configuration (required) — A JSON object where each key is a domain name and each value is an array of nameserver IPs for that domain. For example: {"example.com": ["100.100.100.100"], "corp.internal": ["10.0.0.1"]}. This configuration fully replaces existing settings.

Output shape

an object confirming the updated split DNS configuration or containing the API response

The node sends a PUT request to the Tailscale API endpoint to replace the split DNS settings for the specified tailnet. The response includes the resulting split DNS configuration or confirmation from the API.

Examples

Example 1: Set split DNS

Provide tailnet and a complete JSON configuration of domain names to nameserver IP arrays to replace existing split DNS entries.

Links

Discussion