Skip to main content
PUT
Change your notification settings

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

A change to the caller's settings. Fields left out stay as they are.

email_enabled
boolean | null
email_cadence
enum<string> | null
Available options:
immediate,
hourly,
daily
digest_hour
integer | null
Required range: 0 <= x <= 23
timezone
string | null
Maximum string length: 64
quiet_start
string | null
Pattern: ^([01]\d|2[0-3]):[0-5]\d$
quiet_end
string | null
Pattern: ^([01]\d|2[0-3]):[0-5]\d$
clear_quiet_hours
boolean
default:false

Turn quiet hours off.

topics
Topics · object | null

Per topic, per channel. Unknown topics are refused.

Response

Successful Response

The caller's notification settings.

email
EmailSettings · object
required

The caller's email delivery.

timezone
string
required

IANA time zone for digests and quiet hours.

channels
Channels · object
required

What each channel looks like for the caller.

topics
TopicPreference · object[]
required

The settings grid.

quiet_start
string | null

HH:MM, local.

quiet_end
string | null

HH:MM, local.