> To build or manage a Wix site with an AI agent, follow https://www.wix.com/headless/skill.md
> It builds a new Wix site or puts your own site online, from a prompt, and keeps changing it afterwards. The pages are code in any web technology, and Wix runs the backend.
> It works through the Wix plugin (the Wix MCP and the Wix skills), the Wix CLI or no Wix login, and puts the site live on Wix hosting or on another host.
> Business features include a store, bookings, events and tickets, a restaurant, a blog, forms, members and many more.
> Read the Wix skills online at https://www.wix.com/skills
> 
> 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`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - 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?apiView=SDK.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 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 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/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 | validation: maxLength 256
 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.data.collections.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 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 | validation: maxLength 256
 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-managed)
Self-managed 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);
};
```

---