---
title: "Deletes a custom field."
method: DELETE
path: "/dx/api/people/v1/customFields/{key}"
tags: ["People / Custom fields"]
---

# Deletes a custom field.

`DELETE /dx/api/people/v1/customFields/{key}`

Allows administrators to remove an existing custom field from the system by its unique key, effectively reducing the extensions made to the base user schema.

## Response `204`

Custom field deleted successfully.

## Other responses

- `401` — Unauthorized. The request is missing a valid session.
- `403` — Forbidden. The user does not have permission to delete the custom field.
- `404` — Custom field not found.

---

[API](https://skmtc.net/hcl-tech-software/apis/people-api-v1-server.md) · [All operations](https://skmtc.net/hcl-tech-software/apis/people-api-v1-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hcl-tech-software/people-api-v1-server/revisions/2267cfc94cf0/schema)