---
title: "Reject network member"
method: POST
path: "/api/v2/network/{id}/member/{device-id}/reject"
tags: ["member"]
---

# Reject network member

`POST /api/v2/network/{id}/member/{device-id}/reject`

## Request

- Base URL: `https://central.zerotier.com`
- URL: `https://central.zerotier.com/api/v2/network/{id}/member/{device-id}/reject`
- Auth: HTTP bearer

Reject a specific device, blocking it from joining the network.

## Path parameters

- `id` string, required
- `device-id` string, required

## Response `200`

Rejected device member

- NetworkMember
  - `deviceId` string, required: Unique device identifier
  - `networkId` string, required: ID of the network this member belongs to
  - `name` string, required: Display name of the device
  - `description` string, required: Description of the device
  - `status` 'authorized' | 'not_authorized' | 'rejected', required: Authorization status of the device on this network
  - `activeBridge` boolean, required: Whether this device acts as an active bridge
  - `ipv4Assignments` string[], required: IPv4 addresses assigned to this device on the network
  - `ipv6Assignments` string[], required: IPv6 addresses assigned to this device on the network
  - `ipAssignment6plane` string, ipv6, required: IPv6 address assigned via 6PLANE addressing
  - `ipAssignmentRfc4193` string, ipv6, required: IPv6 address assigned via RFC 4193 addressing
  - `noAutoAssignIps` boolean, required: Whether automatic IP address assignment is disabled for this device
  - `capabilities` string[], required: ZeroTier capability IDs granted to this device
  - `creationTime` string, date-time, required: Time the device was first seen on the network
  - `lastModified` string, date-time, required: Time the member record was last modified
  - `identity` string, required: ZeroTier public identity of the device
  - `lastAuthorizedCredential` string: Credential used for the last authorization
  - `lastAuthorizedTime` string, date-time: Time the device was last authorized
  - `lastDeauthorizedTime` string, date-time: Time the device was last deauthorized
  - `revision` integer, required: Revision counter for the member record
  - `tags` string[], required: ZeroTier tag IDs applied to this device
  - `agentVersion` string, required: ZeroTier client version running on the device
  - `macAddress` string, required: MAC address of the device's virtual network interface
  - `lastSeen` object, required: Map of IP/port to last-seen timestamp
  - `lastSeenIp` string, required: Last known public IP address of the device
  - `lastSeenTime` string, date-time: Time the device was last seen by a controller
  - `os` string, required: Operating system reported by the ZeroTier client
  - `arch` string, required: CPU architecture reported by the ZeroTier client

## Other responses

- `401`: Missing or invalid authentication token
- `403`: Insufficient permissions
- `404`: Member not found
- `500`: Internal server error

---

[API](https://skmtc.dev/zerotier/apis/zerotier-central-v2-api.md) - [All operations](https://skmtc.dev/zerotier/apis/zerotier-central-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zerotier/apis/zerotier-central-v2-api/revisions/b2e7468ad104?raw)