Skip to navigation

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} to avoid leaving stale role references.

Authentication

AuthorizationBasic

This is the Polytomic deployment key (on-premises only)

OR
AuthorizationBearer
This is the Polytomic API key

Path parameters

idstringRequiredformat: "uuid"

Headers

X-Polytomic-VersionstringRequired

Response

No Content

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error