projectRoles

Updates the specified project role.

Changed on

Updates the specified role's name or default status. Changing the default role updates the previous default role.

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

put/projectroles/{projectRoleId}

Request

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

Path parameters

projectRoleIdstring uuid required

The id of the project role.

Request body

namestring required

The name of the project role. Required.

isDefaultboolean nullable

Whether to use this role as default when adding new project members.

defaultProjectRoleIdstring uuid nullable

The id of the new default project role. Required if the updated project role is the current default role.

allowOnlyProjectMasterDataReadboolean

Whether this role is allowed to have only read permissions for project-master-data.

Response

OK

namestring required

The name of the project role. Required.

isDefaultboolean nullable

Whether to use this role as default when adding new project members.

defaultProjectRoleIdstring uuid nullable

The id of the new default project role. Required if the updated project role is the current default role.

allowOnlyProjectMasterDataReadboolean

Whether this role is allowed to have only read permissions for project-master-data.

idstring uuid

The id of the project role.

memberCountinteger

The count of members which are linked to this role.

createdOnstring date-time

The date this entity was created.

createdBystring uuid

The id of the user who created this entity.

updatedOnstring date-time

The date this entity was last modified.

updatedBystring uuid

The id of the user who last modified this entity.

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 PutProjectRoleById removed and replaced with projectRoles_PutProjectRoleById