---
title: "Join a network or update its configuration by Network ID."
method: POST
path: "/network/{networkID}"
tags: ["network"]
---

# Join a network or update its configuration by Network ID.

`POST /network/{networkID}`

## Request

- Base URL: `http://localhost:9993`
- URL: `http://localhost:9993/network/{networkID}`
- Auth: API key in header `X-ZT1-Auth`

## Path parameters

- `networkID` string, required

## Request body

- Network
  - `allowDNS` boolean: Let ZeroTier modify the system's DNS settings.
  - `allowDefault` boolean: Let ZeroTier modify the system's default route.
  - `allowGlobal` boolean: Let ZeroTier manage IP addresses and Route assignments that aren't in private ranges (rfc1918).
  - `allowManaged` boolean: Let ZeroTier to manage IP addresses and Route assignments.
  - `assignedAddresses` string[]
  - `bridge` boolean
  - `broadcastEnabled` boolean
  - `dns` object
    - `domain` string
    - `servers` string[]
  - `id` string
  - `mac` string: MAC address for this network's interface.
  - `mtu` integer
  - `multicastSubscriptions` object[]
    - `adi` integer
    - `mac` string
  - `name` string
  - `netconfRevision` integer
  - `portDeviceName` string
  - `portError` integer
  - `routes` object[]
    - `flags` integer
    - `metric` integer
    - `target` string
    - `via` string
  - `status` string
  - `type` string

## Response `200`

- Network
  - `allowDNS` boolean: Let ZeroTier modify the system's DNS settings.
  - `allowDefault` boolean: Let ZeroTier modify the system's default route.
  - `allowGlobal` boolean: Let ZeroTier manage IP addresses and Route assignments that aren't in private ranges (rfc1918).
  - `allowManaged` boolean: Let ZeroTier to manage IP addresses and Route assignments.
  - `assignedAddresses` string[]
  - `bridge` boolean
  - `broadcastEnabled` boolean
  - `dns` object
    - `domain` string
    - `servers` string[]
  - `id` string
  - `mac` string: MAC address for this network's interface.
  - `mtu` integer
  - `multicastSubscriptions` object[]
    - `adi` integer
    - `mac` string
  - `name` string
  - `netconfRevision` integer
  - `portDeviceName` string
  - `portError` integer
  - `routes` object[]
    - `flags` integer
    - `metric` integer
    - `target` string
    - `via` string
  - `status` string
  - `type` string

## Other responses

- `401`: Authorization required.

---

[API](https://skmtc.dev/zerotier/apis/zerotierone-service-api.md) - [All operations](https://skmtc.dev/zerotier/apis/zerotierone-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zerotier/apis/zerotierone-service-api/revisions/8f52221374c1?raw)