Search code examples
autodesk-forgeautodesk-data-managementautodesk-webhooks

BIM360 / ACC Webhooks event version.deleted?

I set up a webhooks for all data management events for a folder. When I delete the file (as a user) I get an event with the following :

"hook": {
        "hookId": "9b4a8018-0bcd-some-numbers-7ff2452c806e",
        "tenant": "urn:adsk.wipprod:fs.folder:co.0GGjDTycS3OD96-MDeznyQ",
        "callbackUrl": "https://webhooks.workato.com/someUrl/bim360",
        "createdBy": "rz66ZEJ7QN7D84b5UY99555t4lZHur9o",
        "event": "dm.version.added",
        "createdDate": "2024-05-26T14:00:47.504+00:00",
        "lastUpdatedDate": "2024-05-26T14:00:47.503+00:00",
        "system": "data",
        "creatorType": "Application",
        "status": "active",
        "scope": {
            "folder": "urn:adsk.wipprod:fs.folder:co.0GGjDTycS3OD96-MDeznyQ"
        },
        ....
        ....
       "custom-metadata": {
            "dm_sys_id": "bd290a3c-1df7-4ad0-bef4-af28c75f89ab",
            "file_name": "A507.pdf",
            "lineageTitle": "",
            "forged.originalName": "A507.pdf",
            "dm_command:id": "1d722e66-127b-493f-a6a8-458b3b983701",
            "forge.type": "versions:autodesk.core:Deleted-1.0",
            "storm:entity-type": "SEED_FILE",
            "fileName": "6b2584e1-a126-4d63-a9c3-f4e6ef15fc92"
        }
       .....

I wonder if the dm.version.deleted ( as in here - https://aps.autodesk.com/en/docs/webhooks/v1/reference/events/data_management_events/dm.version.deleted/) ever get triggered ?

There seem to be a lot of 'noise' when it comes to events - for example when I load a new file I get one dm.version.added event and several dm.version.modified fired immediately after , with custom properties change as the document becomes available.

Thanks , Jonathan

Solution

  • ACC/BIM360 only supports soft-delete, so there is no dm.version.deleted event support, as when we delete a file of ACC/BIM360, creating a new version with a version extension deleted is required like the below.

    curl -X POST -H "Authorization: Bearer nFRJxzCD8OOUr7hzBwbr06D76zAT" "https://developer.api.autodesk.com/data/v1/projects/b.cGVyc29uYWw6d2l/versions"
     -H 'content-type: application/vnd.api+json' -d '
 {
  "jsonapi":{
  "version":"1.0"
  },
 "data":{
  "type":"versions",
  "attributes":{
     "extension":{
        "type":"versions:autodesk.core:Deleted",
        "version":"1.0"
     }
  },
  "relationships":{
     "item":{
        "data":{
           "type":"items",
           "id":"urn:adsk.wipprod:dm.lineage:hPW2BlBbQG2L5HjCOh7Z8Q"
        }
     }
    }
  }
}'

    ref: https://aps.autodesk.com/en/docs/data/v2/tutorials/delete-and-restore-file/