Tailscale Subnet Routers

Update a Tailscale Subnet Router

Changed on

Renames the router, changes its advertised routes, or retries a failed enrollment. Any change queues a new provisioning run and returns the router with status provisioning. The router keeps its machine identity on the tailnet. Send an empty object to retry a failed router with its stored auth key. Include a new auth_key only while the router has never enrolled. The router's Network and region cannot change: create a new router instead.

patch/tailscale_subnet_routers/{id}

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/tailscale_subnet_routers/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required
Example:6a09cdc3-8948-47f0-aa62-74ac943d6c58

Identifies the resource.

Request body

namestring

A user specified name for the router.

advertised_routesstring[]

IPv4 subnets of the Network that the router advertises to the tailnet. Each entry is a canonical CIDR that the Network routes. Default, loopback, link-local, multicast, and Tailscale (100.64.0.0/10) ranges are rejected. So are ranges that overlap the router's own, 172.27.254.0/24 and 198.18.0.0/20.

auth_keystring password

A replacement Tailscale auth key. Accepted only while the router has never enrolled, for example after a failed enrollment. Never returned.

Example request

{
  "name": "tailnet-ashburn",
  "advertised_routes": [
    "172.27.0.0/24"
  ],
  "auth_key": "tskey-auth-k1AbCdEfGh2IjKlMnOpQrStUv"
}

Response

Successful response. The change is queued and provisioning has started.

Example response

{
  "data": {
    "id": "5c6f0a7e-6c7b-4d7f-9f2e-3b1e4e9a8c21",
    "record_type": "tailscale_subnet_router",
    "name": "tailnet-ashburn",
    "network_id": "0de011ae-ee53-4df4-ba96-754728eb5aad",
    "region_code": "ashburn-va",
    "advertised_routes": [
      "172.27.0.0/24"
    ],
    "status": "provisioned",
    "customer_address": "172.27.254.1",
    "device_id": "n5c6f0a7e1CNTRL",
    "tailnet_name": "acme.example",
    "tailscale_ips": [
      "100.101.2.30",
      "fd7a:115c:a1e0::2a"
    ],
    "created_at": "2026-10-13T15:04:05.123456Z",
    "updated_at": "2026-10-13T15:09:41.654321Z"
  }
}

Changes