> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Form

> Deletes a form permanently. Requires authentication.

## Overview

Permanently deletes a form and all associated data. This action cannot be undone.

## Path Parameters

| Parameter | Type   | Required | Description        | Example             |
| --------- | ------ | -------- | ------------------ | ------------------- |
| `form_id` | string | Yes      | Form ID (form\_id) | `Fecb6be7be43b4724` |

## Response

Returns a `204 No Content` status on successful deletion.

## Examples

### Delete Form

```bash theme={null}
curl -X DELETE "https://management.scanova.io/form/Fecb6be7be43b4724/" \
  -H "Authorization: YOUR_API_KEY"
```

## Important Considerations

### Before Deleting

* **Check Linked QR Codes**: Ensure no active QR codes are using this form
* **Backup Data**: Export any important submission data before deletion
* **Notify Team**: Inform team members about the deletion
* **Consider Deactivation**: Use the update endpoint to deactivate instead of delete

### What Gets Deleted

* Form configuration
* All collected form submissions
* Form settings and styling

### What Remains

* QR codes that were linked to this form (they will have no form attached)
* Historical analytics data (if any)

## Use Cases

* **Cleanup**: Remove unused or test forms
* **Data Privacy**: Delete forms containing sensitive information
* **Account Management**: Clean up old forms to stay within limits
* **Compliance**: Remove forms for GDPR or other compliance requirements

<Warning>
  **Permanent Action**: Deleting a form is irreversible. All submission data and configurations will be permanently lost. Consider deactivating the form instead if you might need it later.
</Warning>

<Note>
  If you need to preserve the submission data, consider exporting it first or simply deactivating the form using the update endpoint.
</Note>


## OpenAPI

````yaml DELETE /form/{form_id}/
openapi: 3.1.0
info:
  title: Scanova Form API
  description: Form management endpoints for creating, updating, and managing forms
  version: 1.0.0
servers:
  - url: https://management.scanova.io
    description: Production server
security:
  - apiKeyAuth: []
tags:
  - name: Form
    description: Form management operations
paths:
  /form/{form_id}/:
    delete:
      tags:
        - Form
      summary: Delete Form
      description: Deletes a form permanently. Requires authentication.
      parameters:
        - name: form_id
          in: path
          required: true
          description: Form ID (form_id)
          schema:
            type: string
          example: Fecb6be7be43b4724
      responses:
        '204':
          description: Form deleted successfully
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationErrorResponse'
        '404':
          description: Form not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - apiKeyAuth: []
components:
  schemas:
    AuthenticationErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: Authentication error message
          example: Invalid token.
    ErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: Error message
          example: Not found.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API key authentication. Enter your API key directly in the Authorization
        header.

````