patch https://{subdomain}.kommo.com/api/v4//custom_fields/
This method allows to update a singular custom field of an entity(leads/contacts/companies)
Limitations
The method is available for administrator users only.
Data type header when the request is successful
Content-Type: application/hal+json
Data type header in case of an error
Content-Type: application/problem+json
Response parameters
Method returns an updated field object.
| Parameter | Data type | Description | Is the field mandatory | Supported field types |
|---|---|---|---|---|
| id | int | Field ID | ❌ | Available for all field types |
| name | string | Field name | ❌ | Available for all field types |
| code | string | Field code that can be used to update the value of the field without passing the field ID in the request | ❌ | Available for all field types |
| sort | int | Field sorting in the field group | ❌ | Available for all field types |
| group_id | string | Field group ID | ❌ | Available for all lead, contact, company fields |
| is_api_only | bool | Defines whether the field is editable via API only | ❌ | Available for all lead, contact fields |
| required_statuses | array|null | Array of the fields required to change a lead status | ❌ | Available for all lead, contact, company fields |
| required_statuses[0] | object | Required field model | ❌ | Available for all lead, contact, company fields |
| required_statuses[0][status_id] | int | ID of the stage which requires the current field to have a value before the lead can be moved | ❌ | Available for all lead, contact, company fields |
| required_statuses[0][pipeline_id] | int | ID of the pipeline which requires the current field to have a value before the lead can be moved | ❌ | Available for all lead, contact, company fields |
| remind | string|null | Birthday reminders setting (never, day – day before the event, week – week before the event, month – month before the event) | ❌ | Available only for the birthday type fields |
| enums | array | Available field values array | ✅(only if you update a field of types: -multiselect -radiobutton -select | Available for the following field types: --multiselect -radiobutton -select |
| enums[0] | object | Available field value model | ✅(only if you update a field of types: -multiselect -radiobutton -select | Available for the following field types: -multiselect -radiobutton -select |
| enums[0][value] | string | Value | ✅(only if you update a field of types: -multiselect -radiobutton -select | Available for the following field types: -multiselect -radiobutton -select |
| enums[0][sort] | string | Value sorting | ✅(only if you update a field of types: -multiselect -radiobutton -select | Available for the following field types: -multiselect -radiobutton -select |
| nested | array | Nested values array | ❌ | Available for the following field types: category |
| nested[0] | object | Nested value model | ❌ | Available for the following field types: category |
| nested[0][id] | int | Nested value ID. Shouldn’t be passed when creating a new value | ❌ | Available for the following field types: category |
| nested[0][parent_id] | int | Nested value parent ID | ❌ | Available for the following field types: category |
| nested[0][value] | string | The value of the nested value | ❌ | Available for the following field types: category |
| nested[0][sort] | int | Nested value sorting | ❌ | Available for the following field types: category |
| nested[0][request_id] | string | Temporary identifier of a nested value. Identifier should be unique for the request, isn’t saved anywhere, and is used to create more than one nesting level within one request | ❌ | Available for the following field types: category |
| nested[0][parent_request_id] | string | Temporary identifier of a nested value parent. Identifier is used only at the time of the request, isn’t saved anywhere, and defines the nesting level of the added element if the parent element hasn’t been created yet | ❌ | Available for the following field types: category |