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

# Update a Collection Provider Notification Subscription

`PATCH /providers/collections/{provider_id}/subscriptions/{subscription_id}/`

Update the notification frequency for a specific subscription associated with a collection provider.
#### 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 Frequency Values:
 - `instant`: Immediate email notifications.
 - `daily`: Daily summary emails.
 - `none`: Disable email notifications.

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

- `provider_id` string, required
- `subscription_id` string, required

## Request body

- object
  - `data` object, required
    - `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 or missing required fields.
- `401` — Unauthorized. Authentication credentials are missing or invalid.
- `403` — Forbidden. You do not have permission to update this subscription.
- `404` — Not Found. No subscription matches the given ID or the collection provider does not exist.

---

[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)