Add users - Assessment Sharing
  • 02 Nov 2021
  • 1 Minute to read
  • Contributors
  • Dark
    Light
  • PDF

Add users - Assessment Sharing

  • Dark
    Light
  • PDF

Article summary

Add users - Sharing

PUT /assessment/{externalId}/sharing

NameData TypeDescription
Content-type:application/jsonfor all requests
Authorization:EAPI {token}for all requests

Body Parameters

Parameters indicated with a * are mandatory

Name
Data Type
Description
*[].UserNameString)UserName
*[].RoleStringUser’s role (Name of role from Assessment Roles)

Sample Request URL

https://api.cirrusplatform.com/api/v1/integrations/assessment/ColExt1/sharing 

Sample Request

[{
	"userName": "user1",
	"role": "author"
},
{
	"userName": "user2",
	"role": "author"
}]

Sample Response

{
	"Content": {
		"SuccessfullyShared": ["user1"],
		"Errors": [{
			"UserName": "user2",
			"Error": "Assessment has already been shared with this user!"
		},
		{
			"UserName": "user3",
			"Error": "Assessment has already been shared with this user!"
		}]
	},
	"Success": true,
	"Errors": null
}

Response codes

CodeDescription
200Successful operation
403Not allowed to use external API
400Possible error codes:
Assessment hasn't been found by external id externalId
List of sharing users are not specified
500Internal server error


Was this article helpful?

What's Next