osapi.jive.corev3.contents.ContentVersion

An entity representing a version of a document.

Example:
Example JSON

JSON with the most important data for a ContentVersion. See the table below for a list of all fields.

{
    "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"
 }

Properties

PropertyTypeMode 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").

typeCodeIntegerread-only
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

Methods

get(options)
GET /versions/1234/1

Description

Return an updated version of this version of a content.

Options:
NameTypeRequiredDescription
fieldsStringfalseThe names of the fields to be returned
Retrieves:
  • ContentVersion describing this content object
  • restore(options)
    POST /versions/1234/1

    Description

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

    Options:
    NameTypeRequiredDescription
    fieldsStringfalseThe names of the fields to be returned
    Retrieves:
  • ContentVersion describing this content object
  • toURI()

    Retrieves

    String

    Description

    Retrieves:
  • A URI representing this entity, or undefined if no such URI exists.