Home Get started API docs

Delete subscriptions

You can delete existing subscriptions that are no longer needed.

Prerequisites

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

Step 1: Retrieve the subscription UUID

Retrieve all existing subscriptions.

1
GET /organizations/{organizationUuid}/subscriptions

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

1
GET /organizations/a3931584-82b2-4873-a32f-12b254d43539/subscriptions

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

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.

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

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

1
DELETE /organizations/self/subscriptions/ef64c5e2-4e16-11e8-9c2d-fa7ae01bbebc

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.