---
title: "Add a subscription of a specific type"
method: POST
path: "/subscriptions"
tags: ["Subscriptions"]
---

# Add a subscription of a specific type

`POST /subscriptions`

Create a new subscription to watch a tag and get notifications of changes

## Headers

- `x-anchore-account` string

## Request body

- SubscriptionRequest — A subscription entry to add to the system
  - `subscription_key` string
  - `subscription_value` string, nullable
  - `subscription_type` string

## 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/banzaicloud/apis/anchore-engine-api-server.md) · [All operations](https://skmtc.net/banzaicloud/apis/anchore-engine-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banzaicloud/anchore-engine-api-server/revisions/38e5705e0b21/schema)