ContentVersion

An entity representing a version of a document.

Example:
Example JSON

JSON including important fields and an ContentVersion's resources. See the tables below for a list of all fields and resources.

{
    "type": "contentVersion",
    "status": "archived",
    "author": {
        "name": {
            "formatted": "Administrator"
        },
        "type": "person",
        "displayName": "Administrator",
        "id": "1"
    },
    "content": {
        // a document representing the content of this version
    },
    "versionNumber": 1,
    "published": "2012-07-11T23:49:37.929+0000",
    "id": "1180",
    "resources": {
        "self": {
            "ref": "https://example.jiveon.com/api/core/v3/versions/1242/1",
            "allowed": [ "POST", "GET" ]
        }
    }
 }

Fields

FieldTypeMode Description
authorPersonread-only

Author of this document version.

binaryURLStringread-only

URL to retrieve the binary content of this file (not available for documents).

Since: 3.5
contentContentread-only

Document corresponding to this version.

idStringread-only

Identifier (unique within an object type and Jive instance) of this object. This field is internal to Jive and should not be confused with contentID or placeID used in URIs.

minorVersionBooleanread-only

Flag indicating that this is a minor version.

publishedISO 8601 Dateread-only

Date and time at which this document version was originally created.

resourcesObjectread-only

Resource links (and related permissions for the requesting person) relevant to this object.

statusStringoptional

Published status of this content object.

typeStringread-only

The object type of this object ("documentVersion").

updatedISO 8601 Dateread-only

Date and time this document version was most recently updated.

versionNumberIntegerread-only

One-relative version number of this version.

→ Fields used by update and create operations
→ Fields used only by create operations
→ Fields not used by update or create operations

Resources

ResourceMethodDescription
restorePOST

Restore a content version by creating a copy of the version to restore as the newest content version and returning that content version.

Retrieves:
  • ContentVersion describing this content object
  • selfGET

    Return an updated version of this version of a content.

    Retrieves:
  • ContentVersion describing this content object