> 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

# deleteForm

# Package: @wix/forms

# Namespace: forms

# Method link: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/delete-form.md

## Permission Scopes:
Manage forms: SCOPE.FORMS.EDIT-FORM

## Introduction

Deletes a form schema.

The schema is moved to the trash bin where it's stored for 90 days before permanent deletion.
When permanently deleted, all associated form submissions are also deleted.

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.forms.forms.deleteForm(formId, options)
 Description: Deletes a form schema.  The schema is moved to the trash bin where it's stored for 90 days before permanent deletion. When permanently deleted, all associated form submissions are also deleted.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  formId
 Method parameters: 
   param name: formId | type: string | description: GUID of the form schema to delete. | required: true | validation: format GUID
   param name: options | type: DeleteFormOptions  none  
        - name: permanent | type: boolean | description: Whether to permanently delete the form schema, bypassing the trash bin.  Default: `false`  
 Return type: PROMISE<DeleteFormResponse>
  EMPTY-OBJECT {}


```

### Examples

### deleteForm
```javascript
import { forms } from '@wix/forms';

async function deleteForm(formId,options) {
  const response = await forms.deleteForm(formId,options);
};
```

### deleteForm (with elevated permissions)
```javascript
import { forms } from '@wix/forms';
import { auth } from '@wix/essentials';

async function myDeleteFormMethod(formId,options) {
  const elevatedDeleteForm = auth.elevate(forms.deleteForm);
  const response = await elevatedDeleteForm(formId,options);
}
```

### deleteForm (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 { forms } from '@wix/forms';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

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


async function deleteForm(formId,options) {
  const response = await myWixClient.forms.deleteForm(formId,options);
};
```

---