Skip to main content
Tailscale logo
  • Category: it operations
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 14
  • Triggers: 0
  • Slug: TAILSCALE
  • Version: 20261101_00

Tools

Slug: TAILSCALE_GET_DEVICEGet the current record for one manageable Tailscale device by ID, with a choice of full or default response detail.

Input Parameters

string ("all" | "default")
Response detail level. ‘all’ includes routes, connectivity, posture, and SSH fields; ‘default’ returns Tailscale’s smaller standard field set.
string
required
Device ID returned by List Tailnet Devices.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_GET_DNS_CONFIGURATIONReturn the selected tailnet’s combined MagicDNS, nameserver, search-path, and split-DNS configuration.

Input Parameters

string
Tailnet name or ID; keep ’-’ to use the API key’s owning tailnet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_GET_POLICY_FILEReturn the active Tailscale policy file for a tailnet as complete provider-native JSON.

Input Parameters

string
Tailnet name or ID; keep ’-’ to use the API key’s owning tailnet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_GET_TAILNET_SETTINGSReturn current tailnet-wide approval, update, key-duration, HTTPS, routing, logging, and posture settings.

Input Parameters

string
Tailnet name or ID; keep ’-’ to use the API key’s owning tailnet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_LIST_CONFIGURATION_AUDIT_LOGSReturn configuration audit events for an explicit RFC3339 time window in the selected tailnet, optionally filtered by actor, target, or event name.

Input Parameters

string
required
End of the audit window as an RFC3339 timestamp later than start.
array
Optional actor filters. Use exact actor IDs or prefix a login/display-name search with ’~’, for example ‘~alice’.
array
Optional exact Tailscale audit event names to include.
string
required
Inclusive start of the audit window as an RFC3339 timestamp.
array
Optional strings matched against any part of an audit event target.
string
Tailnet name or ID; keep ’-’ to use the API key’s owning tailnet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_LIST_DEVICE_ROUTESReturn the subnet routes advertised and currently enabled for a Tailscale device.

Input Parameters

string
required
Device ID returned by List Tailnet Devices.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_LIST_TAILNET_DEVICESReturn 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

array
Return only devices containing every specified ACL tag. Tailscale applies repeated tag filters with logical AND.
string ("all" | "default")
Response detail level. ‘all’ includes routes, connectivity, posture, and SSH fields; ‘default’ returns Tailscale’s smaller standard field set.
string
Tailnet name or ID; keep ’-’ to use the API key’s owning tailnet.
string
Return only devices whose top-level hostname exactly matches this value.
boolean
Return only ephemeral devices when true, or non-ephemeral devices when false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_LIST_TAILNET_KEYSReturn active auth keys, API access tokens, OAuth clients, and federated identities visible in the selected tailnet, without secret key material.

Input Parameters

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.
string
Tailnet name or ID; keep ’-’ to use the API key’s owning tailnet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_LIST_USERSReturn users in the selected tailnet, optionally filtered by membership type or role.

Input Parameters

string ("owner" | "member" | "admin" | "it-admin" | "network-admin" | "billing-admin" | "auditor" | "all")
Optional exact role filter. Advanced roles may require a paid Tailscale plan.
string
Tailnet name or ID; keep ’-’ to use the API key’s owning tailnet.
string ("member" | "shared" | "all")
Optional exact user-type filter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_REPLACE_POLICY_FILEReplace the complete active Tailscale access policy for a tailnet, optionally guarded by an ETag.

Input Parameters

object
required
Complete replacement Tailscale policy as a JSON object.
string
Tailnet name or ID; ’-’ selects the API key’s owning tailnet.
string
Quoted ETag from a policy read, used to reject concurrent changes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_SET_DEVICE_AUTHORIZATIONApprove or revoke approval for one device when device approval is enabled on the tailnet.

Input Parameters

string
required
Device ID returned by List Tailnet Devices.
boolean
required
True to approve the device or false to revoke its approval.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_SET_DEVICE_ROUTESReplace the enabled subnet routes for one device with an explicit list of routes. Routes may be enabled before the device advertises them.

Input Parameters

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.
string
required
Device ID returned by List Tailnet Devices.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_SET_DEVICE_TAGSReplace all ACL tags assigned to one Tailscale device.

Input Parameters

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.
string
required
Device ID returned by List Tailnet Devices.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAILSCALE_VALIDATE_POLICY_FILEValidate a hypothetical JSON policy file and run its tests without changing the active Tailscale policy.

Input Parameters

object
required
Complete hypothetical Tailscale policy file as a JSON object.
string
Tailnet name or ID; ’-’ selects the API key’s owning tailnet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not