Delete Field
| connectcases_delete_field | R Documentation |
Deletes a field from a cases template¶
Description¶
Deletes a field from a cases template. You can delete up to 100 fields per domain.
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 IDs in the request have been deleted. -
Calling
get_casewith a deleted field ID 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.