projectRoles

Deletes a project role and migrates members.

Changed on

Deletes the specified project role and moves its members to the role selected in the request.

<Check title="Required Permissions" icon="key">The user must be an admin or have workspace-manage-config:write permissions.</Check>

post/projectroles/{projectRoleId}/delete

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/projectroles/{projectRoleId}/delete
  • Auth: HTTP bearer

Path parameters

projectRoleIdstring uuid required

The id of the project role.

Request body

newProjectRoleIdstring uuid nullable

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

ProjectRolesPostProjectRoleDeleteByProjectRoleIdResponse200 required

Empty response body

Changes

  • 1556e0487867Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API

  • 8e46cf415581Revision changes
    • info

      api operation id PostProjectRoleDeleteByProjectRoleId removed and replaced with projectRoles_PostProjectRoleDeleteByProjectRoleId