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

# Delete a custom field

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

Permanently deletes a custom field and all its associated values across contacts. Returns 404 if the custom field is in a workspace outside the API key scope.

## Path parameters

- `id` string, required

## Response `204`

Custom field deleted successfully

## Other responses

- `401` — Invalid or missing API key
- `403` — Subscription required or plan not eligible
- `404` — Custom field not found or outside API key scope

---

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