On-Call API › Alerts
Resolve an alert by fingerprint
POST/api/v1/alerts/resolve-by-fingerprint
Resolves the open alert carrying this fingerprint. When no open alert has it, nothing happens and the answer is still 200.
Permission (API-key scope): oncall:alert:write.
Authorization
bearerAuth(oncall:alert:write)apiKeyHeader(oncall:alert:write)
Request body required
fingerprintstring required
Responses
200
Always {"resolved": true} once the request was read.
dataobject requiredresolvedboolean
successboolean required
400
The body is not JSON (INVALID_BODY) or fingerprint 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-by-fingerprint' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"fingerprint": "checkout-5xx-rate"
}'