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 Keys API

The Keys API from Tailscale — 2 operation(s) for keys.

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

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

This API exposes 4 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.

4 operations 2 paths 0 schemas 1 DELETE2 GET1 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 Keys 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 4

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

Keys 4
GET
/tailnet/{tailnet}/keys
List keys
listKeys 1 param → 200
POST
/tailnet/{tailnet}/keys
Create key
createKey 1 param → 201
GET
/tailnet/{tailnet}/keys/{keyId}
Get key
getKey 2 params → 200
DELETE
/tailnet/{tailnet}/keys/{keyId}
Delete key
deleteKey 2 params → 204

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tailscale-keys-api-openapi.yml Raw ↑

Other APIs Tailscale publishes across the network.

Tailscale Devices API
Tailscale DNS API
Tailscale Invites API
Tailscale Logging API
Tailscale Policy API
Tailscale Tailnet API