Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tailscale Policy API

The Policy API from Tailscale — 2 operation(s) for policy.

Tailscale Policy API is one of 7 APIs that Tailscale publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Policy. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 3 operations across 2 paths. It is described by OpenAPI 3.1.0, at version 2.

Requests are made against a single base URL, https://api.tailscale.com/api/v2.

3 operations 2 paths 0 schemas 1 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2
Base URL
https://api.tailscale.com/api/v2
Authentication
HTTP Bearer, HTTP Basic
Contact
Resource Areas
1

Authentication & Security 2

Tailscale Policy API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). It accepts HTTP basic authentication (BasicAuth). By default, every request must be authenticated.

  • BearerAuth — Tailscale API access token (prefixed "tskey-api-") passed in the Authorization header. Tokens are created in the admin console with 1-90 day expiry, or via OAu…
  • BasicAuth — HTTP Basic Auth with the access token as the username and an empty password.

Paths & Operations 3

Across 2 paths, the API surfaces 3 operations — 1 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Policy 3
GET
/tailnet/{tailnet}/acl
Get ACL policy file
getAclPolicy 1 param → 200
POST
/tailnet/{tailnet}/acl
Set ACL policy file
setAclPolicy 1 param → 200
POST
/tailnet/{tailnet}/acl/validate
Validate ACL policy file
validateAclPolicy 1 param → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tailscale-policy-api-openapi.yml Raw ↑

Other APIs Tailscale publishes across the network.

Tailscale Devices API
Tailscale DNS API
Tailscale Invites API
Tailscale Keys API
Tailscale Logging API
Tailscale Tailnet API