Alert

/alert/{alert_id}

Modifies a specific alert, or a channel of alerts, or all alerts for a user

Note: alert_type_id can be created/found in the settings api call

Possible Methods

GET POST PUT DELETE

Arguments

alert_id(optional)
Alert id to modify

Parameters

channel_id (optional)
Channel id to filter results on, always trumps channel_id in payload
Note: If provided in a GET call, will update last_requested_time to NOW (returning the original object), this is used in the GUI to determine flags for showing alert changes

Json Object
{
        String alert_id;
    	String event_id;
    	String channel_id;
    	String alert_type_id;
    	Date last_alert_time;
    	long next_possible_alert_time_ms;
		Date last_requested_time;
}

 

Example
curl -b cookies.txt -X GET "http://localhost:8185/alert/532af74cb8e0870ad33d94cd" > response.txt
curl -b cookies.txt -X GET "http://localhost:8185/alert/532af74cb8e0870ad33d94cd?channel_id=531f3e50b8e0a93944925594" > response.txt
curl -b cookies.txt -X POST -d '{"event_id":"52e2e833e4b013563c3ea1ee", "alert_type_id":"532af8d8b8e0dd9b47dea7f8"}' "http://localhost:8185/alert" > response.txt
curl -b cookies.txt -X PUT -d '{"event_id":"52e2e833e4b013563c3ea1ee", "alert_type_id":"532af8d8b8e0dd9b47dea7f9"}' "http://localhost:8185/alert" > response.txt
curl -b cookies.txt -X DELETE "http://localhost:8185/alert/532af74cb8e0870ad33d94cd" > response.txt

 

Example Response
curl -b cookies.txt -X GET "http://localhost:8185/alert/532af911b8e0dd9b47dea7fa" > response.txt

 

 {
    "response": {
        "action": "Alert",
        "success": true,
        "message": "Return specific alert: 532af911b8e0dd9b47dea7fa",
        "time": 0
    },
    "data": {
        "alert_id": "532af911b8e0dd9b47dea7fa",
        "event_id": "52e2e833e4b013563c3ea1ee",
        "channel_id": "532851a1b8e0cd4ae4050b06",
        "alert_type_id": "532af8d8b8e0dd9b47dea7f8",
        "last_alert_time": "Mar 21, 2014 03:39:30 PM UTC",
        "next_possible_alert_time_ms": 1395502770715
    }
}