---
title: "Update a Notification Subscription"
method: PATCH
path: "/subscriptions/{subscription_id}/"
tags: ["Notification Subscriptions"]
---

# Update a Notification Subscription

`PATCH /subscriptions/{subscription_id}/`

Update the notification frequency for a specific subscription. Only the frequency attribute can be modified.
## Permissions
- The authenticated user must be the owner of the subscription.
## Request Body
Provide the `frequency` attribute within the `attributes` object to update the subscription. Available values for `frequency` are:
  - `instant`: Receive immediate email notifications.
  - `daily`: Receive a daily summary email.
  - `none`: Disable email notifications for this subscription.

## Returns
- A JSON object with the updated subscription details under the `data` key if the update is successful. - If unsuccessful, returns an `errors` object detailing the validation issues.

## Path parameters

- `subscription_id` string, required

## Request body

- object
  - `data` object
    - `type` 'subscription', required — Must be `subscription`.
    - `id` string, required — The unique identifier of the subscription.
    - `attributes` object, required
      - `frequency` 'instant' | 'daily' | 'none', required — The notification frequency for this subscription. - `instant`: Immediate email notifications. - `daily`: Daily summary emails. - `none`: No notifications.

## Response `200`

Subscription successfully updated.

## Other responses

- `400` — Bad Request. Invalid input provided.
- `401` — Unauthorized. Authentication is required.
- `403` — Forbidden. You do not have permission to modify this subscription.
- `404` — Not Found. No subscription matches the given ID.

---

[API](https://skmtc.net/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.net/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/revisions/ca701048eb0d/schema)