Page History

...

Membership Management Service

...

Deck of Cards

id	bimAddUserToTeam

Card

default	true
label	URL / Resource / JSON Structure

Resource: <team_slug>/members

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

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

JSON Structure:

Name	Mandatory / Optional	Type	Description
user	mandatory	object	Information of the user
user.id	mandatory	string	Id of the user
user.email	will be ignored	string	Email of the user
user.status	will be ignored	string	Status of the user (Active / Inactive)
rolesrole	will be ignoredoptional	objectstring	Roles Team role of the user (Member / Admin / Owner / Guest), default is Member
member_status	optional	string	Status of the membership (Active / Passive), default is Active

Card

label	HTTP Method

POST

Card

label	Description

Add a specified user to a specified team.

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

{
    "user": {
        "id": "b8615afc-99cc-4bcd-b0ca-ff0593ce15c6"
    },
      "rolesmember_status": [
        "Member"
    ],Active"
    "member_statusrole": "ActiveMember"

}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 Ok

Code Block

title	JSON

{
    "user": {
      "id": "3d676814-cf37-aa43-ed03-4b156c282fa1",
      "email": "testuser@allplan.com",
      "status": "Active",
      "firstname": "Test",
      "lastname": "User",
      "company": "Allplan",
      "fullname": "Test User",
      "displayname": "Test User [Allplan]",
      "info": null,
      "gender": "MR",
      "phoneWork": null,
      "phoneHome": null,
      "fax": null,
      "mobile": "123",
      "birthDate": null,
      "address": {
        "street": "",
        "streetNr": "",
        "zip": "",
        "city": "",
        "country": ""
      },
      "preferedLanguage": "en"
    },
    "rolesrole": [
      "Member"
    ],
    "member_status": "Active"
  }

Anchor

	getMembersOfTeam
	getMembersOfTeam

...

Deck of Cards

id	bimGetMemberListInfo

Card

default	true
label	URL / Resource / JSON Structure

Resource: <team_slug>/members

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

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

Card

label	HTTP Method

GET

Card

label	Description

Gets the member list of a specified team.

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

[
    {
        "user": {
            "id": "b8615afc3d676814-99cccf37-4bcdaa43-b0caed03-ff0593ce15c64b156c282fa1",
            "email": "test@bimplustestuser@allplan.netcom",
            "status": "Active",
      "firstname": "Test",
      "lastname": "User"
        },
        "roles": [
            "Member"
        ],
      "company": "Allplan",
      "fullname": "Test User",
      "displayname": "Test User [Allplan]",
      "info": null,
      "gender": "MR",
      "phoneWork": null,
      "phoneHome": null,
      "fax": null,
      "mobile": "123",
      "birthDate": null,
      "address": {
        "street": "",
        "streetNr": "",
        "zip": "",
        "city": "",
        "country": ""
      },
      "preferedLanguage": "en"
    },
    "role": "Member",
    "member_status": "Active"
    },
    {
        "user": {
            "id": "b8615afc0d545b40-99cc9258-4bcd42f2-b0ca8e0e-ff0593ce15c7e2325a8eb446",
            "email": "customer@bimplustestuser2@allplan.netcom",
            "status": "Active",
      "firstname": "Test",
      "lastname": "User2",
      "company": "
        },
        "roles": [
            "Member"
        ],
        "status": "Passive"
   Allplan",
      "fullname": "Test User2",
      "displayname": "Test User2 [Allplan]",
      "info": null,
      "gender": "MR",
      "phoneWork": null,
      "phoneHome": null,
      "fax": null,
      "mobile": "123",
      "birthDate": null,
      "address": {
        "street": "",
        "streetNr": "",
        "zip": "",
        "city": "",
        "country": ""
      },
      "preferedLanguage": "de"
    },
    "role": "Member",
    "member_status": "Active"
  }
]

Anchor

	updateUserInTeam
	updateUserInTeam

Update

...

user's membership in the team

Deck of Cards

id	bimUpdateUserInfoInTeam

Card

default	true
label	URL / Resource / JSON Structure

Resource: <team_slug>/members/<user_id>

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

Example: https://api-stage.bimplus.net/v2/best-company>/members/b8615afc-99cc-4bcd-b0ca-ff0593ce15c6

JSON Structure:

Name	Mandatory / Optional	Type	Description
user	mandatory	object	Information of the user
user.id	mandatory	string	Id of the user
member_status	mandatory	string	Status of the membership(Active / Passive)
role	optional	string	Team role of the user (Guest /Member / Admin / Owner ), default is Member

Card

label	HTTP Method

PUT

Card

label	Description

Update information about a specified user in a team.user's membership in the team by changing his status

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

{
        "user": {
            "id": "b8615afc-99cc-4bcd-b0ca-ff0593ce15c7"
        },
    "role": "Admin"
    "member_status": "Active"
    }

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Anchor

	deleteUserFromTeam
	deleteUserFromTeam

...

Remove user from the team

Deck of Cards

id	bimDeleteUserFromTeam

Card

default	true
label	URL / Resource / JSON Structure

Resource: <team_slug>/members/<user_id>

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

Example: https://api-stage.bimplus.net/v2/best-company/members/b8615afc-99cc-4bcd-b0ca-ff0593ce15c6

Card

label	HTTP Method

DELETE

Card

label	Description

Deletes a specified user from a team.

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

...

Math Editor

Space shortcuts

Page tree

Versions Compared

Old Version 3

New Version Current

Key

Membership Management Service

Update

user's membership in the team

Remove user from the team