---
title: "Delete a form"
method: DELETE
path: "/forms/{form_id}"
---

# Delete a form

`DELETE /forms/{form_id}`

## Request

- Base URL: `https://app.formasty.com/api/v1`
- URL: `https://app.formasty.com/api/v1/forms/{form_id}`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://app.formasty.com/oauth/authorize/api/v1`, token URL `https://app.formasty.com/oauth/token`)
  - HTTP bearer

Deletes a form the authenticated credential owner can manage.

## Path parameters

- `form_id` string, required

## Response `200`

Deletion result.

- DeleteResponse
  - `ok` true, required
  - `id` string, required

## Other responses

- `default`: A machine-readable error with a stable code and a recovery hint. The legacy error value is retained for existing clients.

---

[API](https://skmtc.dev/formasty/apis/formasty-forms-api.md) · [All operations](https://skmtc.dev/formasty/apis/formasty-forms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/formasty/apis/formasty-forms-api/revisions/09ad7f50c693?raw)