Question Escalation

Question escalation is a feature which, when enabled, escalates unsolved questions to a specified list of users by sending a notification to them. Question are escalated when they were published after a configurable start date and have gotten no response within a configurable amount of time after publication. By default, questions are only escalated when they have received neither comments nor solutions. It can be configured to escalate all questions without solution, ignoring any comments that might exist. By default, all questions that fulfill the above conditions will be escalated. It can be configured that only the first question a user poses gets escalated.



Get question escalation settings

GET /settings/question-escalation

Response

{
  "tolerance": 120,
  "ignore_comments": true,
  "first_only": false,
  "users": [
    {
        "location": "London",
        "image": "http://cdn.starmind.com:8080/static/user/default.jpg",
        "firstname": "Siger",
        "email": "siger.holmes@example.com",
        "is_deleted": false,
        "lastname": "Holmes",
        "id": 17309,
        "is_deleted": false,
        "customfields": { "occupation": "Detective" }
    }
  ],
  "enabled": false,
  "start": "2015-01-15T00:00:00.000Z"
}


Set question escalation settings

PUT /settings/question-escalation
Parameter Type Description
enabled boolean Whether question escalation is enabld or not.
start date-time If set only questions created after the start date are escalated.
ignore_comments boolean If set to true, only question without solutions are escalated.
first_only boolean If set to true, only the first question a user poses will be escalated.
tolerance int Tolerance in hours after which an unsolved question is escalated.
users array List of users for which notifications should be generated in case of an escalation.

Request

{
  "tolerance": 120,
  "ignore_comments": true,
  "first_only": false,
  "users": [17309],
  "enabled": false,
  "start": "2015-01-15T00:00:00.000+01:00"
}

Response

{
  "tolerance": 120,
  "ignore_comments": true,
  "first_only": false,
  "users": [
    {
        "location": "London",
        "image": "http://cdn.starmind.com:8080/static/user/default.jpg",
        "firstname": "Siger",
        "email": "siger.holmes@example.com",
        "is_deleted": false,
        "lastname": "Holmes",
        "id": 17309,
        "is_deleted": false,
        "customfields": { "occupation": "Detective" }
    }
  ],
  "enabled": false,
  "start": "2015-01-14T23:00:00.000Z"
}