Skip to main content
PATCH
/
v1
/
alerts
/
{id}
Update Alert
curl --request PATCH \
  --url https://api.example.com/v1/alerts/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "<string>"
}
'

​
Overview

Updates an alert’s status. Use this to acknowledge an alert (you have triaged it) or dismiss it (it requires no action). Requires the portfolios:manage scope.

​
Path Parameters

​
id
string
required
Alert ID (alt_...).

​
Request Body

​
status
string
required
New status. One of acknowledged or dismissed.

​
Response

Returns the updated alert. Same shape as Get Alert.

​
Code Examples

curl -X PATCH "https://api.signa.so/v1/alerts/alt_abc123" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{ "status": "acknowledged" }'

​
Errors

StatusTypeDescription
400validation_errorInvalid status value
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks portfolios:manage
404not_foundAlert does not exist or belongs to another org