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.

ContentVersionHistory

Represents the history of a specific version of a document. This object is available in version 17.0 and later.

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

Customer and Partner Portal users must have the “View Content in Portal” permission to query content in libraries where they have access.
A user can query all versions of a document from their personal library and any version that is part of or shared with a library where they are a member, regardless of library permissions.

To record an event in contentVersionViewed, make sure:

All files are published to a Content Library.
The details page is viewed in Salesforce Classic.

Note

Fields

Field	Details
ContentVersionId	Type reference Properties Filter, Group, Sort Description ID of the version. This is a relationship field. Relationship Name ContentVersion Relationship Type Lookup Refers To ContentVersion
DataType	Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Data type of the field that was changed.
Division	Type picklist Properties Defaulted on create, Filter, Group, Restricted picklist, Sort Description A logical segment of your organization's data. For example, if your company is organized into different business units, you could create a division for each business unit, such as “North America,” “Healthcare,” or “Consulting.” Available only if the organization has the Division permission enabled.
Field	Type picklist Properties Filter, Group, Restricted picklist, Sort Description The name of the field that was changed. Possible values include: `contentVersionCreated`—A new version is created. `contentVersionUpdated`—The title, description, or any custom field on the version is changed. `contentVersionDownloaded`—A version is downloaded. `contentVersionViewed`—The version details are viewed. `contentVersionRated`—The version is rated. `contentVersionCommented`—The version receives a comment. `contentVersionDataReplaced`—The new version replaces the previous version, which can happen only when the new version is uploaded immediately after the previous version.
NewValue	Type anyType Properties Nillable, Sort Description The new value of the field that was changed.
OldValue	Type anyType Properties Nillable, Sort Description The latest value of the field before it was changed.

Usage

Use this read-only object to query the history of a document version.

Object Reference for the Salesforce Platform

ContentVersionHistory

Supported Calls

Special Access Rules

Fields

Usage

See Also