Sign in

v1

latestOpenAPI 3.0.12026-08-06102329.4 KB
Fields

Update a custom field

Update a field by ID

put/v1/fields/{id}

Path parameters

idstring required

The Brex identifier of the field to update

Request body

namestring nullable

The name of the field

is_disabledboolean nullable

Indicates whether the field is disabled. A disabled field is not selectable: it is no longer offered as an option in the Brex dropdown and cannot be applied to new transactions. Records that already reference the field are unaffected.

Response

Update custom field response

brex_idstring required

The internal Brex ID of the field

namestring nullable required

The name of the field

remote_idstring nullable

Remote/external ID of custom field from external system (e.g. ERP or HRIS system)

updated_atstring date-time required

The last updated timestamp of the field

is_disabledboolean required

Indicates whether the field is disabled. A disabled field is not selectable: it is no longer offered as an option in the Brex dropdown and cannot be applied to new transactions. Records that already reference the field are unaffected.

group'ACCOUNTING' | 'USER' | 'ERP' | 'TRAVEL' nullable

The category of the field, indicating its purpose or context. For example, it could belong to accounting-related fields or user-related fields.

Example response

{
  "brex_id": "extended_field_foobar",
  "remote_id": "foo_bar"
}