NetBird Full API Reference + Read-Only MCP Prototype
DELETE/api/dns/zones/{zoneId}

Delete a DNS zone

Deletes a custom DNS zone identified by its unique ID. Use this operation to remove a zone that you no longer need. A 200 response confirms successful deletion.

1 parameter
zoneIdstringrequired
The unique identifier of the DNS zone to delete.

6 status codes
200Returns confirmation that the zone was deleted successfully.
400Returned when the request is invalid.
401Returned when authentication is required but missing or invalid.
403Returned when the request is forbidden.
404Returned when the DNS zone is not found.
500Returned when an internal server error occurs.

Error handling

A 400 is returned when the request is invalid. A 401 is returned when authentication is missing or invalid. A 403 indicates insufficient permission. A 404 is returned when the zone is not found, and a 500 indicates an internal server error. The zoneId path parameter must identify the zone to delete.