Tailscale icon

Tailscale

Manage your Tailscale tailnet — devices, routes, and more

DNS → Set Preferences

AI-generated

Summary

Set the MagicDNS preference for a specific Tailscale tailnet to enable or disable MagicDNS functionality.

Inputs

  • Authentication (required) — Choose the authentication method: API Key or OAuth2.
  • Tailnet Name or ID (required) — Specify your tailnet organization name or ID. You can select from the dropdown or use an expression to provide it.
  • MagicDNS (required) — Boolean flag to enable (true) or disable (false) MagicDNS for the tailnet.

Output shape

a single record with the result of the preference update operation from the Tailscale API

The operation sends a POST request to the endpoint /api/v2/tailnet/{tailnet}/dns/preferences with a JSON body containing the 'magicDNS' property set to the input value. The response typically confirms success or returns the updated preferences.

Examples

Example 1: Enable MagicDNS

Set Authentication to 'API Key', select a Tailnet, and set MagicDNS to true to enable MagicDNS in the tailnet's DNS preferences.

Example 2: Disable MagicDNS

Use OAuth2 authentication, specify the tailnet ID via expression, and set MagicDNS to false to disable MagicDNS.

Links

Discussion