post https://api.shift.io/v3/projects//roles
Creates a role in a specific project
This call creates a new role in a specific project. To create a role template that can be reused throughout your workspace, please see Create role template.
The body of the request should provide a name for the role using the displayName parameter. Use the permissionGroups object to indicate the permissions you want the role to have. Permissions are grouped into one of two categories using the groupIdentifier parameter: “Asset” for viewing, uploading, editing, downloading, and deleting assets; and “Sharing” for sharing assets internally or externally. Here is an example request:
{
"displayName": "View and Internal Share Only",
"level": "USER",
"permissionGroups": [
{
"groupIdentifier": "ASSET",
"permissions": [
"READ"
]
},
{
"groupIdentifier": "SHARING",
"permissions": [
"INTERNAL"
]
}
]
}
A 200 code is returned when a role is successfully created. The response provides the id of the new role.