NetBird Full API Reference + Read-Only MCP Prototype
DELETE/api/agent-network/settings

Delete Agent Network settings

Deletes the account's Agent Network settings row, releasing the endpoint. Guarded — the delete is refused with 412 while any Agent Network provider exists for the account or while a proxy is actively serving the endpoint. Bootstrapping again after a delete allocates a new endpoint; the released hostname is not reserved.

6 status codes
200Settings deleted
401Requires authentication
403Forbidden
404Resource not found
412Delete refused — Agent Network providers still exist for the account, or a proxy is actively serving the endpoint
500Internal Server Error

Error handling

A 401 is returned: Requires authentication. A 403 is returned: Forbidden. A 404 is returned: Resource not found. A 412 is returned: Delete refused — Agent Network providers still exist for the account, or a proxy is actively serving the endpoint. A 500 is returned: Internal Server Error.