---
title: "Delete custom field values"
method: DELETE
path: "/v1/fields/{field_id}/values"
tags: ["Field Values"]
---

# Delete custom field values

`DELETE /v1/fields/{field_id}/values`

Delete custom field values (up to 1000 values at once) for a specific field

## Path parameters

- `field_id` string, required

## Request body

- DeleteFieldValueListBody — Represents the data needed to delete field values. It can't contain more than 1000 values at once.
  - `items` DeleteFieldValueBody[], required
    - union — Represents the data needed to delete a field value.
      - object — Represents the data needed to delete a field value using its `brex_id`.
        - `brex_id` string, required — The internal Brex ID of the field value
      - object — Represents the data needed to delete a field value using its `value_id`.
        - `value_id` string, required — The value ID or code of the field value; Usually it is a unique identifier for the custom field value in the remote system
      - object — Represents the data needed to delete a field value using its `remote_id`.
        - `remote_id` string, required — Remote/external ID of custom field value from external system (e.g. ERP or HRIS system)

## Response `200`

Delete custom field value list response

- DeletedFieldValueListResponse — Represents the confirmation of number of deleted field values

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.dev/brex-com/apis/fields-api.md) · [All operations](https://skmtc.dev/brex-com/apis/fields-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brex-com/fields-api/revisions/b1ba15754f28/schema)