---
title: "Delete a custom field value"
method: DELETE
path: "/v3/spend/custom-fields/{customFieldId}/values"
tags: ["custom-fields"]
---

# Delete a custom field value

`DELETE /v3/spend/custom-fields/{customFieldId}/values`

Delete an existing custom field value.

A deleted value cannot be restored. The deleted value is not available in the list of custom field values. In addition, the deleted value cannot be assigned to current or future transactions. The deleted value will continue to be assigned to past transactions.

## Path parameters

- `customFieldId` string, required — BILL-generated ID or UUID of the custom field

## Headers

- `apiToken` string, nullable — Access token for Spend & Expense API authentication

## Request body

- DeleteCustomFieldValuesRequestDto — Delete custom field values request
  - `customFieldValueIds` string[], required — List of custom field value IDs or UUIDs

## Response `200`

Delete a custom field value response

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)