Page History

...

Deck of Cards

id	bimCreateInvitation

Card

default	true
label	URL / Resource / JSON Structure

Resource: <teamslug>/invitations

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

Example: https://api-stage.bimplus.net/v2/bimplus/invitations

JSON Structure:

Name	Mandatory / Optional	Type	Description
email	mandatory	string	Email of the new user
invitationText	mandatoryoptional	string	Message text for an invited user
projects	optional	object	List of objects which contains pairs of project id with role id project id, role id, group id and role id of group where the new user is invited to. Property in the request is optional. If not present, it means that the invitation is just to the team.
status	optional	will be ignored	The status of the account (Active / Disabled)
sender	optional	string	The sender must have a valid Bimplus account and must be member of the team
team	optional	string	Team for which the invitation is valid
teamRole	optional	string	Team role is optional. If missing default is team member role
status	optional	string	Invitation status
validTo	optional	date	Date the invitation is valid to
created	optional	date	Creation date of the invitation
changed	optional	date	Recent modification date of the invitation
counter	optional	string	Home phone number of the user

Card

label	HTTP Method

POST

Card

label	Description

Creates and sends a new invitation to the new user.

JSON Structure of the projects object :

Name	Mandatory / Optional	Type	Description
projectId	mandatory	string (guid)	The id of the project where the new user is invited to.
roleId	mandatory	string (guid)	The role id for new user.
group	optional	Object	Object which contains pairs of group's id and group's role where the new user is invited to.

Card

label	HTTP Method

POST

Card

label	Description

Creates and sends a new invitation to the new user.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088

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

{
  	"email": "newuser@allplan.com",
  	"invitationText": "Some text",
  	"projects": [{
      "projectId":			"projectId": "e3921c6a-6329-441a-a715-e6c818e05043",
      			"roleId": "2baca0e4-2eee-4f7c-bc56-22ed54a1859c",
    }
  ]
}
			"group": {
				"id": "51edc181-b228-4f9e-aa3d-0a30f64695b4",
				"role": "da3c04d7-b593-4017-b6c3-4c9eed7699bb"
			}
		}
	]
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 201 Created

Code Block

borderColor	Red
lang	xml
title	JSON

{
  	"id": "55896fad-187e-47da-bdb6-b441607e3de3",
  	"email": "newuser@allplan.com",
  	"sender": {
    		"id": "b664c6d9-d8ab-4257-88b0-d38588d979dc",
    		"email": "testadmin@allplan.com",
    		"firstname": "Test",
    		"lastname": "Admin"
  	},
  	"team": {
    		"id": "d7a504fe-b2ef-4847-bf79-d3733d93e478",
    		"slug": "testteam",
    		"name": "Test Team"
  	},
  	"teamRole": "d9946cc8-8bd0-4eae-aeb1-d27b310741d7",
  	"invitationText": "Some text",
  	"created": "2016-12-01T07:51:20.843",
  	"changed": "2016-12-01T07:51:20.843",
  	"validTo": "2016-12-08T07:51:20.843",
  	"projects": [{
      			"projectId": "e3921c6a-6329-441a-a715-e6c818e05043",
      			"roleId": "2baca0e4-2eee-4f7c-bc56-22ed54a1859c",
    }
  ]
}
			"group": {
				"id": "51edc181-b228-4f9e-aa3d-0a30f64695b4",
				"role": "da3c04d7-b593-4017-b6c3-4c9eed7699bb"
			}
		}
	]
}

Anchor

	getInvitation
	getInvitation

...

Deck of Cards

id	bimGetInvitation

Card

default	true
label	URL / Resource / JSON Structure

Resource: <teamslug>/invitations/<invitation_id>

URL: https://api-stage.bimplus.net/v2/<teamslug>/invitations/<invitation_id>

Example: https://api-stage.bimplus.net/v2/bimplus/invitations/55896fad-187e-47da-bdb6-b441607e3de3

Card

label	HTTP Method

GET

Card

label	Description

Get information about a specified invitation.

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

 {
  	"id": "55896fad-187e-47da-bdb6-b441607e3de3",
  	"email": "newuser@allplan.com",
  	"sender": {
    		"id": "b664c6d9-d8ab-4257-88b0-d38588d979dc",
    		"email": "testadmin@allplan.com",
    		"firstname": "Test",
    		"lastname": "Admin"
  	},
  	"team": {
    		"id": "d7a504fe-b2ef-4847-bf79-d3733d93e478",
    		"slug": "testteam",
    		"name": "Test Team"
  	},
  	"invitationText": "Some text",
  	"created": "2016-12-01T07:51:20.843",
  	"changed": "2016-12-01T07:51:20.843",
  	"validTo": "2016-12-08T07:51:20.843",
  	"projects": [{
      			"projectId": "e3921c6a-6329-441a-a715-e6c818e05043",
      			"roleId": "2baca0e4-2eee-4f7c-bc56-22ed54a1859c"
    }
  ]
,
 			"group": {
 				"id": "51edc181-b228-4f9e-aa3d-0a30f64695b4",
 				"role": "da3c04d7-b593-4017-b6c3-4c9eed7699bb"
 			}
 		}
 	]
 }

Anchor

	updateInvitation
	updateInvitation

...

Deck of Cards

id	bimUpdateInvitation

Card

default	true
label	URL / Resource / JSON Structure

Resource: <teamslug>/invitations/<invitation_id>

URL: https://api-stage.bimplus.net/v2/ <teamslug>/invitations/<invitation_id>

Example: https://api-stage.bimplus.net/v2/bimplus/invitations/55896fad-187e-47da-bdb6-b441607e3de3

JSON Structure:

Home phone number of the user

Name	Mandatory / Optional	Type	Description
email	mandatory	string	Email of the new user
invitationText	mandatory	string	Message text for an invited user
projects	optional	object	List of objects which contains pairs of project id with role id the new user is invited to. Property in the request is optional. If not present, it means that the invitation is just to the team.
status	optional	will be ignored	The status of the account (Active / Disabled)
sender	optional	string	The sender must have a valid Bimplus account and must be member of the team
team	optional	string	Team for which the invitation is valid
teamRole	optional	string	Team role is optional. If missing default is team member role
status	optional	string	Invitation status
validTo	optional	date	Date the invitation is valid to
created	optional	date	Creation date of the invitation
changed	optional	date	Recent modification date of the invitation
counter	optional	string
	mandatory	string	Email of the new user
invitationText	mandatory	string	Message text for an invited user
projects	optional	object	List of objects which contains of project id role id, group id, role id of group where the new user is invited to. Property in the request is optional. If not present, it means that the invitation is just to the team.
status	optional	will be ignored	The status of the account (Active / Disabled)
sender	optional	string	The sender must have a valid Bimplus account and must be member of the team
team	optional	string	Team for which the invitation is valid
teamRole	optional	string	Team role is optional. If missing default is team member role
status	optional	string	Invitation status
validTo	optional	date	Date the invitation is valid to
created	optional	date	Creation date of the invitation
changed	optional	date	Recent modification date of the invitation
counter	optional	string	Home phone number of the user

JSON Structure of the projects object :

Name	Mandatory / Optional	Type	Description
projectId	mandatory	string (guid)	The id of the project where the new user is invited to.
roleId	mandatory	string (guid)	The role id for new user.
group	optional	Object	Object which contains pairs of group's id and group's role where the new user is invited to.

Card

label	HTTP Method

PUT

Card

label	Description

Update invitation information to the new user. Only the Sender is able to Update and Resend the invitation to the new user.
The invitation might change the invitation text and projects.

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

{
	"invitationText": "Some text",
	"projects": [{
			"projectId": "invitationText"e3921c6a-6329-441a-a715-e6c818e05043",
			"roleId":"Some text "2baca0e4-2eee-4f7c-bc56-22ed54a1859c",
  "projects			"group":[ {
      "projectId				"id": "e3921c6a51edc181-6329b228-441a4f9e-a715aa3d-e6c818e050430a30f64695b4",
      "roleId				"role": "2baca0e4da3c04d7-2eeeb593-4f7c4017-bc56-22ed54a1859c"
    }
  b6c3-4c9eed7699bb"
			}
		}
	]
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

title	JSON

 {
  "id":"55896fad-187e-47da-bdb6-b441607e3de3",
  "email":"newuser@allplan.com",
  "sender":{
    "id":"b664c6d9-d8ab-4257-88b0-d38588d979dc",
    "email":"testadmin@allplan.com",
    "firstname":"Test",
    "lastname":"Admin"
  },
  "team":{
    "id":"d7a504fe-b2ef-4847-bf79-d3733d93e478",
    "slug":"testteam",
    "name":"Test Team"
  },
  "invitationText":"Some text",
  "created":"2016-12-01T07:51:20.843",
  "changed":"2016-12-01T07:51:20.843",
  "validTo":"2016-12-08T07:51:20.843",
  "projects":[{
      "projectId":"e3921c6a-6329-441a-a715-e6c818e05043",
         "projectId":"e3921c6a-6329-441a-a715-e6c818e05043",
      "roleId":"2baca0e4-2eee-4f7c-bc56-22ed54a1859c""roleId":"2baca0e4-2eee-4f7c-bc56-22ed54a1859c",
	  "group": {
			"id": "51edc181-b228-4f9e-aa3d-0a30f64695b4",
			"role": "da3c04d7-b593-4017-b6c3-4c9eed7699bb"
		}
    }
  ]
}

Anchor
deleteInvitation
deleteInvitation

...

Deck of Cards

id	bimGetInvitations

Card

default	true
label	URL / Resource / JSON Structure

Resource: <teamslug>/invitations

URL: https://api-stage.bimplus.net/v2/<teamslug>/invitations

Example: https://api-stage.bimplus.net/v2/bimplus/invitations

Card

label	HTTP Method

GET

Card

label	Description

Get information about all pending invitations. Response returns list of all ( pending ) invitations.

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

 [
  {
    		"id": "55896fad-187e-47da-bdb6-b441607e3de3",
    		"email": "newuser@allplan.com",
    		"sender": {
      			"id": "b664c6d9-d8ab-4257-88b0-d38588d979dc",
      			"email": "testadmin@allplan.com",
      			"firstname": "Test",
      			"lastname": "Admin"
    		},
    		"team": {
      : {
			"id": "d7a504fe-b2ef-4847-bf79-d3733d93e478",
      			"slug": "testteam",
      			"name": "Test Team"
		},
		"invitationText": "Some   },
    "invitationText": "Some text",
    "createdtext",
		"created": "2016-12-01T07:51:20.843",
		"changed": "2016-12-01T07:51:20.843",
		"validTo": "2016-12-01T0708T07:51:20.843",
    "changed		"projects": [{
				"projectId": "2016e3921c6a-6329-12-01T07:51:20.843441a-a715-e6c818e05043",
    "validTo				"roleId": "2016-12-08T07:51:20.843",
    "projects": [
      {
        "projectId2baca0e4-2eee-4f7c-bc56-22ed54a1859c",
				"group": {
					"id": "e3921c6a51edc181-6329b228-441a4f9e-a715aa3d-e6c818e050430a30f64695b4",
        "roleId					"role": "2baca0e4da3c04d7-2eeeb593-4f7c4017-bc56b6c3-22ed54a1859c"
      }
    ]
  4c9eed7699bb"
				}
			}
		]
	}
]

Math Editor

Space shortcuts

Page tree

Versions Compared

Old Version 8

New Version Current

Key

Anchor
deleteInvitation
deleteInvitation

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 8

New Version Current

Key

AnchordeleteInvitationdeleteInvitation

Anchor
deleteInvitation
deleteInvitation