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

# Update Notification Preferences

`PUT /notification-preferences`

Update global notification delivery preferences

## 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

## Response `200`

Updated notification preferences

- object
  - `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
  - `workspaces` object[], required
    - `id` string, required
    - `workspaceId` string, required
    - `workspaceName` string, required
    - `isActive` boolean, required
    - `emailEnabled` boolean, required
    - `ntfyEnabled` boolean, required
    - `gotifyEnabled` boolean, required
    - `webhookEnabled` boolean, required
    - `projectMode` 'all' | 'selected', required
    - `selectedProjectIds` string[], required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `createdAt` unknown, required
  - `updatedAt` unknown, required

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/usekaneo/apis/kaneo-api.md) · [All operations](https://skmtc.net/usekaneo/apis/kaneo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usekaneo/kaneo-api/versions/09053e1c8b21/schema)