---
title: "Update notification settings"
method: PUT
path: "/notification-settings"
tags: ["notifications"]
---

# Update notification settings

`PUT /notification-settings`

Updates workspace-level notification settings. SMTP passwords are accepted
in the request but are never returned. Omit password on updates to preserve
the existing password, or set clearPassword to remove it. Developer,
manager, or admin only.

## Query parameters

- `remoteNode` string

## Request body

- NotificationWorkspaceSettingsInput — Workspace-level notification settings input
  - `smtp` NotificationSMTPSettingsInput — Workspace SMTP transport input for notification email delivery. Values are encrypted at rest where applicable.
    - `host` string — SMTP server host
    - `port` string — SMTP server port
    - `username` string — SMTP username
    - `password` string — SMTP password. Omit on updates to preserve the existing password.
    - `clearPassword` boolean — Clear the stored SMTP password.
    - `from` string — Default sender address for notification email channels

## Response `200`

Workspace notification settings updated

- NotificationWorkspaceSettings — Workspace-level notification settings
  - `smtp` NotificationSMTPSettings — Public workspace SMTP transport settings. The SMTP password is never returned.
    - `host` string — SMTP server host
    - `port` string — SMTP server port
    - `username` string — SMTP username
    - `from` string — Default sender address for notification email channels
    - `passwordConfigured` boolean, required — Whether an SMTP password is configured
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `updatedBy` string — User ID that last updated the workspace notification settings

## Other responses

- `400` — Invalid notification settings
- `default` — Unexpected error

## Changes

- **2026-05-24** (v1) `8a2d5d3e9608` — 2 warning
  - added the new `rate_limited` enum value to the `code` response property for the response status `400`
  - added the new `rate_limited` enum value to the `code` response property for the response status `default`
- **2026-05-17** (v1) `0cce8472f3ba` — 1 info
  - endpoint added
- **2026-04-30** (v1) `50e1d517afc1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/dagucloud/apis/dagu/changes/notification-settings/put.md)

---

[API](https://skmtc.dev/dagucloud/apis/dagu.md) · [All operations](https://skmtc.dev/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dagucloud/dagu/revisions/8a2d5d3e9608/schema)