Skip to main content
PUT
SetDatasetNotificationAPI replaces the email recipients and optional durable

Authorizations

Authorization
string
header
required

An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).

Body

application/json
after
string

notification waits for, so the email can say what that declaration found out about the row. Without it the two run at the same instant off the same write and the message is composed before the answer exists.

dataset
string
exclusion
object
expected_version
string

being the one the caller read (DatasetNotification.Version). A caller that reads, edits and writes back the whole declaration sends it, so an edit made in between is never rolled back by the stale copy.

cannot know which app an organization works its leads in. A pointer so that omitting it keeps the saved links — a caller that does not know this field must not strip another caller's buttons — while [] clears them.

recipients
string[]

the declaration remains active when durable exclusion is configured.

reply_to_row_email
boolean

default route. It is valid only when the resolved row identity is email.

skip_when
string

get an alert email. The criterion is data, not policy: the platform judges each new row against whatever the caller wrote, with the MX lookup's answer supplied as evidence rather than acted on as a verdict.

timestamp_column
string

detected; set it when the dataset names that column unconventionally. It must hold timestamps: the notification starts from the newest value already in that column and compares later rows against it as text, so a column of free-text answers is refused rather than accepted into a notification that would email nobody.

Response

Success response

after
string
after_key_column
string
dataset
string
enabled
boolean
exclusion
object
job_id
string

run history through the automation surfaces.

key_column
string
key_fallback_columns
string[]
recipients
string[]
reply_to_row_email
boolean
skip_when
string
timestamp_column
string
version
string

Opaque: compare it, never parse it. Pass it back as expected_version to save only over the state that was read.