PUT /v1/config/notifications/settings

Sets the organization-wide default severity threshold. New channels created after this call use this value as their starting threshold (it remains overridable per channel).

For guidance on choosing a default, see Severity thresholds → Recommended starting point.

Authentication

API key with config:write permission.

Endpoint

PUT /v1/config/notifications/settings

Request body

{
  "defaultSeverityThreshold": "high"
}

Response

200 OK

{
  "success": true,
  "data": {
    "updated": true
  }
}

Error responses

Example

curl -X PUT https://api.sigsentry.com/v1/config/notifications/settings \
  -H "Authorization: Bearer ss_secret_..." \
  -H "Content-Type: application/json" \
  -d '{ "defaultSeverityThreshold": "high" }'

Scope

Changing the default does not retroactively change existing channels' thresholds. Each channel keeps the threshold it was created with until you update it via PUT /v1/config/notifications/{id}.