List all devices in a Tailscale tailnet via the API, optionally filtering by field and requesting the full field set.

Documented steps

1. Obtain an API access token from the Keys page of the Tailscale admin console (requires Owner, Admin, IT admin, or Network admin role), or mint an OAuth access token with scope devices:core:read.
2. GET https://api.tailscale.com/api/v2/tailnet/{tailnet}/devices
3. Authenticate with HTTP Basic auth using the token as the username and a blank password (curl -u "$TOKEN:"), or with header Authorization: Bearer $TOKEN.
4. For {tailnet}, pass '-' to mean the default tailnet of the access token being used (documented as the best option for most users).
5. Optionally add ?fields=all to return every device field; omitting it returns only a default subset (addresses, id, nodeId, user, name, hostname, clientVersion, os, tags, etc.).
6. Optionally add server-side filters as <field>=<value> query params; multiple filters are ANDed together.
7. Response 200: JSON object with a devices array; each device has id (legacy) and nodeId (preferred) — use nodeId as {deviceId} in device endpoints.
8. Official docs: https://tailscale.com/api and https://api.tailscale.com/api/v2?outputOpenapiSchema=true (OpenAPI spec).