Skip to main content
POST
/
v1
/
alerts
/
batch
Batch Update Alerts
curl --request POST \
  --url https://api.example.com/v1/alerts/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "alert_ids": [
    "<string>"
  ],
  "status": "<string>"
}
'
{
  "updated": 47,
  "livemode": true,
  "request_id": "req_xyz"
}

​
Overview

Batch acknowledges or dismisses up to 500 alerts at once. Use this when triaging a backlog or auto-resolving alerts after they have been processed downstream. Requires the portfolios:manage scope.

​
Request Body

​
alert_ids
string[]
required
Alert IDs to update (1-500 entries).
​
status
string
required
New status. One of acknowledged or dismissed. Applied to every alert in the batch.

​
Response

​
updated
integer
Number of alerts whose status was actually changed.
{
  "updated": 47,
  "livemode": true,
  "request_id": "req_xyz"
}

​
Code Examples

curl -X POST "https://api.signa.so/v1/alerts/batch" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "alert_ids": ["alt_abc123", "alt_def456", "alt_ghi789"],
    "status": "dismissed"
  }'

​
Errors

StatusTypeDescription
400validation_errorEmpty or oversized alert_ids, invalid status, or bad ID format
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks portfolios:manage