projects

Set a project's dead-letter email setting — on/off and the throttle window (owner/admin)

An email to the organization's owners and admins when this project's dead-letter queue gains records — rows the engine accepted at ingest and then could not insert, which no query returns and no ingest response reported. ON by default. At most one email per project per window: the first new record sends immediately, anything parked inside the window arrives with it as one digest when the window ends. A count that goes DOWN (the engine restarted) re-baselines silently and notifies nobody.

put/v1/projects/{project_id}/dlq-notifications

Request

  • Base URL: https://api.wavehouse.cloud
  • URL: https://api.wavehouse.cloud/v1/projects/{project_id}/dlq-notifications
  • Auth: one of:
    • API key in cookie whc_session
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

project_idstring required

Request body

enabledboolean required

send the email when this project dead-letters records

window_secondsinteger required

at most one email per project per this many seconds; 0 on a write means the default (3600)

Response

OK

enabledboolean required

send the email when this project dead-letters records

last_sent_atstring date-time nullable required

when the last email went out; null if none has

next_send_atstring date-time nullable required

when a held digest may go out; null when the next record sends immediately

pending_recordsinteger required

newly dead-lettered records held for the next digest

window_secondsinteger required

at most one email per project per this many seconds; 0 on a write means the default (3600)

Changes

No recorded changes to this operation across all 1 revision of this API.