Delete a role
Role
Delete a role
Deletes a role from the tenant. Fails with an error if the role is currently assigned as a user type on any unit. Restricted to tenant administrators with tenant isolation enforced.
DELETE
Delete a role
Authorizations
Server-to-server authentication. Generate a token in the admin UI at
Settings → Developers → API Access. Send the raw token in the
Api-Token header — there is no Bearer prefix.
Tokens can be marked read-only at creation time, in which case the API
rejects any non-GET request with 403 Forbidden.
Path Parameters
Role identifier
Response
Role resource deleted

