Page History

Rights and Roles Service

Rights and Roles

Rights and Roles Service

Rights and Roles

Anchor

	getAllRoles
	getAllRoles

Get all the available roles

Deck of Cardstab-group

iddeckId	bimGetAllRoles

Cardtab

default	true
labeltitle	URL / Resource / JSON Structure

Resource: <team_slug>/roles

URL: https://api-stage.bimplus.net/v2/<team_slug>/roles

Example: https://api-stage.bimplus.net/v2/best-company/roles

Optional query parameters

Name	Type	Default value	Description
rights	boolean	true	When query parameter "rights=false" is defined, the API call will returns all roles. i.e. not only roles which contains resources and right definitions. When query parameter is missing, the API call returns only roles which includes resources and rights definitions.
customrole	boolean		When query parameter customrole is defined e.g. "customrole=true", the API call will returns only roles which have value of property "customRole" equal to query parameter. When query parameter is missing, the API call returns all roles (i.e. their customRole property can be true or false)

Cardtab

labeltitle	HTTP Method

GET

Cardtab

labeltitle	Description

Get all the available roles. Right now, we support only project based roles and custom roles.

Here is the definition of Bimplus Rights and Roles.

	Account Owner	Project Admin	Project Editor	Project Viewer
Create project	x
Admin project	x	x
Delete project	x	x
Edit project	x	x	x
View project	x	x	x	x
Create model	x	x
View all models	x	x	x	x

Model rights and roles are not supported yet, the project rights are used instead - meaning e.g. update model requires ProjectEdit rights

The custom roles contains also definition for which resource and rights are valid.

Cardtab

labeltitle	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Cardtab

labeltitle	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 Ok

Code Block

borderColor	Red
lang	xml
title	JSON

[	{
    		"id": "01943654a298b28d-cac69711-45024a76-b6409a7d-192f7a1f6a6d910cbf144ee5",
    		"name": "TesdetProject_Admin",
		"type":    "Project",
		"rank": 3,
		"customRole": true,
    		"resources": [{
        				"id": "4e587ea1cc49128e-50989416-45cd4bfc-9655a695-15f90c16dc58b17365dc7a5e",
        				"resource": "LayerProject",
        "rights":["RoomModel"
        ],
        				"rights": [
					"ProjectAdmin"
				],
				"rightsAccess": [{
            						"id": "52bbc329815ce797-dab3da07-a81c4372-b5488a59-09c715786a81609f7106ab09",
            "name":"RoomModel",
            						"name": "Project",
						"access": "Edit"
          }
        ]
      }
    ]
  },
  {
    Admin"
					}
				]
			}
		]
	}, {
		"id": "f11d32e2a618d075-30b77e4a-4f814bde-8a749d58-2165ecc00cf6d2979696fa96",
    		"name": "Project_EditorViewer",
		"type":    "Project",
		"rank": 1,
		"customRole": true,
    		"resources": [{
        				"id": "4e587ea1cc49128e-50989416-45cd4bfc-9655a695-15f90c16dc58b17365dc7a5e",
        				"resource": "LayerProject",
        				"rights": ["DoorWindow"
        ],
        
					"ProjectView"
				],
				"rightsAccess": [{
            						"id": "8ba5ec82815ce797-5b93da07-61924372-55b08a59-b7790f4d0007609f7106ab09",
            						"name": "DoorWindowProject",
            						"access": "Edit"
          }
        ]
      },
      {
        "id":"cc49128e-9416-4bfc-a695-b17365dc7a5e",
        "resource":"Project",
        "rights":["ProjectView"
        ],
        "rightsAccess":[{
            "id":"815ce797-da07-4372-8a59-609f7106ab09",
            "name":"Project",
            "access":"View"
          }
        ]
      }
    ]
  },
  ...
]

...

View"
					}
				]
			}
		]
	}
...
]

Anchor

	getAllRights
	getAllRights

Get all the available rights

Tab Group

deckId	bimGetAllRights

Tab

default	true
title	URL / Resource / JSON Structure

Resource: <team_slug>/rights

URL: https://api-stage.bimplus.net/v2/<team_slug>/rights

Example: https://api-stage.bimplus.net/v2/best-company/rights

JSON Structure:

Name	Mandatory / Optional	Type	Description
id	mandatory	string (guid)	Id of the right resource type
resource	mandatory	string	The name of the right resource type
rights	mandatory	object	Dictionary of the pairs of right id together with its name
access	mandatory	JSON Array	Array of the strings represented access right. Can be combination of predefined rights "View", "Edit", "Admin"

Optional query parameters:
Following query parameters allows reduce set of returned right resource types. By default will be returned all defined right resource types.

Name	Type	Default value	Description
project	boolean	true	When query parameter "project=false" is defined, the API call will returns all right resource types except project right resource type.
global	boolean	true	When query parameter "global=false" is defined, the API call will returns all right resource types except global right resource type.
document	boolean	true	When query parameter "document=false" is defined, the API call will returns all right resource types except document right resource type.
globalfreeattributes	boolean	true

...

Get all the available rights

Deck of Cards

id	bimGetAllRights

Optional query parameters:
Following query parameters allows reduce set of returned right resource types. By default will be returned all defined right resource types.

Card

default	true
label	URL / Resource / JSON Structure

Resource: <team_slug>/rights

URL: https://api-stage.bimplus.net/v2/<team_slug>/rights

Example: https://api-stage.bimplus.net/v2/best-company/rights

JSON Structure:

Name

Mandatory / Optional

Type

Description

id

mandatory

string (guid)

Id of the right resource type

resource

mandatory

string

The name of the right resource type

rights

mandatory

object

Dictionary of the pairs of right id together with its name

access

mandatory

JSON Array

Array of the strings represented access right. Can be combination of predefined rights "View", "Edit", "Admin"

When query parameter "project project

Name	Type	Default value	Description
project	boolean	true	When query parameter "globalfreeattributes	=false" is defined, the API call will returns all right resource types except	globalfreeattributes right resource type.global

boolean

Tab

title

true

When query parameter "global=false" is defined, the API call will returns all right resource types except global right resource type.

document

boolean

true

When query parameter "document=false" is defined, the API call will returns all right resource types except document right resource type.

globalfreeattributes

boolean

true

When query parameter "globalfreeattributes=false" is defined, the API call will returns all right resource types except globalfreeattributes right resource type.

layer

boolean

true

When query parameter "layer=false" is defined, the API call will returns all right resource types except layer right resource type.

Card

label	HTTP Method

GET

Card

label	Description

Get all the available rights returns array of right resource types with defined rights.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

HTTP Method

GET

Tab

title	Description

Get all the available rights returns array of right resource types with defined rights.

Tab

title	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Tab

title	Response

Code Block

title
borderColor	Green
lang	xml

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 Ok

Code Block

borderColor	Red
lang	xml
title	JSON

[  {
    "id":"4e587ea1173e7a88-509816d9-45cd4d88-965592bf-15f90c16dc58270fff458435",
    "resource":"LayerDocument",
    "rights":{
      "231222ba73ca755b-7495eb41-f4384abf-cf388d72-629cf04823646360f638a34c":"buildingdocumentshare",
      "dd9b9e2cf53dac0d-f4af8ef8-576f48bd-4dda9fa5-9e122ab13d31b49831bcf671":"general objectsdocumentdelete",
      "92f8a3616513c54f-59900531-0cb047e2-b257853d-e13c85f0f7b156a25a226765":"mepdocumentdownloaddenied",
      "0047e2ed820eb26b-33487469-a97b48bd-93d2b10f-a6817cc9cb8e0c69e631c910":"steel designdocumentviewdenied",
      "8095dfcfd7727bed-fbdf38b8-33174a77-b873b61d-a7cbccccb206397fb01f1ad8":"timber designdocumentupdate",
    },
  "f7819a2d-1498-2468-b120-fdefedfccf0b  "access":["terrain"Edit"
    ]
  },
  {
    "id":"903fe394cc49128e-5e849416-5c8d4bfc-2760a695-eeadad3baa35b17365dc7a5e":"reinforcement",
      "44c2ff85-9691-6def-9583-56d8b776c846"resource":"finishProject",
      "6719f657-ea4a-3016-1bda-0c56c7f113d4rights":"inventory",{
      "52bbc329815ce797-dab3da07-a81c4372-b5488a59-09c715786a81609f7106ab09":"roomproject",
    },
    "4a4da391-b804-b20f-f49a-470bdc68be8f":"structural analysis""access":["View",
      "7f27fd11-7992-8fb5-3541-9daa4f8196b2":"opening"Edit",
      "8ba5ec82-5b93-6192-55b0-b7790f4d0007":"door/window",Admin"
    ]
  "5c695e85-ea7c-7df4-9fb7-eca7aa1f69fd":"precast"},
  {
    "id"85d0b1a9:"9dae8bb5-11bb77c1-6de147a6-9cfda916-54f85ee11da3":d4948583b0b9"bridge",
    "resource":"Global",
    "rights":{
      "d726e8d2c64151c5-12c6ecde-641d4e2c-b19dba53-37511349dce1d0390f480461":"structural loadsprojectdelete",
      "3517d0e26bbc401b-98147cd5-fc084684-b3e7a11d-59d453940efae2448befb3c1":"connectionprojectcreate",
    },
    "access"99bad6fc-0539-4848-84af-62b6df31eaa3":["Viewallattributes",
      "Edit"3b3f10c1-93a6-4d15-a727-e38e2fb9b0b2":"alldocuments",
    ]
    "cc3416d3-c570-4dc6-aa84-72216d3f58da":"allmodels",
      "9351251b-9631-499e-8e23-68ffe70ef3b7":"allprojects"
    },
    "access":["Edit"
    ]
  },
  {
    "id":"173e7a88500766a6-16d92525-4d8845db-92bfb9cd-270fff458435b2a3d8092ba9",
    "resource":"DocumentGlobalFreeAttributes",
    "rights":{
      "73ca755b061a3842-eb419b4d-4abf4d19-8d728651-6360f638a34c2f9373c42842":"documentsharefreeattribute",
      "f53dac0d63b9bfad-8ef8db9f-48bd4bbe-9fa5a902-b49831bcf6717716c440a200":"documentdeleteattributetemplate",
      "6513c54f04f5c272-05313dec-47e24bce-853d85ae-56a25a2267656abb2e936ef8":"documentdownloaddeniedprojectattributetemplate",
      "820eb26b2a0e7bed-74699fbf-48bd46bc-b10f987a-0c69e631c9107a6c5c638f98":"documentviewdeniedfreeattributegroup",
      "d7727bedb886cab2-38b8fcce-4a77-b61dab2d-397fb01f1ad809f704e363b7":"documentupdateteammembership"
    },
    "access":["Edit"
    ]
  }View",
  {
    "id":"cc49128e-9416-4bfc-a695-b17365dc7a5e",Edit"
    "resource":"Project",
    "rights":{
      "815ce797-da07-4372-8a59-609f7106ab09":"project"
    },
    "access":["View",
      "Edit",
      "Admin"
    ]
  },
  {
    "id":"9dae8bb5-77c1-47a6-a916-d4948583b0b9",
    "resource":"Global",
    "rights":{
      "c64151c5-ecde-4e2c-ba53-d0390f480461":"projectdelete",
      "6bbc401b-7cd5-4684-a11d-e2448befb3c1":"projectcreate",
      "99bad6fc-0539-4848-84af-62b6df31eaa3":"allattributes",
      "3b3f10c1-93a6-4d15-a727-e38e2fb9b0b2":"alldocuments",
      "cc3416d3-c570-4dc6-aa84-72216d3f58da":"allmodels",
      "9351251b-9631-499e-8e23-68ffe70ef3b7":"allprojects"
    },
    "access":["Edit"
    ]
  },
  {
]
  }
]

Anchor

	getRoleDetails
	getRoleDetails

Get details of the role

Tab Group

deckId	bimGetRoleDetails

Tab

default	true
title	URL / Resource / JSON Structure

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/94a60a79-7c81-454b-8158-ffdb9a2bf4d6

Tab

title	HTTP Method

GET

Tab

title	Description

Get details of a specified role.

Tab

title	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Tab

title	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "id" : "94a60a79-7c81-454b-8158-ffdb9a2bf4d6",
  "name":"Test",
  "customRole":true,
  "resources":[{
      "id":"500766a64e587ea1-25255098-45db45cd-b9cd9655-b2a3d8092ba915f90c16dc58",
      "resource":"GlobalFreeAttributesLayer",
      "rights":{["Room"
      "061a3842-9b4d-4d19-8651-2f9373c42842":"freeattribute"],
      "63b9bfad-db9f-4bbe-a902-7716c440a200":"attributetemplate",
rightsAccess":[{
          "id":"04f5c27252bbc329-3decdab3-4bcea81c-85aeb548-6abb2e936ef809c715786a81":"projectattributetemplate",
      "2a0e7bed-9fbf-46bc-987a-7a6c5c638f98":"freeattributegroup",
      "b886cab2-fcce-4a77-ab2d-09f704e363b7name":"teammembershipRoomModel",
    },
      "access":["ViewEdit",
        "Edit"}
      ]
    }
  ]
}

Anchor

	createNewRolegetAllProjectRolesFromRightsAndRolesTemplate	createNewRole

Create a new role

	getAllProjectRolesFromRightsAndRolesTemplate

Get all project's roles assigned by right and roles template

Tab Group

deckId	bimGetAllProjectRolesFromRightsAndRolesTemplate

Tab

Deck of Cards

id	bimCreateNewRole

JSON Structure of the right resource type definition object:

Card

default	true
labeltitle	URL / Resource / JSON Structure

Resource: <teamprojects/<project_slug>id>/roles

URL: https://api-stage.bimplus.net/v2/<team_slug>/rolesprojects/<project_id>/roles

Example: https://api-stage.bimplus.net/v2/bimplus/projects/b8615afc-99cc-4bcd-b0ca-ff0593ce15c6/roles

JSON Structure:

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 :

id is string (Guid) represent id of right
name is string representing name of right e.g. "RoomModel",
access is string representing access right of the right e.g. "View"

Card

label	HTTP Method

POST

Card

label	Description

Creates a new role with defined properties and resources to be valid for.

The structure of object is the same as in get all available roles.
The rightsandrolestemplate query parameter should not be used, due to it is implicitly set to actual project rights and roles template id.

Tab

title	HTTP Method

GET

Tab

title	Description

Each project has by default assigned free attribute "RightsAndRoles template" which defines rights and roles template.

The API call will returns all project's roles assigned by rights and roles template.

Tab

title	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Tab

title	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 201 Created

Code Block

borderColor	Red
lang	xml
title	JSON

[
    {
        "id": "94a60a79-7c81-454b-8158-ffdb9a2bf4d6",
        "name": "TEST1",
        "customRole": true,
        "resources": [
            {

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "name":"Test",
  "customRole":true,
  "resources":[{
      "id": "4e587ea1-5098-45cd-9655-15f90c16dc58",
                "resource": "Layer",
      "rights":["RoomModel"
      ],
      "rightsAccessrights": [{
          "id":"52bbc329-dab3-a81c-b548-09c715786a81",
          "name":"RoomModel",
          "access":"Edit"
      ],
    }
      ]
    }
  ]
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 201 Created

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "name":"Test",
  "customRole":true,
  "resources":[{
  "rightsAccess": [
            "id":"4e587ea1-5098-45cd-9655-15f90c16dc58",
      "resource":"Layer",
  {
    "rights":["RoomModel"
      ],
      "rightsAccess":[{
          "id": "52bbc329-dab3-a81c-b548-09c715786a81",
                        "name": "RoomModel",
                        "access": "Edit"
                    }
          ]
    }
  ]
}

...

Get details of the role

Deck of Cards

id	bimGetRoleDetails

Card

default	true
label	URL / Resource / JSON Structure

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

label	HTTP Method

GET

Card

label	Description

Get details of a specified role.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "name":"Test",
  "customRole":true,
  "resources":[{
            }
        ]
    },
    {
        "id": "391fb0fc-43ec-464c-bd18-b5223b32bd14",
        "name": "TEST2",
        "customRole": true,
        "resources": [
            {
                "id": "52bbc3299dae8bb5-dab377c1-a81c47a6-b548a916-09c715786a81d4948583b0b9",
                "resource": "UserRightLayerGlobal",
                "rights": ["Room"
      ],
      "rightsAccess":[{
          "id":"4e587ea1-5098-45cd-9655-15f90c16dc58"AllModels",
          "name":"Room",
          "access":"View"ProjectCreate",
        }
        ]
    }"AllAttributes"
  ]
}

...

Update the role

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

Json structure : See above in Create a new role section.

Deck of Cards

id	bimUpdateTheRole

Card

default	true
label	URL / Resource / JSON Structure

Card

label	HTTP Method

PUT

Card

label	Description

Update the role.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "name":"Test",
  "customRole":true,
  "resources":[{
      "id":"52bbc329-dab3-a81c-b548-09c715786a81",
                ],
                "rightsAccess": [
                    {
                        "id": "cc3416d3-c570-4dc6-aa84-72216d3f58da",
                        "resourcename": "UserRightLayerAllModels",
      "rights":["Room"
       ],
           "rightsAccessaccess":[{ "Edit"
          "id":"4e587ea1-5098-45cd-9655-15f90c16dc58",
          "name":"Room"},
          "access":"View"
          }{
      ]
      }
  ]
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

title	JSON

{
  "name":"Test",
  "customRole":true,
  "resources":[{
      "id": "52bbc3296bbc401b-dab37cd5-a81c4684-b548a11d-09c715786a81e2448befb3c1",
      "resource":"UserRightLayer",
      "rights":["Room"
      ],
      "rightsAccessname":[{
 "ProjectCreate",
            "id":"4e587ea1-5098-45cd-9655-15f90c16dc58",
            "nameaccess": "RoomEdit",
           "access":"View"
         },
                    ]{
    }
  ]
}

...

                    "id": "99bad6fc-0539-4848-84af-62b6df31eaa3",
                        "name": "AllAttributes",
                        "access": "Edit"
                    }
                ]
            }
        ]
    }
...
]

Anchor

	assignProjectRole
	assignProjectRole

...

Delete the role

Deck of Cards

id	bimDeleteTheRole

Card

default	true
label	URL / Resource / JSON Structure

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

label	HTTP Method

DELETE

Card

label	Description

Deletes a specified role.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

...

Make a team member part of a project by assigning a role to him

Deck of Cardstab-group

iddeckId	bimassignProjectRole

Cardtab

default	true
labeltitle	URL / Resource / JSON Structure

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

JSON Structure:

Name

Mandatory / Optional

Type

Description

member

mandatory

object

The member who will be assigned a role to the project.
The object has a mandatory property name "id" which represents Id of the user, its type is string(guid)

role

mandatory

object

The project role which will be assigned to the team member.
The object has a mandatory property name "id" which represents Id of the role, its type is string(guid)

Card

label	HTTP Method

POST

Card

label	Description

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.

-99cc-4bcd-b0ca-ff0593ce15c6/members

JSON Structure:

Name	Mandatory / Optional	Type	Description
member	mandatory	object	The member who will be assigned a role to the project. The object has a mandatory property name "id" which represents Id of the user, its type is string(guid)
role	mandatory	object	The project role which will be assigned to the team member. The object has a mandatory property name "id" which represents Id of the role, its type is string(guid)
roles	mandatory	JSON Array	Array of role objects, each object must have defined role id.
group	optional	Object	Object which contains pairs of group's id and group's role where the new user belongs.

Tab

title	HTTP Method

POST

Tab

title	Description

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.

Tab

title	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "member": {
    "id": "bf5b2382-1d14-b8df-8454-947f83b45c25",
  },
  "role": {
    "id": "f11d32e2-30b7-4f81-8a74-2165ecc00cf6",
  }
  "roles":[
    {
      "id": "f11d32e2-30b7-4f81-8a74-2165ecc00cf6",
    },
    {
      "id":"391fb0fc-43ec-464c-bd18-b5223b32bd14",
    },
    {
      "id":"33078aed-0473-4714-beb9-ab989959afdd",
    }
  ],
  "group": {
  	"id": "9a63fe8e-4b80-4c21-af1b-4344f95df6bc",
  	"role": "da3c04d7-b593-4017-b6c3-4c9eed7699bb"
  }		
}

Tab

title	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 201 Created

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "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"
  }
  "roles":[
    {
      "id": "f11d32e2-30b7-4f81-8a74-2165ecc00cf6",
      "name": "Project_Editor"
    },
    {
      "id":"391fb0fc-43ec-464c-bd18-b5223b32bd14",
      "name":"Architekt"
    },
    {
      "id":"33078aed-0473-4714-beb9-ab989959afdd",
      "name":"BuildingEditor"
    }
  ],
  "group": {
  	"id": "9a63fe8e-4b80-4c21-af1b-4344f95df6bc",
  	"role": "da3c04d7-b593-4017-b6c3-4c9eed7699bb"
  }
}

Anchor

	getMembersWithRoles
	getMembersWithRoles

Get the project members along with their respective roles

Tab Group

deckId	bimGetMembersWithRoles

Tab

default	true
title	URL / Resource / JSON Structure

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

Tab

title	HTTP Method

GET

Tab

title	Description

Get the member list of a project along with their respective project roles.

Tab

title	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Tab

title	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

borderColor	Red
lang	xml
title	JSON

[
  {
    "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"
    }
    "roles":[
      {
        "id": "f11d32e2-30b7-4f81-8a74-2165ecc00cf6",
        "name": "Project_Editor"
      },
      {
        "id":"391fb0fc-43ec-464c-bd18-b5223b32bd14",
        "name":"Architekt"
      },
      {
        "id":"33078aed-0473-4714-beb9-ab989959afdd",
        "name":"BuildingEditor"
      }
    ],
    "group": {
  	"id": "9a63fe8e-4b80-4c21-af1b-4344f95df6bc",
  	"role": "da3c04d7-b593-4017-b6c3-4c9eed7699bb"
  	}
  },
 {

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "member": {
      "id" : "bf5b2382-1d14-b8df-8454-947f83b45c25",
  },
    role"email": {"customer2@bimplus.net"
      "idfirstname" : "f11d32e2-30b7-4f81-8a74-2165ecc00cf6"
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 201 Created

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "memberSome",
      "lastname" : "Customer",
      ...
    },
    "role": {
      "id": "bf5b2382e11d32e2-1d1430b7-b8df4f81-84548a74-947f83b45c252165ecc00cf6",
      "emailname": "testuser@bimplus.net",Project_Viewer"
    "firstname" : "Test",}
    "lastnameroles" : "User",[
    ...
  },{
  "role": {
      "id": "f11d32e2e11d32e2-30b7-4f81-8a74-2165ecc00cf6",
    "name": "Project_Editor"
}

...

    "name": "Project_Viewer"
      },
    ],
    "group": {
  	"id": "9a63fe8e-4b80-4c21-af1b-4344f95df6bc",
  	"role": "da3c04d7-b593-4017-b6c3-4c9eed7699bb"
  	}
  }
]

Anchor

	updateProjectRole
	updateProjectRole

Update the project role of a team member

Tab Group

deckId	bimUpdateProject

Tab

default	true
title	URL / Resource / JSON Structure

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

JSON Structure:

Name	Mandatory / Optional	Type	Description
member	mandatory	object	The member who will be assigned a role to the project. Object must have set "id" as string(guid) - Id of the user.
role	mandatory	object	The project role which will be assigned to the team member. Object must have set "id" as string(guid) - Id of the role
roles	mandatory	JSON Array	Array of role objects, each object must have defined role id.
group	optional	Object	Object which contains pairs of group's id and group's role where the new user belongs.

Tab

title	HTTP Method

PUT

Tab

title	Description

Update the project role of a team member. Only the user with "Account Owner" or "Project Owner" role can use this API call.

Tab

title	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "member":{
    "id":"efeb4da2-1c7c-4aa8-ab13-28638f9669a8"
  },
  "role":{
    "id":"a298b28d-9711-4a76-9a7d-910cbf144ee5"
  },
  "roles":[{
      "id":"5d4eaafa-aed0-4c53-803d-2fb7fa6a208b"

...

Get the project members along with their respective roles

Deck of Cards

id	bimGetMembersWithRoles

Card

default	true
label	URL / Resource / JSON Structure

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

label	HTTP Method

GET

Card

label	Description

Get the member list of a project along with their respective project roles.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

borderColor	Red
lang	xml
title	JSON

[
  {
    "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": "e11d32e272fd3336-30b77df5-4f81410d-8a74-2165ecc00cf6",
      "name": "Project_Viewer"a883-98318e6337b6"
    }
  }
]

...

],
  "group": {
  	"id": "9a63fe8e-4b80-4c21-af1b-4344f95df6bc",
  	"role": "da3c04d7-b593-4017-b6c3-4c9eed7699bb"
  }		
}

Tab

title	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

title	JSON

{
  "member": {
    "id": "bf5b2382-1d14-b8df-8454-947f83b45c25",
    "email": "testuser@bimplus.net",
    "firstname" : "Test",
    "lastname" : "User",
    ...
  },
  "role

...

Update the project role of a team member

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

JSON Structure:

Deck of Cards

id	bimUpdateProject

Card

default	true
label	URL / Resource / JSON Structure

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

label	HTTP Method

PUT

Card

label	Description

Update the project role of a team member. Only the user with "Account Owner" or "Project Owner" role can use this API call.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
  "member": {
    "id": "bf5b2382f11d32e2-1d1430b7-b8df4f81-8454-947f83b45c258a74-2165ecc00cf6",
    "name": "Project_Editor"
  },
  "roleroles":[
    {
      "id": "f11d32e2-30b7-4f81-8a74-2165ecc00cf6"
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

title	JSON

{
,
      "membername": "Project_Editor"
    },
    {
      "id": "bf5b2382391fb0fc-1d1443ec-b8df464c-8454bd18-947f83b45c25b5223b32bd14",
      "emailname": "customer@bimplus.net"Architekt"
    },
    {
      "firstnameid" : "Some:"33078aed-0473-4714-beb9-ab989959afdd",
      "lastnamename" : "CustomerBuildingEditor",
    ...}
  }],
  "rolegroup": {
    	"id": "f11d32e29a63fe8e-30b74b80-4f814c21-8a74af1b-2165ecc00cf64344f95df6bc",
    	"namerole": "Project_Viewer"
da3c04d7-b593-4017-b6c3-4c9eed7699bb"
  }		
}

Anchor

	deleteProjectRole
	deleteProjectRole

Remove the user from the project

Deck of Cardstab-group

iddeckId	bimdeleteProjectRole

Cardtab

default	true
labeltitle	URL / Resource / JSON Structure

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

Cardtab

labeltitle	HTTP Method

DELETE

Cardtab

labeltitle	Description

Remove the user from a project

Cardtab

labeltitle	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Cardtab

labeltitle	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

...

Math Editor

Space shortcuts

Page tree

Versions Compared

Old Version 29

New Version Current

Key

Rights and Roles Service

Rights and Roles

Rights and Roles Service

Rights and Roles

Get all the available roles

Get all the available rights

Get all the available rights

Get details of the role

Create a new role

Get all project's roles assigned by right and roles template

Get details of the role

Update the role

Delete the role

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

Get the project members along with their respective roles

Update the project role of a team member

Remove the user from the project