Delete Role

Deletes a permissions role. > 🚧 Built-in system roles (such as Admin and Member) cannot be deleted. > Attempting to delete a system role returns an error. Deleting a role does not automatically remove it from any policies that reference it. Update those policies separately using [`PUT /api/permissions/policies/{id}`](../../../../api-reference/permissions/policies/update) to avoid leaving stale role references.

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Path parameters

idstringRequiredformat: "uuid"

Headers

X-Polytomic-VersionstringRequired

Errors

403
Forbidden Error
404
Not Found Error
500
Internal Server Error