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

## Changes

- **2026-07-17** `38e5705e0b21` — 5 breaking, 5 info
  - removed the enum value `analysis_update` of the request property `subscription_type`
  - removed the enum value `policy_eval` of the request property `subscription_type`
  - removed the enum value `repo_update` of the request property `subscription_type`
  - removed the enum value `tag_update` of the request property `subscription_type`
  - …6 more
- **2019-10-02** `75f483ab10a0` — 1 breaking, 5 warning, 5 info
  - request property `subscription_type` was restricted to a list of enum values
  - added the new `analysis_update` enum value to the `items/subscription_type` response property for the response status `200`
  - added the new `policy_eval` enum value to the `items/subscription_type` response property for the response status `200`
  - added the new `repo_update` enum value to the `items/subscription_type` response property for the response status `200`
  - …7 more

[Change history](https://skmtc.dev/banzaicloud/apis/anchore-engine-api-server/changes/subscriptions/post.md)

---

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