---
title: "Update Tailscale settings (admin only)"
method: PATCH
path: "/users/tailscale-settings"
tags: ["Users"]
---

# Update Tailscale settings (admin only)

`PATCH /users/tailscale-settings`

Saves or clears the Tailscale API key used for device discovery.

## Request body

- object
  - `apiKey` string
  - `apiBaseUrl` string — Optional custom control-plane API base URL (e.g. a Headscale instance). Leave empty to use the Tailscale default.

## Response `200`

Tailscale settings updated.

## Other responses

- `403` — Not authorized.
- `500` — Failed to update Tailscale settings.

---

[API](https://skmtc.dev/termix/apis/termix-api.md) · [All operations](https://skmtc.dev/termix/apis/termix-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/termix/termix-api/revisions/f4ef343eff1b/schema)