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 aValidationException.Deleted fields are not included in the
ListFieldsresponse.Calling
CreateCasewith a deleted field throws aValidationExceptiondenoting which field IDs in the request have been deleted.Calling
GetCasewith a deleted field ID returns the deleted field’s value if one exists.Calling
UpdateCasewith 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.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 asearchTermvalue that matches a deleted field’s value on a case returns the case in the response.Calling
BatchPutFieldOptionswith a deleted field ID throw aValidationException.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.InternalServerExceptionConnectCases.Client.exceptions.ResourceNotFoundExceptionConnectCases.Client.exceptions.ValidationExceptionConnectCases.Client.exceptions.ThrottlingExceptionConnectCases.Client.exceptions.AccessDeniedExceptionConnectCases.Client.exceptions.ConflictExceptionConnectCases.Client.exceptions.ServiceQuotaExceededException