Notification Preferences

Update notification preferences

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

put/notification-preferences

Request body

emailEnabledboolean
ntfyEnabledboolean
ntfyServerUrlstring nullable
ntfyTopicstring nullable
ntfyTokenstring nullable
gotifyEnabledboolean
gotifyServerUrlstring nullable
gotifyTokenstring nullable
webhookEnabledboolean
webhookUrlstring nullable
webhookSecretstring nullable
taskAssignmentEnabledboolean
taskCommentEnabledboolean
taskStatusChangeEnabledboolean
dueDateReminderEnabledboolean
dueDateReminderLeadTimeMinutesinteger

Between 5 minutes and 30 days.

Response

The updated preferences

emailAddressstring nullable required
emailEnabledboolean required
ntfyEnabledboolean required
ntfyConfiguredboolean required
ntfyServerUrlstring nullable required
ntfyTopicstring nullable required
ntfyTokenConfiguredboolean required
maskedNtfyTokenstring nullable required
gotifyEnabledboolean required
gotifyConfiguredboolean required
gotifyServerUrlstring nullable required
gotifyTokenConfiguredboolean required
maskedGotifyTokenstring nullable required
webhookEnabledboolean required
webhookConfiguredboolean required
webhookUrlstring nullable required
webhookSecretConfiguredboolean required
maskedWebhookSecretstring nullable required
taskAssignmentEnabledboolean required
taskCommentEnabledboolean required
taskStatusChangeEnabledboolean required
dueDateReminderEnabledboolean required
dueDateReminderLeadTimeMinutesnumber required

How long before a due date the reminder fires, in minutes.

createdAtstring date-time nullable required
updatedAtstring date-time nullable required

Changes

Changed in 2 of the 23 revisions of this API.1113

  • 08bbb5bedb5d1112See the full diff
    • the request property gotifyServerUrl became not nullable

      request-property-became-not-nullable

    • the request property gotifyToken became not nullable

      request-property-became-not-nullable

    • the request property ntfyServerUrl became not nullable

      request-property-became-not-nullable

    • the request property ntfyToken became not nullable

      request-property-became-not-nullable

    • the request property ntfyTopic became not nullable

      request-property-became-not-nullable

    • the request property webhookSecret became not nullable

      request-property-became-not-nullable

    • the request property webhookUrl became not nullable

      request-property-became-not-nullable

    • removed the media type application/json for the response with the status 400

      response-media-type-removed

    • removed the media type application/json for the response with the status 401

      response-media-type-removed

    • the createdAt response's property type/format changed from / to string null/date-time for status 200

      response-property-type-changed

    • the updatedAt response's property type/format changed from / to string null/date-time for status 200

      response-property-type-changed

    • added the new optional request property dueDateReminderEnabled

      new-optional-request-property

    • added the new optional request property dueDateReminderLeadTimeMinutes

      new-optional-request-property

    • added the new optional request property taskAssignmentEnabled

      new-optional-request-property

    • added the new optional request property taskCommentEnabled

      new-optional-request-property

    • added the new optional request property taskStatusChangeEnabled

      new-optional-request-property

    • added the media type text/plain for the response with the status 400

      response-media-type-added

    • removed the non-success response with the status 403

      response-non-success-status-removed

    • added the required property dueDateReminderEnabled to the response with the 200 status

      response-required-property-added

    • added the required property dueDateReminderLeadTimeMinutes to the response with the 200 status

      response-required-property-added

    • added the required property taskAssignmentEnabled to the response with the 200 status

      response-required-property-added

    • added the required property taskCommentEnabled to the response with the 200 status

      response-required-property-added

    • added the required property taskStatusChangeEnabled to the response with the 200 status

      response-required-property-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • endpoint added

      endpoint-added