Rights and Roles Service
Rights and Roles
- Get all the available roles
- Get all the available rights
- Create a new role
- Get details of the role
- Update the role
- Delete the roleGet all project's roles assigned by right and roles template
- Make a team member part of a project by assigning a role to him
- Get the project members along with their respective roles
- Update the project role of a team member
- Remove the user from the project
Rights and Roles Service
Rights and Roles
Anchor | ||||
---|---|---|---|---|
|
...
Deck of Cards | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Anchor | ||||
---|---|---|---|---|
|
Get all the available rights
Deck of Cards | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Anchor | ||||
---|---|---|---|---|
|
Get
...
details of the
...
role
Deck of Cards | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Card |
|
Anchor | ||||
---|---|---|---|---|
|
Get all project's roles assigned by right and roles template
Deck of Cards | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
...
Create a new role
Deck of Cards | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
Card | | |||||||||||||||||
| ||||||||||||||||||
Name | Mandatory / Optional | Type | Description | |||||||||||||||
id | optional | string (guid) | Id of the role | |||||||||||||||
name | mandatory | string | The name of the role | |||||||||||||||
parent | optional | string (guid) | The Id of the parent role | |||||||||||||||
customRole | optional | boolean | When this flag is true the role is custom role otherwise will role is 'built in' role | |||||||||||||||
resources | optional | JSON Array | Array of the right resource type definition objects for which the role is valid | |||||||||||||||
Name | Mandatory / Optional | Type | Description | |||||||||||||||
id | optional | string(Guid) | Id of the right resource type | |||||||||||||||
resource | mandatory | string | Describe kind of right resource type e.g. Global" or "Layer", etc. | |||||||||||||||
rights | mandatory | JSON Array | Array of the strings with right names e.g.: "FreeAttributeView", "RoomModel" | |||||||||||||||
rightsAccess | mandatory | JSON Array | Array of the objects with properties id, name, access :
|
Card | ||
---|---|---|
| ||
POST |
Card | ||
---|---|---|
| ||
Creates a new role with defined properties and resources to be valid for. |
Card | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
| ||||||||||||||||||
Card | ||||||||||||||||||
|
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
Status: 201 Created
|
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"name":"Test",
"customRole":true,
"resources":[{
"id":"4e587ea1-5098-45cd-9655-15f90c16dc58",
"resource":"Layer",
"rights":["RoomModel"
],
"rightsAccess":[{
"id":"52bbc329-dab3-a81c-b548-09c715786a81",
"name":"RoomModel",
"access":"Edit"
}
]
}
]
} |
...
|
Anchor | ||||
---|---|---|---|---|
|
Make a team member part of a project by assigning a role to him
Deck of Cards | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
...
Get details of the role
Deck of Cards | |||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
Card |
|
...
|
...
|
...
|
...
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id
| bimUpdateTheRole
|
Anchor | ||||
---|---|---|---|---|
|
Get the project members along with their respective roles
Deck of Cards | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
...
Delete the role
...
id | bimDeleteTheRole |
---|
Card | ||||
---|---|---|---|---|
| ||||
Resource: <team_slug>/roles/<role_id> URL: https://api-stage.bimplus.net/v2/<team_slug>/roles/<role_id> Example: https://api-stage.bimplus.net/v2/bimplus/roles/213becc0-ad48-4cd0-aef2-b922b21bbfd7 |
Card | ||
---|---|---|
| ||
DELETE |
Card | ||
---|---|---|
| ||
Deletes a specified role. |
...
label | Request |
---|
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
...
label | Response |
---|
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
Status: 200 OK
|
...
Get all project's roles assigned by right and roles template
Deck of Cards | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
Card | | |||||||||||||||||
| ||||||||||||||||||
Name | Mandatory / Optional | Type | Description | |||||||||||||||
member | mandatory | object | The member who will be assigned a role to the project. | |||||||||||||||
role | mandatory | object | The project role which will be assigned to the team member. |
Card | ||
---|---|---|
| ||
POST |
Card | ||
---|---|---|
| ||
Assign a project role to an existing member of a team. Only the user with "Account Owner" or "Project Owner" role can use this API call. |
Card | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
| ||||||||||||||||||
Card | ||||||||||||||||||
| ||||||||||||||||||
|
Anchor | |||
---|---|---|---|
|
...
|
Update the project role of a team member
...
Deck of Cards | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Card |
|
...
Get the project members along with their respective roles
...
id | bimGetMembersWithRoles |
---|
Card | ||||
---|---|---|---|---|
| ||||
Resource: projects/<project_id>/members URL: https://api-stage.bimplus.net/v2/<team_slug>/projects/<project_id>/members Example: https://api-stage.bimplus.net/v2/bimplus/projects/b8615afc-99cc-4bcd-b0ca-ff0593ce15c6/members |
Card | ||
---|---|---|
| ||
GET |
Card | ||
---|---|---|
| ||
Get the member list of a project along with their respective project roles. |
...
label | Request |
---|
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
...
label | Response |
---|
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
Status: 200 OK
|
|
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
[
{
"member": {
"id": "bf5b2382-1d14-b8df-8454-947f83b45c25",
"email": "testuser@bimplus.net",
"firstname" : "Test",
"lastname" : "User",
...
},
"role": {
"id": "f11d32e2-30b7-4f81-8a74-2165ecc00cf6",
"name": "Project_Editor"
},
{
"member": {
"id": "bf5b2382-1d14-b8df-8454-947f83b45c25",
"email": "customer2@bimplus.net"
"firstname" : "Some",
"lastname" : "Customer",
...
},
"role": {
"id": "e11d32e2-30b7-4f81-8a74-2165ecc00cf6",
"name": "Project_Viewer"
}
}
] |
...
Update the project role of a team member
Deck of Cards | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||
Card | | |||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||
Name | Mandatory / Optional | Type | Description | |||||||||||||||||||||||||
member | mandatory | object | The member who will be assigned a role to the project | |||||||||||||||||||||||||
id | mandatory | string (guid) | Id of the user | |||||||||||||||||||||||||
role | mandatory | object | The project role which will be assigned to the team member | |||||||||||||||||||||||||
id | mandatory | string (guid) | Id of the role |
Card | ||
---|---|---|
| ||
PUT |
Card | ||
---|---|---|
| ||
Update the project role of a team member. Only the user with "Account Owner" or "Project Owner" role can use this API call. |
Card | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||
Card | ||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||
|
Anchor | ||||
---|---|---|---|---|
|
...