How to...

Delete your Bibblio catalogue to remove all content items stored

Time to reset

Whether it's an article recommending staging content, or a Quick Start installation gone wrong, you might be required to delete your Bibblio catalogue and start afresh.

What is a Bibblio catalogue?

Bibblio stores a text version of your blog posts, articles, etc. called content items in order to make meaningful connections between them. These content items are kept in a catalogue that is unique to your account and only accessible to you. All the content items stored in a catalogue can potentially appear in each other recommendations.

Deleting a catalogue means that you will lose all of these meaningful connections, as well as any training data gathered so far for your users' interactions with the recommendations. Therefore it should be done sparingly, mostly during your initial installation if you've noticed something is wrong with the type of content displayed in the recommendations.

Step 1: Retrieve your Client ID and Client Secret

  1. Log in to your Bibblio account.

  2. Navigate to the Credentials tab to find your Client ID and Client Secret.
Retrieve Client ID and Client Secret

Step 2: Generate an Access Token

Use the Client ID and Client Secret to generate a temporary Access Token by calling our API endpoint https://api.bibblio.org/v1/token.

This can be done with an API platform such as Postman or by making sample calls in the console of Bibblio's interactive API documentation. This section takes you through the steps to delete a catalogue using the documentation.

⚠️ WordPress plugin: if you are using Bibblio's WordPress plugin, make sure it is deactivated in your WordPress admin's plugins list.

  1. To begin generating an Access Token, jump to the Obtain an access token console.

    (The link above is a shortcut of the following journey: In the API documentation menu click Authorization > Access Token, click Obtain an access token, then click Switch to Console.)

  2. In the console, click Body tab, replace the example's Client ID and Client Secret with your own and click on Call Resource

Obtain an access token-console

 The API returns a 200 response. Scroll to Response Body and click the Diff tab. The Access Token has been generated and is valid for 5 minutes, so copy the value of the access_token parameter and move on to Step 3.

Obtain an access token-response

Step 3: Retrieve your Catalogue ID

You can now retrieve the ID of the catalogue you want to delete by making a GET request to https://api.bibblio.org/v1/catalogues.

  1. In the API documentation menu click Storing Data > Catalogues, then scroll to and click List Catalogues.

  2. In the console, click the Headers tab. Paste the Access Token in the Authorization parameter's value, just after the word Bearer, leaving a single space between them.

  3. Click on Call Resource.

List catalogues console

Scroll to Response Body and click the Diff tab. This contains all of your catalogues. Choose the catalogue you wish to delete and copy the value of its catalogueId parameter.

List catalogues response

Step 4: Delete your catalogue

  1. Now that you know your Catalogue ID, in the API documentation menu click Storing Data > Catalogues then scroll to and click Delete a catalogue.

  2. In the console's URI Parameters tab, replace the Catalogue ID example in the catalogId parameter's value with your own Catalogue ID.

  3. Change the deleteAllContentItems parameter's value to true.

  4. Click the Headers tab and paste the Access Token into the Authorization parameter's value, just after the word Bearer, leaving a single space between them.

  5. Click Call Resource.

Delete-catalogue-console

The API returns a 200 response which means your catalogue has been deleted.

WP plugin users: you can now reactivate the plugin and go through the set-up again.

Quick Start code users: if Bibblio's JavaScript snippet is already deployed on your site, we will automatically re-import your content so no further action is needed.

Related guides

Need further assistance?

Visit the Help Center or get in touch with the Bibblio team.