---
title: "Delete custom field"
method: DELETE
path: "/custom-fields/{id}/"
tags: ["Custom Fields"]
---

# Delete custom field

`DELETE /custom-fields/{id}/`

Endpoint for deleting an existing custom field. The custom field must not be in use on any documents.

## Path parameters

- `id` string, required

## Headers

- `X-Wafeq-Idempotency-Key` string

## Response `204`

No response body

## Other responses

- `400` — Validation error (e.g., invalid config, field type change while in use, or choice removal while in use).
- `403` — Permission denied or addon limit reached.

---

[API](https://skmtc.net/wafeq/apis/wafeq-public-api.md) · [All operations](https://skmtc.net/wafeq/apis/wafeq-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wafeq/wafeq-public-api/revisions/36816b4fce7f/schema)