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

# /forms/{formId}

Soft delete a form (mark as deleted)

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Formstack API v2025.0",
    "version": "0.0.4"
  },
  "servers": [
    {
      "url": "https://www.formstack.com/api/v2025",
      "description": "Production server"
    },
    {
      "url": "https://staging-formstack.com/api/v2025",
      "description": "Staging server"
    },
    {
      "url": "https://dev-formstack.com/api/v2025",
      "description": "Development server"
    }
  ],
  "paths": {
    "/forms/{formId}": {
      "delete": {
        "tags": [
          "Forms",
          "Classic"
        ],
        "description": "Soft delete a form (mark as deleted)",
        "operationId": "deleteForm",
        "parameters": [
          {
            "name": "formId",
            "in": "path",
            "description": "The ID of the form",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful form deletion",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FormPreviewApiDto"
                }
              }
            }
          },
          "404": {
            "description": "Form not found"
          },
          "500": {
            "description": "Unable to delete form"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "FormPreviewApiDto": {
        "title": "Form Preview",
        "description": "Form preview response",
        "properties": {
          "id": {
            "description": "The ID of the form",
            "type": "integer",
            "nullable": false
          },
          "name": {
            "description": "Name of the form",
            "type": "string",
            "nullable": false
          },
          "viewKey": {
            "description": "View key of the form",
            "type": "string",
            "nullable": false
          },
          "url": {
            "description": "URL of the live form",
            "type": "string",
            "nullable": false
          },
          "submissionsCount": {
            "description": "Count of form submissions",
            "type": "integer",
            "nullable": false
          },
          "unreadSubmissionsCount": {
            "description": "Count of unread form submissions",
            "type": "integer",
            "nullable": false
          },
          "active": {
            "description": "Whether the form is active",
            "type": "boolean",
            "nullable": false
          },
          "created": {
            "description": "Date of form creation",
            "type": "string",
            "nullable": false
          },
          "updated": {
            "description": "Date of last update",
            "type": "string",
            "nullable": false
          },
          "folder": {
            "description": "ID of the folder where the form is located",
            "type": "integer",
            "nullable": true
          },
          "db": {
            "description": "Whether submissions are saved to the database",
            "type": "boolean",
            "nullable": false
          },
          "deleted": {
            "description": "Whether the form is deleted",
            "type": "boolean",
            "nullable": false
          },
          "numberOfColumns": {
            "description": "Number of visible columns in the form",
            "type": "string",
            "nullable": false
          },
          "progressMeter": {
            "description": "Whether progress meter is enabled",
            "type": "string",
            "nullable": false
          },
          "submissions": {
            "description": "Number of submissions",
            "type": "string",
            "nullable": false
          },
          "submissionsUnread": {
            "description": "Number of unread submissions",
            "type": "string",
            "nullable": false
          },
          "views": {
            "description": "Number of form views",
            "type": "string",
            "nullable": false
          },
          "version": {
            "description": "Form version",
            "type": "string",
            "nullable": false
          },
          "language": {
            "description": "Form language",
            "type": "string",
            "nullable": false
          },
          "encrypted": {
            "description": "Whether the form is encrypted",
            "type": "boolean",
            "nullable": false
          },
          "thumbnailUrl": {
            "description": "URL to form thumbnail",
            "type": "string",
            "nullable": true
          },
          "submitButtonTitle": {
            "description": "Title of the submit button",
            "type": "string",
            "nullable": false
          },
          "inactive": {
            "description": "Whether the form is inactive",
            "type": "boolean",
            "nullable": false
          },
          "timezone": {
            "description": "Form timezone",
            "type": "string",
            "nullable": false
          },
          "shouldDisplayOneQuestionAtATime": {
            "description": "Whether the form should display one question at a time",
            "type": "boolean",
            "nullable": false
          },
          "isWorkflowForm": {
            "description": "Whether the form is a workflow form",
            "type": "boolean",
            "nullable": false
          },
          "isWorkflowPublished": {
            "description": "Whether the workflow form is published",
            "type": "boolean",
            "nullable": false
          },
          "editUrl": {
            "description": "URL to edit form",
            "type": "string",
            "nullable": false
          },
          "dataUrl": {
            "description": "URL to form data",
            "type": "string",
            "nullable": false
          },
          "summaryUrl": {
            "description": "URL to form summary",
            "type": "string",
            "nullable": false
          }
        },
        "type": "object"
      }
    }
  },
  "tags": [
    {
      "name": "Forms",
      "description": "Forms are the core resource of the Formstack API. Use these endpoints to create, retrieve, update, copy, and delete forms, list the forms in an account with filtering and sorting, generate prefilled form URLs, and fetch the embed JavaScript or rendered HTML for a form. Most other resources—fields, submissions, emails, and submit actions—are scoped to a form."
    },
    {
      "name": "Classic",
      "description": "Classic"
    }
  ]
}
```