---
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/en/knowledge-base/deleting-datasets-via-api#main-content)

English

Show submenu for translations

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

![Flow Software 300px-1](http://docs.timebase.flow-software.com/hs-fs/hubfs/Flow%20Software%20300px-1.png?width=120&height=43&name=Flow%20Software%20300px-1.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [More support](http://docs.timebase.flow-software.com/en/knowledge-base/kb-tickets/new)
- [Ask Flow Support](http://timebase.flow-software.com/en/knowledge-base/kb-tickets/new)

[Ask Flow Support](http://timebase.flow-software.com/en/knowledge-base/kb-tickets/new)

 Stay Curious & Keep Growing!

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

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

- [Software Releases](http://docs.timebase.flow-software.com/en/knowledge-base/software-releases?hsLang=en#main-content)
  
  
  
  
  
    - [Timebase](http://docs.timebase.flow-software.com/en/knowledge-base/software-releases?hsLang=en#timebase)
- [Timebase Quick Start](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-quick-start?hsLang=en#main-content)
  
  
  
  
  
    - [Start Here](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-quick-start?hsLang=en#start-here)
    - [System Requirements](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-quick-start?hsLang=en#system-requirements)
    - [Advanced Topics](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-quick-start?hsLang=en#advanced-topics)
- [Timebase Historian](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-historian?hsLang=en)
- [Timebase Data Collectors](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-data-collectors?hsLang=en)
- [Timebase Explorer](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-explorer?hsLang=en)
- [Timebase Pulse](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-pulse?hsLang=en)
- [Windows Services Starter](http://docs.timebase.flow-software.com/en/knowledge-base/windows-services-starter?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>`

### 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.

 

[![Flow Software 300px](http://docs.timebase.flow-software.com/hs-fs/hubfs/Flow%20Software%20300px.png?width=100&height=36&name=Flow%20Software%20300px.png "Flow Software 300px")](https://flow-software.com)

Copyright © 2025, Flow Software

```json
{
  "@context" : "https://schema.org",
  "@type" : "VideoObject",
  "contentUrl" : "https://4186316.fs1.hubspotusercontent-na1.net/hubfs/4186316/DeletingDatasetsviaAPI_FINAL.mp4",
  "dateModified" : "2025-09-09T10:11:00.262Z",
  "duration" : "PT2M40S",
  "height" : 1080,
  "name" : "DeletingDatasetsviaAPI_FINAL",
  "thumbnailUrl" : "https://4186316.fs1.hubspotusercontent-na1.net/hubfs/4186316/DeletingDatasetsviaAPI_FINAL.mp4/medium.jpg?t=1743905457207",
  "uploadDate" : "2025-04-06T02:10:43.587Z",
  "width" : 1920
}
```