Skip to main content
PUT
/
v1
/
notifications
/
types
/
{event_type}
/
config
Enable/disable a type and set its severity override / threshold config
curl --request PUT \
  --url https://api-sandbox.featherhq.com/v1/notifications/types/{event_type}/config \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "enabled": true,
  "severity_override": "<string>",
  "threshold_config": {},
  "delivery_mode": "immediate",
  "rate_limit_per_hour": 2
}
'
{
  "event_type": "<string>",
  "category": "<string>",
  "display_name": "<string>",
  "description": "<string>",
  "default_severity": "<string>",
  "supported_channels": [
    "<string>"
  ],
  "recommended": true,
  "template_id": "<string>",
  "threshold_based": true,
  "threshold_config_schema": {},
  "payload_schema": {},
  "enabled": true,
  "severity_override": "<string>",
  "threshold_config": {},
  "effective_severity": "<string>",
  "delivery_mode": "<string>",
  "rate_limit_per_hour": 123,
  "resolved_destination_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "has_destination": true
}

Authorizations

x-api-key
string
header
required

Path Parameters

event_type
string
required

Body

application/json

Upsert the per-org config for one notification type.

event_type is a path param. severity_override is validated server-side against NotificationSeverity; threshold_config against the type's schema.

enabled
boolean
required
severity_override
string | null
threshold_config
Threshold Config · object
delivery_mode
string
default:immediate
rate_limit_per_hour
integer | null
Required range: x >= 1

Response

Successful Response

A catalog type merged with this org's config and resolved destinations.

Built by NotificationCatalogService (not from a single ORM row), so it surfaces both the static catalog metadata and the org's live state. The payload_schema / threshold_config_schema are JSON Schema (the variables/validation manifest the frontend hints from).

event_type
string
required
category
string
required
display_name
string
required
description
string
required
default_severity
string
required
supported_channels
string[]
required
template_id
string | null
required
threshold_based
boolean
required
threshold_config_schema
Threshold Config Schema · object
required
payload_schema
Payload Schema · object
required
enabled
boolean
required
severity_override
string | null
required
threshold_config
Threshold Config · object
required
effective_severity
string
required
delivery_mode
string
required
rate_limit_per_hour
integer | null
required
resolved_destination_ids
string<uuid>[]
required
has_destination
boolean
required