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

> Delete a folder, optionally moving QR codes to Uncategorized or permanently deleting them. Authentication required — include your API key in the Authorization header.

## Path Parameters

| Parameter | Type      | Required | Description |
| :-------- | :-------- | :------- | :---------- |
| `id`      | `integer` | Yes      | Folder ID.  |

## Query Parameters

| Parameter               | Type      | Required | Description                                                            |
| :---------------------- | :-------- | :------- | :--------------------------------------------------------------------- |
| `move_to_uncategorized` | `boolean` | Yes      | If `true`, moves QR codes to Uncategorized before deleting the folder. |
| `delete_permanently`    | `boolean` | Yes      | If `true`, permanently deletes QR codes in the folder (no trash).      |

## Behavior Matrix

| move\_to\_uncategorized | delete\_permanently | Result                                                  |
| :---------------------- | :------------------ | :------------------------------------------------------ |
| `false`                 | `true`              | Permanently delete QR codes and the folder.             |
| `true`                  | `false`             | Move QR codes to Uncategorized, then delete the folder. |
| `false`                 | `false`             | Delete the folder only.                                 |

## Example Request

`DELETE /folder/7/?move_to_uncategorized=true&delete_permanently=false`

## Example Response

### ✅ **204 No Content**

Folder deleted successfully.


## OpenAPI

````yaml DELETE /folder/{id}/
openapi: 3.1.0
info:
  title: Scanova Management API
  description: Management endpoints for tags, trash, and other administrative functions
  version: 1.0.0
servers:
  - url: https://management.scanova.io
    description: Production server
security:
  - apiKeyAuth: []
paths:
  /folder/{id}/:
    delete:
      tags:
        - Management
      summary: Delete Folder
      description: Deletes a folder with optional QR handling. Requires authentication.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
          description: Folder ID
        - name: move_to_uncategorized
          in: query
          required: true
          schema:
            type: boolean
          description: Move QR codes to Uncategorized before deleting the folder
        - name: delete_permanently
          in: query
          required: true
          schema:
            type: boolean
          description: Permanently delete QR codes in the folder
      responses:
        '204':
          description: Folder deleted successfully
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationErrorResponse'
        '404':
          description: Folder not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Not found.
      security:
        - apiKeyAuth: []
components:
  schemas:
    AuthenticationErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: Authentication error message
          example: Invalid token.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API key authentication. Enter your API key directly in the Authorization
        header.

````