Skip to content

Latest commit

 

History

History
56 lines (42 loc) · 2.12 KB

delete-subscriptions.md

File metadata and controls

56 lines (42 loc) · 2.12 KB

Delete subscriptions

You can delete existing subscriptions that are no longer needed.

Prerequisites

  • Make sure that the authorization is working.
  • Make sure that the destination URL on your server is up and running.

Step 1: Retrieve the subscription UUID

  1. Retrieve all existing subscriptions.

    GET /organizations/{organizationUuid}/subscriptions
    

    Example:

    The following example retrieves all subscriptions for the organization with a3931584-82b2-4873-a32f-12b254d43539 as the UUID.

    GET /organizations/a3931584-82b2-4873-a32f-12b254d43539/subscriptions
    
  2. Copy and save the UUID of the subscription that you want to delete. It will be used for deleting the subscription.

Step 2: Delete a subscription

  1. Send a DELETE request to delete a subscription. In the request, subscriptionsUuid is the version 1 UUID that you retrieved in Step 1: Retrieve the subscription UUID.

    DELETE /organizations/{organizationUuid}/subscriptions/{subscriptionUuid}
    

    Example:

    The following example deletes the subscription ef64c5e2-4e16-11e8-9c2d-fa7ae01bbebc.

    DELETE /organizations/self/subscriptions/ef64c5e2-4e16-11e8-9c2d-fa7ae01bbebc
       
    
  2. Check that the response returns with an HTTP status code 200 OK.

    • If yes, the subscription is deleted successfully.
    • If no, update the DELETE request according to the error message. For more information on error messages, see HTTP status code.

Related task

Related API reference