ConnectCases / Client / delete_field
delete_field¶
- ConnectCases.Client.delete_field(**kwargs)¶
- 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 - BatchGetField.
- You cannot update a deleted field by calling - UpdateField; it throws a- ValidationException.
- Deleted fields are not included in the - ListFieldsresponse.
- Calling - CreateCasewith a deleted field throws a- ValidationExceptiondenoting which field identifiers in the request have been deleted.
- Calling - GetCasewith a deleted field identifier returns the deleted field’s value if one exists.
- Calling - UpdateCasewith a deleted field ID throws a- ValidationExceptionif the case does not already contain a value for the deleted field. Otherwise it succeeds, allowing you to update or remove (using- emptyValue: {}) the field’s value from the case.
- GetTemplatedoes not return field IDs for deleted fields.
- GetLayoutdoes not return field IDs for deleted fields.
- Calling - SearchCaseswith the deleted field ID as a filter returns any cases that have a value for the deleted field that matches the filter criteria.
- Calling - SearchCaseswith a- searchTermvalue that matches a deleted field’s value on a case returns the case in the response.
- Calling - BatchPutFieldOptionswith a deleted field ID throw a- ValidationException.
- Calling - GetCaseEventConfigurationdoes not return field IDs for deleted fields.
 - See also: AWS API Documentation - Request Syntax- response = client.delete_field( domainId='string', fieldId='string' ) - Parameters:
- domainId (string) – - [REQUIRED] - The unique identifier of the Cases domain. 
- fieldId (string) – - [REQUIRED] - Unique identifier of the field. 
 
- Return type:
- dict 
- Returns:
- Response Syntax- {}- Response Structure- (dict) – 
 
 - Exceptions- ConnectCases.Client.exceptions.InternalServerException
- ConnectCases.Client.exceptions.ResourceNotFoundException
- ConnectCases.Client.exceptions.ValidationException
- ConnectCases.Client.exceptions.ThrottlingException
- ConnectCases.Client.exceptions.AccessDeniedException
- ConnectCases.Client.exceptions.ConflictException
- ConnectCases.Client.exceptions.ServiceQuotaExceededException