Creates, updates or deletes a permission of a project role with the specified id. — awork API

Creates, updates or deletes a permission of the project role. If the permission already exist, and the ‘AccessLevels’ property of the model is not empty, the permission will be updated. If the ‘AccessLevels’ property of the model is empty, the permission will be deleted. The permission will be created if it does not exist.

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

Path parameters

projectRoleIdstringRequired

The id of the project role.

Request

This endpoint expects an object.

featurestringOptional

The feature these permissions belong to.

accessLevelslist of stringsOptional

The access levels applied to this feature.

Response

This endpoint returns an object

featurestringOptional

The feature these permissions belong to.

accessLevelslist of stringsOptional

The access levels applied to this feature.

idstringOptional

The id of the permission.

createdOndatetimeOptional

The date this entity was created.

updatedOndatetimeOptional

The date this entity was last modified.

1	curl -X POST https://api.awork.com/api/v1/projectroles/projectRoleId/permissions \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{}'

1	{
2	"feature": "pmd",
3	"accessLevels": [
4	"read"
5	],
6	"id": "123e4567-e89b-12d3-a456-426614174000",
7	"createdOn": "2024-01-15T09:30:00Z",
8	"updatedOn": "2024-01-15T09:30:00Z"
9	}