> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# DeleteDataCollection

# Package: collectionManagement

# Namespace: DataCollectionService

# Method link: https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/data-collections/delete-data-collection.md

## Permission Scopes:
Manage Data Collections: SCOPE.DC-DATA.DATA-COLLECTIONS-MANAGE

## Introduction

Deletes a data collection.

Before deleting a collection:
- Make sure the collection isn't connected to any site pages or elements.
- You can create a manual backup of a collections with the Backups API, in case you need to restore them later.
- You can also export a collection to a CSV file with the Data Movement Jobs API, if you want to save the data outside of Wix.

> **Note:**
> Once a collection is deleted, it can only be restored for a limited amount of time.

---

## REST API

### Schema

```
 Method: deleteDataCollection
 Description: Deletes a data collection.  Before deleting a collection: - Make sure the collection isn't connected to any site pages or elements. - You can create a manual backup of a collections with the Backups API, in case you need to restore them later. - You can also export a collection to a CSV file with the Data Movement Jobs API, if you want to save the data outside of Wix.  > **Note:** > Once a collection is deleted, it can only be restored for a limited amount of time.
 URL: https://www.wixapis.com/wix-data/v2/collections/{dataCollectionId=**}
 Method: DELETE
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  dataCollectionId
 Method parameters: 
   query param name: dataCollectionId | type: dataCollectionId | description: GUID of the collection to delete. | required: true
 Return type: DeleteDataCollectionResponse
  EMPTY-OBJECT {}


```

### Examples

### Delete a collection
```curl
curl -X DELETE \
'https://www.wixapis.com/wix-data/v2/collections/my-first-collection' \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.collectionManagement.DataCollectionService.deleteDataCollection(dataCollectionId)
 Description: Deletes a data collection.  Before deleting a collection: - Make sure the collection isn't connected to any site pages or elements. - You can create a manual backup of a collections with the Backups API, in case you need to restore them later. - You can also export a collection to a CSV file with the Data Movement Jobs API, if you want to save the data outside of Wix.  > **Note:** > Once a collection is deleted, it can only be restored for a limited amount of time.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  dataCollectionId
 Method parameters: 
   param name: dataCollectionId | type: string | description: GUID of the collection to delete. | required: true
 Return type: PROMISE<DeleteDataCollectionResponse>
  EMPTY-OBJECT {}


```

### Examples

### deleteDataCollection
```javascript
import { collections } from '@wix/data';

async function deleteDataCollection(dataCollectionId) {
  const response = await collections.deleteDataCollection(dataCollectionId);
};
```

### deleteDataCollection (with elevated permissions)
```javascript
import { collections } from '@wix/data';
import { auth } from '@wix/essentials';

async function myDeleteDataCollectionMethod(dataCollectionId) {
  const elevatedDeleteDataCollection = auth.elevate(collections.deleteDataCollection);
  const response = await elevatedDeleteDataCollection(dataCollectionId);
}
```

### deleteDataCollection (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { collections } from '@wix/data';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { collections },
  // Include the auth strategy and host as relevant
});


async function deleteDataCollection(dataCollectionId) {
  const response = await myWixClient.collections.deleteDataCollection(dataCollectionId);
};
```

---