v1

latestOpenAPI 3.1.02026-08-066984441.1 MB
projectRoles

Creates a new project role.

<Note title="Subscription Level" icon="layer-group">This endpoint requires the Standard plan or higher.</Note>

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

post/projectroles

Headers

Authorizationstring required

Bearer authentication

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.