Skip to main content
PUT
Create or update notification configuration

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

notification_type
enum<string>
required

A kind of notification a customer can configure.

A new kind is a new member here, not a new field or a new collection.

Available options:
api_key_expiry
org
string
required

Body

application/json
targets
(SlackActionTarget · object | WebhookActionTarget · object | EmailActionTarget · object)[]
required

Where notifications of this type go, replacing the recipients Kosli would otherwise derive. At least one target: delete the configuration instead to restore the derived recipients.

Minimum array length: 1

Response

Successful Response

notification_type
enum<string>
required

The kind of notification this configuration applies to

Available options:
api_key_expiry
scope
string | null
required

The entity the configuration applies to, or null for the whole org

targets
(SlackNotificationTargetResponse · object | WebhookNotificationTargetResponse · object | EmailNotificationTargetResponse · object)[]
required

Where notifications of this type go. Empty when the org has not configured any, in which case Kosli derives the recipients.

detection
Detection · object
required

What counts as a condition, for the types that have one

last_notified_at
number | null

When a notification of this type was last sent for the org, as epoch seconds, or null if none has been

last_failure
NotificationFailureResponse · object | null

The most recent failed delivery, when nothing has been sent since it; null otherwise

Last modified on October 1, 2026