Membership Management Service
- Add the user to the team
- Get the member list of the team
- Update information about the user in the team
- Delete the user from the team
Membership Management Service
Please remember that the team owner cannot remove the membership from his own team.
Add the user to the team
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) |
roles |
will be ignored |
object |
Roles of the user |
member_status |
optional |
string |
Status of the membership(Active / Passive) |
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
{ "user": { "id": "b8615afc-99cc-4bcd-b0ca-ff0593ce15c6" }, "roles": [ "Member" ], "member_status": "Active" }
Status: 200 Ok
Get the member list of the team
URL: https://api-stage.bimplus.net/v2/<team_slug>/members
Example: https://api-stage.bimplus.net/v2/best-company/members
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
Status: 200 OK
[ { "user": { "id": "b8615afc-99cc-4bcd-b0ca-ff0593ce15c6", "email": "test@bimplus.net", "status": "Active" }, "roles": [ "Member" ], "status": "Active" }, { "user": { "id": "b8615afc-99cc-4bcd-b0ca-ff0593ce15c7", "email": "customer@bimplus.net", "status": "Active" }, "roles": [ "Member" ], "status": "Passive" } ]
Update information about the user in the team
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 |
status |
mandatory |
string |
Status of the membership(Active / Passive) |
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
{ "user": { "id": "b8615afc-99cc-4bcd-b0ca-ff0593ce15c7" }, "status": "Active" }
Status: 200 OK
Delete the user from the team
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
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
Status: 200 OK