Delete a subscriber
-------------------------------


Overview
...........

This API DELETE call deletes a subscriber. 

``DELETE https://<hostname>/api/api/relation/Subscriber/{Deletion Subscriber PKID}``

Where ``{Deletion Subscriber PKID}`` is the ID of the subscriber to delete.


.. rubric:: References:

* `OpenAPI example for relation/Subscriber/{Deletion Subscriber PKID} <ServiceNow-integration.html#/paths/~1api~1relation~1Subscriber~1%7BDeletion%20Subscriber%20PKID%7D/delete>`__
* `Model: relation/Subscriber <https://documentation.voss-solutions.com/release_RELEASENUM/html/src/api-ref/relation_Subscriber-Model.html>`__
* `API Reference for relation/Subscriber <https://documentation.voss-solutions.com/release_RELEASENUM/html/src/api-ref/relation_Subscriber-API.html>`__


Using relation/SubscriberPhone/{Removal_Phone_PKID}
....................................................

Using this API call involves the following tasks: 

1. Identify the customer and the customer's hierarchy.
2. Fetch all details of the subscriber to be deleted. 



Step 1: Identify Customer+Customer Hierarchy
'''''''''''''''''''''''''''''''''''''''''''''''

1. Fetch the list of customers to populate a drop-down list, and allow the user to select a 
   customer from the list. ``<Customer Name>``

   Refer to :ref:`tool-macro-customers-id` 

2. Fetch available hierarchies for the selected customer (``<Customer Name>``).

   Refer to :ref:`tool-macro-sites-belonging-to-the-customer-id`

3. Resolve ``<Customer Hierarchy>``.

   * ``<Customer Hierarchy>`` is the entry in the earlier step that ends with the ``<Customer Name>``. 

     For example, if ``<Customer Name>`` is Innovia, the ``<Customer Hierarchy>`` 
     will be ``sys.hcs.CS-P.CS-NB.Innovia``.



Step 2: Fetch all details of the subscriber to be deleted
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

1. Execute :ref:`tool-macro-subscriber-pkid-and-name-id` to fetch 
   the following details of all subscribers at the customer's hierarchy, and populate 
   the drop-down: 

   * UserID
   * FirstName
   * LastName

2. User selects the subscriber to be deleted. 

3. Resolve the subscriber PKID of the selected subscriber, to ``<Deletion Subscriber PKID>``

   .. note::

      There is no callback for DELETE. You will need to execute a 
      GET call containing data from the payload to confirm the status of the 
      call, for example:

      ``GET https://<hostname>/api/tool/Transaction/b471aa05-01d5-46c9-981e-685774b645be/``

      See the response sample output for this DELETE call 
      in the `OpenAPI example for relation/SubscriberPhone/{Removal_Phone_PKID} <ServiceNow-integration.html#/paths/~1api~1relation~1Subscriber~1%7BDeletion%20Subscriber%20PKID%7D/delete>`__