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

# Update custom field values

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

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

## Path parameters

- `field_id` string, required

## Request body

- UpdateFieldValueListBody — Represents the data needed to update multiple field values. It can't contain more than 1000 values at once.
  - `items` UpdateFieldValueBody[], required
    - union — Represents the data needed to update a field value.
      - object — Represents the data needed to update a field value using its `brex_id`.
        - `brex_id` string, required — The internal Brex ID of the field value
        - `data` object, required — Field value data to update
          - `value` string, nullable — The display name of the field value
          - `is_disabled` boolean, nullable — Indicates whether the field value is disabled. A disabled value is not selectable: it no longer appears as a selectable option in the dropdown and cannot be chosen on new transactions. Records that already use the value are unaffected.
      - object — Represents the data needed to update 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
        - `data` object, required — Field value data to update
          - `value` string, nullable — The display name of the field value
          - `is_disabled` boolean, nullable — Indicates whether the field value is disabled. A disabled value is not selectable: it no longer appears as a selectable option in the dropdown and cannot be chosen on new transactions. Records that already use the value are unaffected.
      - object — Represents the data needed to update 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)
        - `data` object, required — Field value data to update
          - `value` string, nullable — The display name of the field value
          - `is_disabled` boolean, nullable — Indicates whether the field value is disabled. A disabled value is not selectable: it no longer appears as a selectable option in the dropdown and cannot be chosen on new transactions. Records that already use the value are unaffected.

## Response `200`

Update custom field value list response

- UpdateFieldValueListResponse — Represents a list of updated field values
  - `items` FieldValue[], required — The list of updated field values
    - `brex_id` string, required — The internal Brex ID of the field value
    - `remote_id` string, nullable — Remote/external ID of custom field value from external system (e.g. ERP or HRIS system)
    - `value_id` string, nullable — The value ID or code of the field value; Usually it is a unique identifier for the custom field value in the remote system
    - `value` string, required — The display name of the field value
    - `field_id` string, required — The ID of the parent field this value belongs to
    - `updated_at` string, date-time, required — The last updated timestamp of the field value
    - `is_disabled` boolean, required — Indicates whether the field value is disabled. A disabled value is not selectable: it no longer appears as a selectable option in the dropdown and cannot be chosen on new transactions. Records that already use the value are unaffected.

## 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)