---
title: "Update an existing and specific subscription"
method: PUT
path: "/subscriptions/{subscriptionId}"
tags: ["Subscriptions"]
---

# Update an existing and specific subscription

`PUT /subscriptions/{subscriptionId}`

## Path parameters

- `subscriptionId` string, required

## Headers

- `x-anchore-account` string

## Request body

- SubscriptionUpdate — A modification to a subscription entry to change its status or value
  - `subscription_value` string, nullable — The new subscription value, e.g. the new tag to be subscribed to
  - `active` boolean — Toggle the subscription processing on or off

## Response `200`

Subscription add success

- Subscription[] — List of subscriptions
  - `subscription_key` string — The key value that the subscription references. E.g. a tag value or a repo name.
  - `subscription_type` string — The type of the subscription
  - `subscription_value` string, nullable — The value of the subscription target
  - `userId` string — The userId of the subscribed user
  - `active` boolean — Is the subscription currently active
  - `subscription_id` string — the unique id for this subscription record

---

[API](https://skmtc.net/anchore/apis/anchore-engine-api-server.md) · [All operations](https://skmtc.net/anchore/apis/anchore-engine-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anchore/anchore-engine-api-server/revisions/afb4f60ab44a/schema)