Evaluation

Add participant(s) to an evaluation

POST https://api-portal.evalytics.nl/evaluation/:id/addParticipants

Add a new participant to an evaluation. You can only add participants when the evaluation has not yet been finished. You can also provide a groupId, so the group will also be linked to the invitationUser.

Path Parameters

Name
Type
Description

*

String

Internal or external id of the evaluation

{
    "newInvited": [
      "deleted": false,
      "createdBy": "123",
      "modifiedBy": null,
      "evaluator": 123,
      "evaluation": 456,
      "groupName": "Some group",
      "groupId": 1000,
      "id": 1,
      "createdAt": "2021-11-08T12:00:00.000Z",
      "updatedAt": null,
      "email": "[email protected]",
      "name": "Example Student"
    ],
    "alreadyInvited": [{
      "deleted": false,
      "createdBy": "123",
      "modifiedBy": null,
      "evaluator": 122,
      "evaluation": 456,
      "groupName": "Some group",
      "groupId": 1000,
      "id": 2,
      "createdAt": "2021-11-08T12:00:00.000Z",
      "updatedAt": null,
      "email": "[email protected]",
      "name": "Dev Student"
    }]
}

We will ignore participants that are already added to the evaluation (alreadyInvited in the API response)

You cannot add participants to an evaluation that is finished

Example post data

{
	"participants": [{
		"email": (string - required),
		"name": (string - not required),
		"group": (optional) {
			"externalId": (string)
		}, {
			"id": (int)
		},
		"labels": [{
	      		"name": (string)
	    	}]
	}]
}

Removes one or multiple participants from the evaluation

DELETE https://api-portal.evalytics.nl/evaluation/:id/participants

Remove participants from the evaluation. Please note you can only remove participants when the evaluation has not yet been finished. The invitation url will no longer work, when the student is already invited for the evaluation.

Path Parameters

Name
Type
Description

id*

String

Internal or external id of the evaluation

{
	"totalDeletedEvaluators": number
}

Example post data

{
	"participants": [{
		"email": (string - required)
	}]
}

You cannot remove participants when the evaluation has been finished

Already emailed participants can no longer use the invitation url, because they are no longer invited for the evaluation

Last updated