Creates, updates or deletes a permission of the specified role. | awork API

Creates, updates or deletes a permission of the 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. <Check title="Required Permissions" icon="key">The user must be an admin or have `project-manage-config:write` permissions.</Check>

Creates, updates or deletes a permission of the 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.

Authentication

AuthorizationBearer

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

Path parameters

roleIdstringRequiredformat: "uuid"

The id of the role.

Request

The permission of role form payload.

featurestring or nullOptional

The feature these permissions belong to.

accessLevelslist of strings or nullOptional

The access levels applied to this feature.

Response

featurestring or null

The feature these permissions belong to.

accessLevelslist of strings or null

The access levels applied to this feature.

idstringformat: "uuid"

The id of the permission.

createdOnstringformat: "date-time"

The date this entity was created.

updatedOnstringformat: "date-time"

The date this entity was last modified.

Errors

400

Bad Request Error

500

Internal Server Error

Required Permissions

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

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

The permission of role form payload.

The feature these permissions belong to.

The access levels applied to this feature.

The feature these permissions belong to.

The access levels applied to this feature.

The id of the permission.

The date this entity was created.

The date this entity was last modified.

$	curl -X POST https://api.awork.com/api/v1/roles/roleId/permissions \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"feature": "project-management",
3	"accessLevels": [
4	"write",
5	"read"
6	],
7	"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
8	"createdOn": "2024-04-10T08:45:00Z",
9	"updatedOn": "2024-04-12T14:20:00Z"
10	}

$	curl -X POST https://api.awork.com/api/v1/roles/roleId/permissions \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"feature": "project-management",
3	"accessLevels": [
4	"write",
5	"read"
6	],
7	"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
8	"createdOn": "2024-04-10T08:45:00Z",
9	"updatedOn": "2024-04-12T14:20:00Z"
10	}