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

The Devices API from Tailscale — 12 operation(s) for devices.

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

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

This API exposes 15 operations across 12 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.

15 operations 12 paths 0 schemas 2 DELETE5 GET8 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 Devices 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 15

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

Devices 15
GET
/tailnet/{tailnet}/devices
List devices in a tailnet
listTailnetDevices 1 param → 200
GET
/tailnet/{tailnet}/device-attributes
List device attributes for a tailnet
listTailnetDeviceAttributes 1 param → 200
GET
/device/{deviceId}
Get a device
getDevice 1 param → 200
DELETE
/device/{deviceId}
Delete a device
deleteDevice 1 param → 204
POST
/device/{deviceId}/expire
Expire a device's key
expireDevice 1 param → 200
GET
/device/{deviceId}/routes
Get device routes
getDeviceRoutes 1 param → 200
POST
/device/{deviceId}/routes
Set device routes
setDeviceRoutes 1 param → 200
POST
/device/{deviceId}/authorized
Authorize a device
authorizeDevice 1 param → 200
POST
/device/{deviceId}/name
Set device name
setDeviceName 1 param → 200
POST
/device/{deviceId}/tags
Set device tags
setDeviceTags 1 param → 200
POST
/device/{deviceId}/key
Update device key
setDeviceKey 1 param → 200
POST
/device/{deviceId}/ip
Set device IP
setDeviceIp 1 param → 200
GET
/device/{deviceId}/attributes
Get device attributes
getDeviceAttributes 1 param → 200
POST
/device/{deviceId}/attributes/{attributeKey}
Set a device attribute
setDeviceAttribute 2 params → 200
DELETE
/device/{deviceId}/attributes/{attributeKey}
Delete a device attribute
deleteDeviceAttribute 2 params → 204

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tailscale-devices-api-openapi.yml Raw ↑

Other APIs Tailscale publishes across the network.

Tailscale DNS API
Tailscale Invites API
Tailscale Keys API
Tailscale Logging API
Tailscale Policy API
Tailscale Tailnet API