Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

CaseHistory

Represents historical information about changes that have been made to the associated Case.

Supported Calls

describeSObjects(), getDeleted(), getUpdated(), query(), retrieve()

You can also enable delete() in API version 42.0 and later. See Enable delete of Field History and Field History Archive.

Special Access Rules

This object is always read-only.

Fields

Field	Details
CaseId	Type reference Properties Filter, Group, Sort Description ID of the Case associated with this record. This is a relationship field. Relationship Name Case Relationship Type Lookup Refers To Case
DataType	Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Data type of the field that was changed.
Field	Type picklist Properties Filter, Group, Restricted picklist, Sort Description Name of the case field that was modified, or a special value to indicate some other modification to the case. The possible values, in addition to the case field names, are: ownerAssignment—The owner of the case was changed. ownerAccepted—A user took ownership of a case from a queue. ownerEscalated—The owner of the case was changed due to case escalation. external—A user made the case visible to customers in the Customer Self-Service Portal.
IsDeleted	Type boolean Properties Defaulted on create, Filter Description Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
NewValue	Type anyType Properties Nillable, Sort Description New value of the modified case field. Maximum of 255 characters.
OldValue	Type anyType Properties Nillable, Sort Description Previous value of the modified case field. Maximum of 255 characters.

Usage

Case history entries are indirectly created each time a case is modified.

Two rows are added to this record when foreign key fields change. One row contains the foreign key object names that display in the online application. For example, Jane Doe is recorded as the name of a Contact. The other row contains the actual foreign key ID that is only returned to and visible from the API.

This object respects field level security on the parent object.

Object Reference for the Salesforce Platform

CaseHistory

Supported Calls

Special Access Rules

Fields

Usage

See Also