# Subscriber Subscription

Equivalent of Subscription endpoints but with scope limited to single
Subscriber record which `id` is provided in request path.


## Create a Subscription

 - [POST /hubs/{subdomain}/subscribers/{subscriber_id}/subscriptions](https://api-docs.statushub.com/api-v3-openapi/subscriber-subscription/createsubscribersubscription.md): Creates a new Subscription for existing Subscriber.
Besides regular validation - like address correctness - there are
a few additional constraints:
- Address has to be unique for current Hub,
- Single Subscriber can't have multiple subscriptions with same method name.
  For example it's not allowed for one Subscriber to have for example
  two email subscriptions.

## List Subscriptions

 - [GET /hubs/{subdomain}/subscribers/{subscriber_id}/subscriptions](https://api-docs.statushub.com/api-v3-openapi/subscriber-subscription/listsubscribersubscriptions.md): Filters and returns Subscriptions with basic info for existing Subscriber.

## Retrieve a Subscription

 - [GET /hubs/{subdomain}/subscribers/{subscriber_id}/subscriptions/{subscription_id}](https://api-docs.statushub.com/api-v3-openapi/subscriber-subscription/getsubscribersubscription.md): Returns data about single Subscription.

## Update a Subscription

 - [PUT /hubs/{subdomain}/subscribers/{subscriber_id}/subscriptions/{subscription_id}](https://api-docs.statushub.com/api-v3-openapi/subscriber-subscription/updatesubscribersubscription.md): Modifies existing Subscription. Only modified attributes may be passed in payload. All other attributes will remain unchanged.

## Delete a Subscription

 - [DELETE /hubs/{subdomain}/subscribers/{subscriber_id}/subscriptions/{subscription_id}](https://api-docs.statushub.com/api-v3-openapi/subscriber-subscription/deletesubscribersubscription.md): Deletes Subscription record. Records are soft-deleted which means that such deleted record can still be viewed and potentially restored. If deleted Subscription is the last active subscription for Subscriber, Subscriber record is also deleted.

## Restore a Subscription

 - [PUT /hubs/{subdomain}/subscribers/{subscriber_id}/subscriptions/{subscription_id}/restore](https://api-docs.statushub.com/api-v3-openapi/subscriber-subscription/restoresubscribersubscription.md): Restores deleted Subscription.
May fail if restoring would result in record
that is not valid, for example because subscription with that address
already exists.
Restoring depending on data may either:
- Recreate the record as a new one with new ID,
- Undelete the record preserving it ID.