NetBird Full API Reference + Read-Only MCP Prototype
POST/api/integrations/msp/tenants/{id}/unlink

Unlink an MSP tenant

Unlinks an MSP tenant account and assigns ownership to another user. Supply the tenant identifier in the id path parameter and the new owner's user ID in owner. A 200 response confirms that the tenant was unlinked.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
idstringrequired
The unique identifier of the tenant account to unlink.

The user who will own the unlinked tenant.

ownerstringrequired
The new owners user ID.

5 status codes
200Returns confirmation that the tenant was successfully unlinked.
400Returned when the request is invalid.
403Returned when the request is missing valid authentication.
404Returned when the tenant was not found.
500Returned when an internal server error occurs.

Error handling

The id path parameter identifies the tenant to unlink. The request body must include owner, the new owner's user ID; a 400 is returned when the request is invalid or omits this field. A 403 is returned when authentication is missing or invalid, a 404 when the tenant is not found, and a 500 when an internal server error occurs.