Acknowledge Monitoring Alerts

​

Overview

​

Request

• Method: POST
• Path: /monitoring-alerts/acknowledge
• Body: JSON object specifying either a single alert ID or all alerts

​

Request Body

• alert_id (string, optional) - ID of the alert to acknowledge
• all (boolean, optional) - If true, acknowledges all alerts for the customer
• Exactly one of alert_id or all must be provided

​

Example Request (single alert)

{
  "alert_id": "532ebbd3-269d-4c8f-b73b-2269eb83f1ae"
}

​

Example Request (all alerts)

{
  "all": true
}

​

Success Response

• Status: 200 OK

​

Response Body (single alert)

{
  "success": true,
  "message": "Alert acknowledged",
  "unacknowledged_count": 5
}

​

Response Body (all alerts)

{
  "success": true,
  "message": "7 alerts acknowledged",
  "unacknowledged_count": 0
}

​

Error Handling

• 400 Bad Request
  • Invalid request body or both alert_id and all provided
  • Example: { "error": "Either alert_id OR all must be provided, but not both" }
• 404 Not Found
  • Alert with specified ID was not found
  • Example: { "error": "Alert not found" }
• 401 Unauthorized
  • Missing or invalid customer authentication
• 500 Internal Server Error
  • Unexpected server error

​

Notes

• Only the owner (customer) may acknowledge their alerts
• Bulk acknowledgment returns the number of alerts updated