{"slug":"tailscale-api","title":"Tailscale API","tags":["tailscale","api"],"agent_summary":"Last validated: Jan 30, 2026","trigger_phrases":[],"runnable":false,"markdown":"\r\n# Tailscale API\r\n\r\nLast validated: Jan 30, 2026\r\n\r\nThe Tailscale APIis available for [all plans](https://tailscale.com/pricing).\r\n\r\nTailscale offers an application programming interface (API) to let you automate various aspects of your network.\r\n\r\n[Visit our interactive API documentation →](https://tailscale.com/api)\r\n\r\n## [Authentication](https://tailscale.com/docs/reference/tailscale-api\\#authentication)\r\n\r\nYou need to be an [Owner, Admin, IT admin, or Network admin](https://tailscale.com/docs/reference/user-roles) of a tailnet to generate an access token.\r\n\r\nRequests to the API are authenticated by using an access token (sometimes called an API key), which can be generated\r\nfrom the [Keys](https://login.tailscale.com/admin/settings/keys) page of the admin console. You can choose the number of days, between 1 and 90 inclusive, for the key expiry. Also note that Tailscale-generated API access tokens are case-sensitive.\r\n\r\nThis access token will automatically expire after the chosen number of days. If you want to continue using an access token after this access token expires, you need to generate a new access tokens. Access tokens can also be\r\nrevoked before their expiration. Recently expired and revoked access token are shown on\r\nthe [Keys](https://login.tailscale.com/admin/settings/keys) page.\r\n\r\nAs an alternative to an access token that has full permission to the Tailscale API, use\r\n[trust credentials](https://tailscale.com/docs/reference/trust-credentials) to provide delegated fine-grained control to the Tailscale API.\r\n\r\nMore details about authenticating with the API can be [found in our interactive API docs](https://tailscale.com/api).\r\n\r\n![Project Logo](https://cdn.brandfetch.io/tailscale.com/fallback/lettermark/theme/dark/h/256/w/256/icon?c=1bfwsmEH20zzEfSNTed)\r\n\r\nAsk AI\r\n\r\nreCAPTCHA\r\n\r\nRecaptcha requires verification.\r\n\r\nprotected by **reCAPTCHA**\r\n","html":"<h1>Tailscale API</h1>\n<p>Last validated: Jan 30, 2026</p>\n<p>The Tailscale APIis available for <a href=\"https://tailscale.com/pricing\">all plans</a>.</p>\n<p>Tailscale offers an application programming interface (API) to let you automate various aspects of your network.</p>\n<p><a href=\"https://tailscale.com/api\">Visit our interactive API documentation →</a></p>\n<h2><a href=\"https://tailscale.com/docs/reference/tailscale-api#authentication\">Authentication</a></h2>\n<p>You need to be an <a href=\"https://tailscale.com/docs/reference/user-roles\">Owner, Admin, IT admin, or Network admin</a> of a tailnet to generate an access token.</p>\n<p>Requests to the API are authenticated by using an access token (sometimes called an API key), which can be generated\r\nfrom the <a href=\"https://login.tailscale.com/admin/settings/keys\">Keys</a> page of the admin console. You can choose the number of days, between 1 and 90 inclusive, for the key expiry. Also note that Tailscale-generated API access tokens are case-sensitive.</p>\n<p>This access token will automatically expire after the chosen number of days. If you want to continue using an access token after this access token expires, you need to generate a new access tokens. Access tokens can also be\r\nrevoked before their expiration. Recently expired and revoked access token are shown on\r\nthe <a href=\"https://login.tailscale.com/admin/settings/keys\">Keys</a> page.</p>\n<p>As an alternative to an access token that has full permission to the Tailscale API, use\r\n<a href=\"https://tailscale.com/docs/reference/trust-credentials\">trust credentials</a> to provide delegated fine-grained control to the Tailscale API.</p>\n<p>More details about authenticating with the API can be <a href=\"https://tailscale.com/api\">found in our interactive API docs</a>.</p>\n<p><img src=\"https://cdn.brandfetch.io/tailscale.com/fallback/lettermark/theme/dark/h/256/w/256/icon?c=1bfwsmEH20zzEfSNTed\" alt=\"Project Logo\"></p>\n<p>Ask AI</p>\n<p>reCAPTCHA</p>\n<p>Recaptcha requires verification.</p>\n<p>protected by <strong>reCAPTCHA</strong></p>\n"}