Deletes a field from a cases template¶
Description¶
Deletes a field from a cases template.
After a field is deleted:
- You can still retrieve the field by calling
batch_get_field. - You cannot update a deleted field by calling
update_field; it throws aValidationException. - Deleted fields are not included in the
list_fieldsresponse. - Calling
create_casewith a deleted field throws aValidationExceptiondenoting which field identifiers in the request have been deleted. - Calling
get_casewith a deleted field identifier returns the deleted field's value if one exists. - Calling
update_casewith a deleted field ID throws aValidationExceptionif the case does not already contain a value for the deleted field. Otherwise it succeeds, allowing you to update or remove (usingemptyValue: {}) the field's value from the case. get_templatedoes not return field IDs for deleted fields.get_layoutdoes not return field IDs for deleted fields.- Calling
search_caseswith the deleted field ID as a filter returns any cases that have a value for the deleted field that matches the filter criteria. - Calling
search_caseswith asearchTermvalue that matches a deleted field's value on a case returns the case in the response. - Calling
batch_put_field_optionswith a deleted field ID throw aValidationException. - Calling
get_case_event_configurationdoes not return field IDs for deleted fields.
Usage¶
Arguments¶
-
domainId[required] The unique identifier of the Cases domain.
-
fieldId[required] Unique identifier of the field.
Value¶
An empty list.