---
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.
    - `oauth` NotificationSMTPOAuthSettingsInput — SMTP OAuth credentials. Secret values are encrypted at rest and omitted from responses.
      - `provider` 'microsoft' | 'google_service_account' | 'google_refresh', required — SMTP OAuth token provider
      - `tenantId` string — Microsoft Entra tenant ID
      - `clientId` string — OAuth client ID
      - `clientSecret` string — OAuth client secret. Omit on updates to preserve the existing value when the OAuth identity is unchanged.
      - `refreshToken` string — Google refresh token. Omit on updates to preserve the existing value when the OAuth identity is unchanged.
      - `serviceAccountJson` string — Google service-account JSON. Omit on updates to preserve the existing value when the OAuth identity is unchanged.
    - `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
    - `oauth` NotificationSMTPOAuthSettings — Public SMTP OAuth settings. Secret values are never returned.
      - `provider` 'microsoft' | 'google_service_account' | 'google_refresh', required — SMTP OAuth token provider
      - `tenantId` string
      - `clientId` string
      - `clientSecretConfigured` boolean, required
      - `refreshTokenConfigured` boolean, required
      - `serviceAccountJsonConfigured` boolean, required
    - `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

---

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