v1

latestOpenAPI 3.0.32026-08-06138294578.6 KB
Permissions

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.

delete/api/permissions/roles/{id}

Path parameters

idstring uuid required
Example:248df4b7-aa70-47b8-a036-33ac447e668d

Headers

X-Polytomic-Versionstring

Response

No Content