Change a notification target's severity and event filters, or a Slack target's channel.

PUT

/service/{service_id}/notification_target/{target_id}

curl --request PUT \
  --url https://api.siteqwality.com/service/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/notification_target/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "min_severity": "minor", "events": [ "example" ], "channel": "example" }'

• Production

Authorizations

• bearer_auth

Parameters

Path Parameters

service_id

required

string format: uuid

Service identifier

target_id

required

string format: uuid

Notification target identifier

Request Body ^required

Media type application/json

Change a target’s filters, or a Slack target’s channel. Omitted fields keep their value.

object

min_severity

One of:

string

null sends every severity again.

string

Allowed values: minor major critical

null

null

events

null takes every event again.

array | null

channel

A Slack target’s new channel.

string | null

Responses

200

Notification target updated

Media type application/json

object

id

required

string format: uuid

service_id

required

string format: uuid

type

required

string

Allowed values: slack_channel webhook email

details

required

Stored details with a webhook URL cut to its host; a Slack token reads back as has_token: true.

created_at

required

string format: date-time

integration_id

The connected integration this target sends with, when it uses one.

string | null format: uuid

min_severity

One of:

string

Lifecycle events of incidents below this severity are not sent; absent sends every severity.

string

Allowed values: minor major critical

null

null

events

The lifecycle events this target takes; absent takes every one.

array | null

signing_secret

A pasted-URL webhook’s signing secret, returned once on create and never again.

string | null

Example

{
  "type": "slack_channel",
  "min_severity": "minor"
}

400

An unknown event, an empty event list, or a channel on a target that has none

401

Missing or invalid authentication

404

Service or target not found

500

Internal server error