POST invite users
Invites users to participate to the prioritization process. Each user will get an email message with the URL and the token that will be used to login in order to compare / rate items. Users can be selected from the list returned by list users method.
Constraints:
- The prioritization must have at least 2 criteria defined.
- If there are subcriteria, each criteria that has subcriteria must have at least 2 subcriteria defined.
- There must be at least 2 alternatives defined.
- At least one of the optional parameters must have a positive value of at least 1.
Resource URL:
https://api.priotice.se/rest/{auth}/prioritization/invite
POST parameters:
| Variable name (case sensitive) |
Required | Variable type | Note |
|---|---|---|---|
| PrioID | Required | integer | The prioritization identifier (PrioID) |
| UserID | Required | array | An array containing the UserID's of the users to be invited (the users returned by list users method) |
| CompareCriteria | Required | integer | Possible values: 1 or 0. 1 = users will be invited to compare criteria and subcriteria 0 = users will not be invited to compare criteria. |
| CompareAlternatives | Required | integer | Possible values: 1 or 0. 1 = users will be invited to compare / rate alternatives 0 = users will not be invited to compare / rate alternatives. |
Data returned
On success will return a comma separated list of the invited users (UserID). After this action, the prioritization is locked for editing so no further updates can be performed.
Example request
POST https://api.priotice.se/rest/d41d8cd98f00b204e9800998ecf8427e/prioritization/invite
Example response:
{ "Status": "success", "Data": { "UserID": "183,184,185,186,187,188" } }
CURL example:
curl --data "PrioID=50&UserID[]=183&UserID[]=184&UserID[]=185&UserID[]=186&UserID[]=187&UserID[]=188&CompareCriteria=1&CompareAlternatives=1" https://api.priotice.se/rest/a632b4ab929f0c57d5ae0ae2c/prioritization/invite