---
title: "Update notification preferences"
method: PUT
path: "/notification-preferences"
tags: ["Notification Preferences"]
---

# Update notification preferences

`PUT /notification-preferences`

Update the global delivery settings. Omitted fields are left unchanged; a secret sent as null is cleared.

## Request body

- object
  - `emailEnabled` boolean
  - `ntfyEnabled` boolean
  - `ntfyServerUrl` string, nullable
  - `ntfyTopic` string, nullable
  - `ntfyToken` string, nullable
  - `gotifyEnabled` boolean
  - `gotifyServerUrl` string, nullable
  - `gotifyToken` string, nullable
  - `webhookEnabled` boolean
  - `webhookUrl` string, nullable
  - `webhookSecret` string, nullable
  - `taskAssignmentEnabled` boolean
  - `taskCommentEnabled` boolean
  - `taskStatusChangeEnabled` boolean
  - `dueDateReminderEnabled` boolean
  - `dueDateReminderLeadTimeMinutes` integer — Between 5 minutes and 30 days.

## Response `200`

The updated preferences

- NotificationPreferences
  - `emailAddress` string, nullable, required
  - `emailEnabled` boolean, required
  - `ntfyEnabled` boolean, required
  - `ntfyConfigured` boolean, required
  - `ntfyServerUrl` string, nullable, required
  - `ntfyTopic` string, nullable, required
  - `ntfyTokenConfigured` boolean, required
  - `maskedNtfyToken` string, nullable, required
  - `gotifyEnabled` boolean, required
  - `gotifyConfigured` boolean, required
  - `gotifyServerUrl` string, nullable, required
  - `gotifyTokenConfigured` boolean, required
  - `maskedGotifyToken` string, nullable, required
  - `webhookEnabled` boolean, required
  - `webhookConfigured` boolean, required
  - `webhookUrl` string, nullable, required
  - `webhookSecretConfigured` boolean, required
  - `maskedWebhookSecret` string, nullable, required
  - `taskAssignmentEnabled` boolean, required
  - `taskCommentEnabled` boolean, required
  - `taskStatusChangeEnabled` boolean, required
  - `dueDateReminderEnabled` boolean, required
  - `dueDateReminderLeadTimeMinutes` number, required — How long before a due date the reminder fires, in minutes.
  - `workspaces` NotificationPreferenceWorkspaceRule[], required — Per-workspace overrides. A workspace with no rule follows the global settings.
    - `id` string, required
    - `workspaceId` string, required
    - `workspaceName` string, required
    - `isActive` boolean, required — Turn all notifications for this workspace on or off.
    - `emailEnabled` boolean, required
    - `ntfyEnabled` boolean, required
    - `gotifyEnabled` boolean, required
    - `webhookEnabled` boolean, required
    - `projectMode` 'all' | 'selected', required — `all` notifies for every project in the workspace; `selected` restricts it to selectedProjectIds.
    - `selectedProjectIds` string[], required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `createdAt` string, date-time, nullable, required
  - `updatedAt` string, date-time, nullable, required

## Other responses

- `400` — Invalid request
- `401` — Missing or invalid credentials

## Changes

- **2026-08-24** `08bbb5bedb5d` — 11 breaking, 12 info
  - the request property `gotifyServerUrl` became not nullable
  - the request property `gotifyToken` became not nullable
  - the request property `ntfyServerUrl` became not nullable
  - the request property `ntfyToken` became not nullable
  - …19 more
- **2026-07-11** `32cece1ebe43` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/notification-preferences/put.md)

---

[API](https://skmtc.dev/usekaneo/apis/kaneo-api.md) · [All operations](https://skmtc.dev/usekaneo/apis/kaneo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usekaneo/kaneo-api/revisions/9d1da42c10ce/schema)