CaseHistory

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

Supported Calls

query(), retrieve(), describeSObjects()

Special Access Rules

This object is always read-only in Salesforce.

Fields

Field	Field Type	Field Properties	Description
CaseId	reference	Filter	ID of the Case associated with this record. For information on IDs, see ID Field Type.
Field	picklist	Filter Restricted picklist	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	boolean	Defaulted on create Filter	Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
NewValue	anyType	Nillable	New value of the modified case field. Maximum of 255 characters.
OldValue	anyType	Nillable	Previous value of the modified case field. Maximum of 255 characters.

Usage

Case history entries are indirectly created by modifying a case via the Salesforce user interface or the API.

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.