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

# Update a Collection Subscription

`PATCH /collection_subscriptions/{subscription_id}/`

Update the notification frequency for a specific collection provider subscription.
## Permissions
 - The authenticated user **must** be the owner of the subscription.
 - Only the `frequency` attribute can be modified.

## Request Body Provide the `frequency` inside the `attributes` object. Valid values include:
 - `instant`: Immediate email notifications.
 - `daily`: Daily digest emails.
 - `none`: Disable notifications for this event.

## Returns
 - A JSON:API compliant representation of the updated subscription resource.

## Path parameters

- `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 digest 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 update 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)