On-Call API › Alerts
Resolve several alerts
POST/api/v1/alerts/resolve-bulk
Each alert in ids is resolved on its own, exactly as the single-alert
endpoint would. The answer lists which ids succeeded and which failed (for
example not found, or already resolved); one failure does not stop the rest.
A list with no ids in it comes back as [].
Permission (API-key scope): oncall:alert:respond.
Authorization
bearerAuth(oncall:alert:respond)apiKeyHeader(oncall:alert:respond)
Request body required
idsarray of string requiredAlert ids.
Responses
200
Which ids succeeded and which failed.
dataBulkResult requiredShow BulkResult properties
succeededarray of string | nullfailedarray of string | null
successboolean required
400
The body is not JSON (INVALID_BODY) or ids is empty (VALIDATION_FAILED).
errorobject requiredcodestring requiredmessagestring requireddetailsarray of object requiredfieldstringmessagestring
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
403
The key lacks the scope this endpoint needs (FORBIDDEN).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
429
Too many requests (RATE_LIMITED). Wait Retry-After seconds.
Retry-AfterintegerSeconds to wait.
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
Example request
curl -X POST 'https://evohub.io/api/v1/alerts/resolve-bulk' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"ids": [
"9d4e2f1a-6b3c-4d8e-a7f9-0c1b2a3d4e5f"
]
}'