---
title: Deleting Datasets via the API
description: How to Delete Datasets via the API in the Historian Browser
---

[Skip to content](https://docs.timebase.flow-software.com/knowledge-base/deleting-datasets-via-api#main-content)

[More support](https://docs.timebase.flow-software.com/knowledge-base/kb-tickets/new?hsLang=en)

[![FlowEmailHeader](https://docs.timebase.flow-software.com/hs-fs/hubfs/FlowEmailHeader.png?width=120&height=33&name=FlowEmailHeader.png)](https://flow-software.com/)

Open main navigation

Close main navigation

- [More support](https://docs.timebase.flow-software.com/knowledge-base/kb-tickets/new)
- [Open a Support Ticket](https://docs.timebase.flow-software.com/knowledge-base/kb-tickets/new)

[Open a Support Ticket](https://docs.timebase.flow-software.com/knowledge-base/kb-tickets/new?hsLang=en)

 Search all Timebase documentation

- There are no suggestions because the search field is empty.

1. [Timebase Knowledge Base](https://docs.timebase.flow-software.com/knowledge-base?hsLang=en)
2. [Timebase Historian](https://docs.timebase.flow-software.com/knowledge-base/timebase-historian?hsLang=en)

# Deleting Datasets via the API

## How to use the API to delete a dataset from the Historian, including all related history.

**⚠️ Important**: The following steps will permanently delete the entire Dataset and all previously logged history. Only follow these steps if you are certain you wish to permanently delete a Dataset and all of the tags, values, and properties within the dataset. Learn how to backup your datasets [here](https://timebase.flow-software.com/en/knowledge-base/disaster-recovery).

### Navigate to your Historian and Collector

In a web browser, navigate to the Timebase Collector `<YourIPAdressHere:Port>` and **pause the Collector**. In another tag, navigate to the Timebase Historian `<YourIPAdressHere:Port>`

<iframe data-hsv-src="https://play.hubspotvideo.com/v/4186316/id/188435746447" referrerpolicy="origin" sandbox="allow-forms allow-scripts allow-same-origin allow-popups" allow="autoplay; fullscreen;" style="position: absolute !important; width: 100% !important; height: 100% !important; left: 0; top: 0; border: 0 none; pointer-events: initial" title="HubSpot Video" loading="lazy" data-hsv-id="188435746447" data-hsv-style="" data-hsv-width="688" data-hsv-height="387" data-hsv-autoplay="false" data-hsv-loop="false" data-hsv-muted="false" data-hsv-hidden-controls="false" data-hsv-full-width="false"></iframe>

### Use the API to Delete

You can use a language like Python or even a tool like Postman to call the API.

In the menu at the top left of the browser window, select the API page. Under the **Datasets** list of API calls, select the dropdown for **DELETE**. Click the **Try it out**button (the "Try it out" button label will change to cancel and a blue **EXECUTE** button will appear below the **dataset \*** text box). Under the label **Description** in the parameters section, you now have the ability to type in the text-field box. Once the dataset name is input into the Description field, click the **Execute** button below the dataset field. Revisit you historian  `<YourIPAdressHere:Port>`. The dataset is now removed from your Timebase Historian.

 

- [Software Releases](https://docs.timebase.flow-software.com/knowledge-base/software-releases?hsLang=en)
- [Timebase Quick Start](https://docs.timebase.flow-software.com/knowledge-base/timebase-quick-start?hsLang=en#main-content)

    - [Start Here!](https://docs.timebase.flow-software.com/knowledge-base/timebase-quick-start?hsLang=en#start-here)
    - [System Requirements](https://docs.timebase.flow-software.com/knowledge-base/timebase-quick-start?hsLang=en#system-requirements)
    - [Advanced Topics](https://docs.timebase.flow-software.com/knowledge-base/timebase-quick-start?hsLang=en#advanced-topics)
- [Timebase Historian](https://docs.timebase.flow-software.com/knowledge-base/timebase-historian?hsLang=en)
- [Timebase Data Collectors](https://docs.timebase.flow-software.com/knowledge-base/timebase-data-collectors?hsLang=en)
- [Timebase Explorer](https://docs.timebase.flow-software.com/knowledge-base/timebase-explorer?hsLang=en)
- [Timebase Pulse](https://docs.timebase.flow-software.com/knowledge-base/timebase-pulse?hsLang=en)
- [Windows Services Starter](https://docs.timebase.flow-software.com/knowledge-base/windows-services-starter?hsLang=en)

Copyright © 2025, Flow Software

```json
{
  "@context" : "https://schema.org",
  "@type" : "VideoObject",
  "contentUrl" : "https://stream.mux.com/oSEmbJ2TSuQC4BF1MW6Ah025KAaeiekO7l4n02hRPwEJg/capped-1080p.mp4",
  "dateModified" : "2025-04-06T02:10:57.207Z",
  "duration" : "PT2M40S",
  "height" : 1080,
  "name" : "DeletingDatasetsviaAPI_FINAL",
  "thumbnailUrl" : "https://4186316.fs1.hubspotusercontent-na1.net/hubfs/4186316/DeletingDatasetsviaAPI_FINAL.mp4/medium.jpg",
  "uploadDate" : "2025-04-06T02:10:43.587Z",
  "width" : 1920
}
```