bots

List Escalations

Changed on

The decisions the bot has handed back to its owner during this call.

Each entry carries the question, its category, who asked, and the owner's answer once one was posted. The same list is in the call-end event. Only the API key that created the bot may read it.

get/bots/{bot_id}/escalations

Request

Path parameters

bot_idstring required

Response

Successful Response

escalation_idstring required
questionstring required

The exact decision asked for, with amounts, names and dates

category'spending' | 'commitment' | 'approval' | 'scheduling' | 'information' | 'other' required
contextstring

What led to the question and who asked, in one or two sentences

asked_bystring nullable

The participant who asked, when known

numberinteger nullable

1-based position among this bot's escalations

created_atnumber required

Unix timestamp of when the bot raised it

status'pending' | 'answered'
responsestring nullable

The owner's answer, once posted

decision'approved' | 'declined' | 'deferred' | 'info' nullable

How the owner decided, when it was a yes/no question

answered_atnumber nullable

Unix timestamp of the owner's answer

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      endpoint added