Skip to main content
PATCH
UPDATE Custom Field

Authorizations

X-API-Key
string
header
required

Prophia API key — either an account key (grants admin level permissions) or a user key with the REST scope. Send it in the X-API-Key header, or equivalently as Authorization: Bearer <api-key>. JWTs are rejected on /rest endpoints with 401.

Path Parameters

accountId
string
required
fieldId
string
required

Body

application/json

Fields to change on a Building Custom Field. Every field is optional; omit one to leave it as it is. fieldType cannot be changed after creation, and options are managed through the options endpoints.

fieldName
string

New name of the field. Must be unique among the Account's Custom Fields, ignoring case, and cannot be No Value.

active
boolean

Whether the field is shown on Buildings.

Response

OK

An Account-level field your team tracks on Buildings beyond Prophia's standard set.

id
string
read-only

Prophia internal Custom Field ID (UUID).

accountId
string
read-only

The UUID for the Account this Custom Field belongs to.

fieldName
string

Name of the field.

fieldType
enum<string>
read-only

SINGLE fields hold free text per Building. MULTI fields hold one of a fixed list of options.

Available options:
SINGLE,
MULTI
active
boolean

Whether the field is shown on Buildings.

options
object[]
read-only

The field's current options.

createdBy
string
read-only

The user who created the field.

createdAt
string<date-time>
read-only

When the field was created.

updatedAt
string<date-time>
read-only

When the field was last modified.