POST: Change the Status of an Evaluation
When an evaluation is assigned a “Manual Review” outcome, it goes to the Review Queue. While evaluations can be managed in the dashboard, it is also possible to change a status via API. Make sure you have your entity_token on hand.
HTTP Request: POST https://sandbox.alloy.co/v1/entities/[your-entity-token- here]/reviews
A few things to note:
- The agent whose email you include in the body of the request must be an agent on the account (View agents on the account via the main page of your account under "Agents").
- The chosen outcome for the evaluation, as well as the reason given for that outcome in the body of the API request, must perfectly match those set up in Settings --> Review Reasons.
Sample Request:
{
"agent": {
"email": "[email protected]"
},
"outcome": "Denied",
"reasons": [
"Other"
]
}
Sample Response:
{
"review_token": "R-1abdehdTTGYvghs",
"entity_token": "P-R76vhG6Vfhh8gcf",
"group_token": null,
"application_token": "skdGbsjkbGVgsvgGVa",
"application_name": "A Thing for Testing",
"outcome": "Denied",
"reasons": [
"Bad Quiz"
],
"timestamp": 124646574,
"started": 124646574,
"completed": 124646574
"agent": {
"email": "[email protected]"
}
}