Sign in

v1

latestOpenAPI 3.1.02026-08-065163115.0 KB
Custom Fields

Update a custom field

Partially updates a custom field.

Restrictions for accounting integration fields (created by Xero, MYOB, QuickBooks, NetSuite, or Business Central): the name field cannot be changed. Only budget_setting can be updated.

patch/v1/businesses/{client_id}/custom-fields/{custom_field_id}

Path parameters

client_idinteger required
Example:123

The ID of the business.

custom_field_idstring uuid required
Example:3fa85f64-5717-4562-b3fc-2c963f66afa6

The ID of the custom field.

Request body

namestring

The new display name. Not permitted for fields created by accounting integrations. Cannot set to a name already in use by another custom field in the business.

field_type'LIST' | 'FREE_TEXT'

The type of the custom field. Not permitted for fields created by accounting integrations.

is_manager_onlyboolean

Cannot be changed after creation — always returns 400 if a different value is sent.

budget_setting'NONE' | 'SOME' | 'ALL_CURRENT_AND_NEW'

Controls which budgets this custom field is assigned to.

Example request

{
  "name": "Cost Centre",
  "field_type": "LIST",
  "budget_setting": "SOME"
}

Response

OK

idstring uuid

The unique identifier for this custom field.

namestring

The display name of the custom field.

field_type'LIST' | 'FREE_TEXT'

The type of the custom field.

budget_setting'NONE' | 'SOME' | 'ALL_CURRENT_AND_NEW'

Controls which budgets this custom field is assigned to.

is_manager_onlyboolean

Whether this custom field is visible only to managers. Cannot be changed after creation.

created_by'MANUAL' | 'PUBLIC_API' | 'XERO' | 'MYOB' | 'QUICKBOOKS' | 'NETSUITE' | 'BUSINESS_CENTRAL'

The source that created this custom field.

createdstring date-time

The date and time when this custom field was created.

updatedstring date-time

The date and time when this custom field was last updated.

Example response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Project Code",
  "field_type": "LIST",
  "budget_setting": "NONE",
  "created_by": "PUBLIC_API",
  "created": "2024-01-15T09:00:00Z",
  "updated": "2024-01-15T09:00:00Z"
}