ZEzerotier
member

Add network members

Add one or more devices to the network. Devices are not authorized until explicitly authorized.

post/api/v2/network/{id}/member

Request

  • Base URL
    https://central.zerotier.com
  • Auth
    HTTP bearer

Path parameters

idstring required

The network ID

Request body

deviceIdstring required

Device ID to add to the network

namestring

Display name for the device

descriptionstring

Description of the device (may be an empty string)

activeBridgeboolean

Whether this device acts as an active bridge

noAutoAssignIpsboolean

Disable automatic IP address assignment for this device

ipv4Assignmentsstring[]

Static IPv4 addresses to assign to this device

ipv6Assignmentsstring[]

Static IPv6 addresses to assign to this device

Example request

[
  {
    "deviceId": "cafe001234",
    "name": "Alice's Laptop",
    "description": "MacBook Pro",
    "ipv4Assignments": [
      "10.147.20.5"
    ]
  }
]

Response

Updated network member device list

deviceIdstring required

Unique device identifier

networkIdstring required

ID of the network this member belongs to

namestring required

Display name of the device

descriptionstring required

Description of the device

status'authorized' | 'not_authorized' | 'rejected' required

Authorization status of the device on this network

activeBridgeboolean required

Whether this device acts as an active bridge

ipv4Assignmentsstring[] required

IPv4 addresses assigned to this device on the network

ipv6Assignmentsstring[] required

IPv6 addresses assigned to this device on the network

ipAssignment6planestring ipv6 required

IPv6 address assigned via 6PLANE addressing

ipAssignmentRfc4193string ipv6 required

IPv6 address assigned via RFC 4193 addressing

noAutoAssignIpsboolean required

Whether automatic IP address assignment is disabled for this device

capabilitiesstring[] required

ZeroTier capability IDs granted to this device

creationTimestring date-time required

Time the device was first seen on the network

lastModifiedstring date-time required

Time the member record was last modified

identitystring required

ZeroTier public identity of the device

lastAuthorizedCredentialstring

Credential used for the last authorization

lastAuthorizedTimestring date-time

Time the device was last authorized

lastDeauthorizedTimestring date-time

Time the device was last deauthorized

revisioninteger required

Revision counter for the member record

tagsstring[] required

ZeroTier tag IDs applied to this device

agentVersionstring required

ZeroTier client version running on the device

macAddressstring required

MAC address of the device's virtual network interface

lastSeenobject required

Map of IP/port to last-seen timestamp

lastSeenIpstring required

Last known public IP address of the device

lastSeenTimestring date-time

Time the device was last seen by a controller

osstring required

Operating system reported by the ZeroTier client

archstring required

CPU architecture reported by the ZeroTier client

Changes

No recorded changes to this operation across all 1 revision of this API.