API v1 ReferenceProject Roles

Deletes the project role with the specified id.

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

projectRoleIdUUIDRequired
The id of the project role.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

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

Response

OK