Deletes the project role with the specified id.

POST

Deletes the project role with the specified id. When you want to delete a project role which is still in use, you are required to specify which role the currently assigned members should be assigned to instead. If the default role gets deleted, the migration role becomes the new default project role.

Required Permissions: The user must be an admin or have workspace-manage-config:write permissions.

Path parameters

projectRoleIdstringRequired
The id of the project role.

Request

This endpoint expects an object.
newProjectRoleIdstringOptional
The id of the new project role. Needs to be set when there are still users in projects with the old project role.