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.

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)

AuthorizationBearer

This is the Polytomic API key

Path parameters

idstringRequiredformat: "uuid"

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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.

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

This is the Polytomic API key

Delete Role

Authentication

Path parameters

Headers

Errors

Authentication

Path parameters

Headers

Errors

$	curl -X DELETE https://app.polytomic.com/api/permissions/roles/248df4b7-aa70-47b8-a036-33ac447e668d \
>	-H "X-Polytomic-Version: X-Polytomic-Version" \
>	-u "<username>:<password>"