Tailscale icon

Tailscale

Manage your Tailscale tailnet — devices, routes, and more

Device → Update Tags

AI-generated

Summary

Update the ACL tags assigned to a specific device in a Tailscale tailnet.

Inputs

  • Authentication (required) — Choose the authentication method to use with the Tailscale API (API Key or OAuth2).
  • Tailnet Name or ID (required) — Specify the tailnet organization name or ID to which the device belongs. Select from the list or use '-' for the default tailnet of the authenticated user.
  • Device Name or ID (required) — Select the device by name or ID to update its tags. Options are dynamically loaded from the tailnet's devices.
  • Tag Names or IDs (required) — Choose one or more ACL tags to assign to the device. Tags are dynamically loaded from existing devices in the tailnet and must start with 'tag:'.

Output shape

a single success confirmation object containing 'success' (boolean) and the updated 'deviceId'.

The operation sends a POST request to update the tags and returns a standard success JSON object upon completion.

Examples

Example 1: Assign new ACL tags to a device to control its access permissions based on policies.

Authenticate by API Key, select the target tailnet, choose the target device, and specify the desired tags to assign.

Links

Discussion