Update a custom property definition
Update a custom property definition owned by your organization.
Path Parameters
- Type: stringFormat: uuidcustom
Property Definition Id required
Headers
- Type: stringIf
- Match min length:1requiredETag from a create or update response you already have, or from the latest GET when you have none.
Body
required
application/json
- Type: stringcta
Label max length:255nullable - Type: array of stringcustom
Actions Options min length:1max length:255nullable - Type: stringFormat: uuidnullablecustom
Field Category Id - Type: stringdefault
Value max length:500nullable - Type: stringdescriptionmax length:255nullable
- Type: stringenumfield
Type valuestextnumberdatecheckboxactionfilehyperlink - Type: booleanis
Required - Type: array of stringenumlinked
Equipment Categories values- solar
-panel - inverter
- battery
- battery
-expansion - roof
- hvac
- window
- door
- solar
- nullablelink
Url - Type: stringmax length:2048Format: uri
- Type: stringnamemin length:1max length:255
- Type: integerordermin:0max:9007199254740991nullable
Integer numbers.
- Type: stringFormat: uuidnullableproject
Stage Id
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
Request Example for patch/external/v2/custom-properties/{customPropertyDefinitionId}
curl https://sales-api.artemis.solar/external/v2/custom-properties/123e4567-e89b-12d3-a456-426614174000 \
--request PATCH \
--header 'If-Match: "copy-the-etag-from-your-latest-get"' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_SECRET_TOKEN' \
--data '{
"isRequired": true
}'
Custom property definition updated
{
"data": {
"id": "6c1f0c3e-2d8a-4b7e-9c11-8a4e1d2b7f90",
"name": "Roof Color",
"fieldType": "text",
"defaultValue": "Charcoal",
"description": "Exterior roof color selected by the homeowner",
"customFieldCategoryId": null,
"projectStageId": null,
"ctaLabel": null,
"linkUrl": null,
"order": 1,
"isRequired": false,
"customActionsOptions": null,
"linkedEquipmentCategories": [],
"createdAt": "2026-09-05T12:00:00.000Z",
"updatedAt": "2026-09-05T12:00:00.000Z"
}
}
