Assets Server REST API - Versioning and history

http://yourserver.com/services/asset/history
    ?id=<assetId>
    &start=<first result>
    &num=<max result hits to return>
    &detailLevel=<level of detail to return>
    &actions=<comma-delimited actions>

What does it do?

Return history details of an asset.

The REST retrieve history method gives insight into what happened to the asset while stored in Assets Server. Ranging from versions created to metadata changes and move actions.

Parameters

Available actions

Common actions in Assets Server:

Asset file actions:

• CREATE
• COPY
• MOVE
• RENAME
• REMOVE

Metadata actions:

• METADATA_UPDATE

Checkout actions:

• CHECKIN
• CHECKOUT
• UNDO_CHECKOUT

Version actions:

• CREATE_VARIATION
• COPY_VERSION
• REMOVE_VERSION

Download actions:

• DOWNLOAD
• PREVIEW
• RENDITION

Detail levels

Examples

Asset history

http://localhost:8080/services/asset/history
    ?id=9wmc_7LYq2NAmsYU6Lch_t
    &detailLevel=0
    &actions=CHECKIN

{
  "totalHits": 1,
  "hits": [
    {
      "usageStatsRecord": {
        "id": null,
        "logDate": 1476111682169,
        "userName": "admin",
        "userGroups": [],
        "clientType": "air",
        "remoteAddr": "0:0:0:0:0:0:0:1",
        "remoteHost": "0:0:0:0:0:0:0:1",
        "action": "CHECKIN",
        "assetId": "9wmc_7LYq2NAmsYU6Lch_t",
        "assetPath": "/Demo Zone/Images/Nature/Wildlife/Parrots.jpg",
        "assetType": "jpg",
        "assetDomain": "image",
        "sourceAssetPath": null,
        "sourceAssetId": null,
        "changedMetadata": {
          "checkedOut": {
            "oldValue": 1476111651000,
            "newValue": null
          },
          "software": {
            "oldValue": "Adobe Photoshop CS2 Windows",
            "newValue": "Adobe Photoshop CS5.1 Macintosh"
          },
          "artist": {
            "oldValue": null,
            "newValue": "Fernando Weberich"
          },
          "description": {
            "oldValue": "Two curious parrots (or arara ararauna) overlooking a human crowd in Brazil",
            "newValue": null
          },
          "assetModified": {
            "oldValue": 1476111666427,
            "newValue": 1476111682098
          },
          "xmpCreated": {
            "oldValue": 1161408099000,
            "newValue": 1161400899000
          },
          "xmpModifyDate": {
            "oldValue": 1332506480000,
            "newValue": 1476111678000
          },
          "modified": {
            "oldValue": 1332510080000,
            "newValue": 1476118878000
          },
          "assetFileModifier": {
            "oldValue": null,
            "newValue": "admin"
          },
          "fileModified": {
            "oldValue": 1476111631000,
            "newValue": 1476111681000
          },
          "sourceVersion": {
            "oldValue": null,
            "newValue": 1
          },
          "checkedOutBy": {
            "oldValue": "admin",
            "newValue": null
          },
          "xmpMetadataDate": {
            "oldValue": 1332506480000,
            "newValue": 1476111678000
          },
          "versionNumber": {
            "oldValue": 1,
            "newValue": 2
          },
          "assetFileModified": {
            "oldValue": null,
            "newValue": 1476111682098
          },
          "checkedOutOnClient": {
            "oldValue": "2c3f624f-caba-3f7c-8315-571043e6544c",
            "newValue": null
          },
          "fileSize": {
            "oldValue": 750534,
            "newValue": 733088
          },
          "fileCreated": {
            "oldValue": 1476111630000,
            "newValue": 1476111681000
          }
        },
        "details": null
      },
      "hit": {
        "permissionMask": 1919,
        "metadata": {
          "extension": "jpg",
          "thumbnailState": "yes",
          "contentETag": 3,
          "versionNumber": 2,
          "assetFileModified": 1476111682098,
          "assetType": "jpg",
          "folderPath": "/Demo Zone/Images/Nature/Wildlife",
          "assetDomain": "image",
          "filename": "Parrots.jpg",
          "assetPath": "/Demo Zone/Images/Nature/Wildlife/Parrots.jpg",
          "fileCreated": 1476111681000,
          "previewState": "yes",
          "name": "Parrots.jpg",
          "width": 1600,
          "assetFileModifier": "admin",
          "id": "9wmc_7LYq2NAmsYU6Lch_t",
          "fileModified": 1476111681000,
          "previewETag": 2,
          "height": 1067
        },
        "relation": null
      },
      "versionCreatingAction": true
    }
  ]
}