> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tailscale

> Tailscale is a secure networking platform for managing tailnets, devices, users, DNS, access policies, services, and other network administration resources.

![Tailscale logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/tailscale.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=a3b3e4f65de5243bf13472b70bca53d9)

* **Category:** it operations
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 14
* **Triggers:** 0
* **Slug:** `TAILSCALE`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Device
>
> **Slug:** `TAILSCALE_GET_DEVICE`
>
> Get the current record for one manageable Tailscale device by ID, with a choice of full or default response detail.
>
> #### Input Parameters
>
> **fields** `string ("all" | "default")`
>
> Response detail level. 'all' includes routes, connectivity, posture, and SSH fields; 'default' returns Tailscale's smaller standard field set.
>
> **device\_id** `string` *required*
>
> Device ID returned by List Tailnet Devices.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get DNS Configuration
>
> **Slug:** `TAILSCALE_GET_DNS_CONFIGURATION`
>
> Return the selected tailnet's combined MagicDNS, nameserver, search-path, and split-DNS configuration.
>
> #### Input Parameters
>
> **tailnet** `string`
>
> Tailnet name or ID; keep '-' to use the API key's owning tailnet.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Policy File
>
> **Slug:** `TAILSCALE_GET_POLICY_FILE`
>
> Return the active Tailscale policy file for a tailnet as complete provider-native JSON.
>
> #### Input Parameters
>
> **tailnet** `string`
>
> Tailnet name or ID; keep '-' to use the API key's owning tailnet.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tailnet Settings
>
> **Slug:** `TAILSCALE_GET_TAILNET_SETTINGS`
>
> Return current tailnet-wide approval, update, key-duration, HTTPS, routing, logging, and posture settings.
>
> #### Input Parameters
>
> **tailnet** `string`
>
> Tailnet name or ID; keep '-' to use the API key's owning tailnet.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Configuration Audit Logs
>
> **Slug:** `TAILSCALE_LIST_CONFIGURATION_AUDIT_LOGS`
>
> Return configuration audit events for an explicit RFC3339 time window in the selected tailnet, optionally filtered by actor, target, or event name.
>
> #### Input Parameters
>
> **end** `string` *required*
>
> End of the audit window as an RFC3339 timestamp later than start.
>
> **actor** `array`
>
> Optional actor filters. Use exact actor IDs or prefix a login/display-name search with '\~', for example '\~alice'.
>
> **event** `array`
>
> Optional exact Tailscale audit event names to include.
>
> **start** `string` *required*
>
> Inclusive start of the audit window as an RFC3339 timestamp.
>
> **target** `array`
>
> Optional strings matched against any part of an audit event target.
>
> **tailnet** `string`
>
> Tailnet name or ID; keep '-' to use the API key's owning tailnet.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Device Routes
>
> **Slug:** `TAILSCALE_LIST_DEVICE_ROUTES`
>
> Return the subnet routes advertised and currently enabled for a Tailscale device.
>
> #### Input Parameters
>
> **device\_id** `string` *required*
>
> Device ID returned by List Tailnet Devices.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tailnet Devices
>
> **Slug:** `TAILSCALE_LIST_TAILNET_DEVICES`
>
> Return all devices in the selected tailnet, including identifiers, names, addresses, tags, authorization state, and connectivity metadata. Supports exact server-side filtering by hostname, tags, and ephemeral state.
>
> #### Input Parameters
>
> **tags** `array`
>
> Return only devices containing every specified ACL tag. Tailscale applies repeated tag filters with logical AND.
>
> **fields** `string ("all" | "default")`
>
> Response detail level. 'all' includes routes, connectivity, posture, and SSH fields; 'default' returns Tailscale's smaller standard field set.
>
> **tailnet** `string`
>
> Tailnet name or ID; keep '-' to use the API key's owning tailnet.
>
> **hostname** `string`
>
> Return only devices whose top-level hostname exactly matches this value.
>
> **is\_ephemeral** `boolean`
>
> Return only ephemeral devices when true, or non-ephemeral devices when false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tailnet Keys
>
> **Slug:** `TAILSCALE_LIST_TAILNET_KEYS`
>
> Return active auth keys, API access tokens, OAuth clients, and federated identities visible in the selected tailnet, without secret key material.
>
> #### Input Parameters
>
> **all** `boolean`
>
> Set true to return all auth keys, API access tokens, and trust credentials for the tailnet; omit to return keys visible to the caller.
>
> **tailnet** `string`
>
> Tailnet name or ID; keep '-' to use the API key's owning tailnet.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Users
>
> **Slug:** `TAILSCALE_LIST_USERS`
>
> Return users in the selected tailnet, optionally filtered by membership type or role.
>
> #### Input Parameters
>
> **role** `string ("owner" | "member" | "admin" | "it-admin" | "network-admin" | "billing-admin" | "auditor" | "all")`
>
> Optional exact role filter. Advanced roles may require a paid Tailscale plan.
>
> **tailnet** `string`
>
> Tailnet name or ID; keep '-' to use the API key's owning tailnet.
>
> **user\_type** `string ("member" | "shared" | "all")`
>
> Optional exact user-type filter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Replace Policy File
>
> **Slug:** `TAILSCALE_REPLACE_POLICY_FILE`
>
> Replace the complete active Tailscale access policy for a tailnet, optionally guarded by an ETag.
>
> #### Input Parameters
>
> **policy** `object` *required*
>
> Complete replacement Tailscale policy as a JSON object.
>
> **tailnet** `string`
>
> Tailnet name or ID; '-' selects the API key's owning tailnet.
>
> **if\_match** `string`
>
> Quoted ETag from a policy read, used to reject concurrent changes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Device Authorization
>
> **Slug:** `TAILSCALE_SET_DEVICE_AUTHORIZATION`
>
> Approve or revoke approval for one device when device approval is enabled on the tailnet.
>
> #### Input Parameters
>
> **device\_id** `string` *required*
>
> Device ID returned by List Tailnet Devices.
>
> **authorized** `boolean` *required*
>
> True to approve the device or false to revoke its approval.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Device Routes
>
> **Slug:** `TAILSCALE_SET_DEVICE_ROUTES`
>
> Replace the enabled subnet routes for one device with an explicit list of routes. Routes may be enabled before the device advertises them.
>
> #### Input Parameters
>
> **routes** `array` *required*
>
> Complete replacement list of subnet routes to enable. Routes may be enabled before a device advertises them, but do not carry traffic until advertised; pass \[] deliberately to disable every enabled route.
>
> **device\_id** `string` *required*
>
> Device ID returned by List Tailnet Devices.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Device Tags
>
> **Slug:** `TAILSCALE_SET_DEVICE_TAGS`
>
> Replace all ACL tags assigned to one Tailscale device.
>
> #### Input Parameters
>
> **tags** `array` *required*
>
> Complete replacement tag list using values such as 'tag:server'. Passing \[] removes all tags only from a node that is not already tag-owned; a tagged node must be re-authenticated to be untagged.
>
> **device\_id** `string` *required*
>
> Device ID returned by List Tailnet Devices.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Validate Policy File
>
> **Slug:** `TAILSCALE_VALIDATE_POLICY_FILE`
>
> Validate a hypothetical JSON policy file and run its tests without changing the active Tailscale policy.
>
> #### Input Parameters
>
> **policy** `object` *required*
>
> Complete hypothetical Tailscale policy file as a JSON object.
>
> **tailnet** `string`
>
> Tailnet name or ID; '-' selects the API key's owning tailnet.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
