SMsmokeball
Files

Get file history on a matter

Changed on

Returns the full list of history entries for the specified file. The result is not paged.

get/matters/{matterId}/documents/files/{fileId}/history

Request

  • Base URL
    https://api.smokeball.com
  • URL
    https://api.smokeball.com/matters/{matterId}/documents/files/{fileId}/history
  • Auth
    API key in header x-api-key and API key in header Authorization

Path parameters

matterIdstring required

Unique identifier (GUID) of the matter.

fileIdstring required

Unique identifier (GUID) of the file.

Response

When request is successful. Returns a collection of 'FileFolderLogEntry' objects.

idstring nullable
hrefstring nullable
relationstring nullable
methodstring nullable

Example response

{
  "value": [
    {
      "id": "3f2b1f2a-1d5f-48a4-8f3c-7a7a3c2b5e1a",
      "type": "File",
      "changeType": "Move",
      "timestamp": "2025-08-27T04:12:45Z",
      "oldName": "Draft Response",
      "newName": "Final Response",
      "oldMatterId": "f9e1a9d5-1d2b-4bd2-9a72-6a6e7b5c2f01",
      "newMatterId": "1c0b8a31-0a05-4601-8b87-2d7b1d0caa9a",
      "oldFolderId": "6a5c3b2e-0f1e-4c7e-90e2-2ad3c3e8b0b9",
      "newFolderId": "9b7a2c4d-2e1f-4b6a-8e01-1f2a3b4c5d6e",
      "copySourceFileId": "bb3a6c1d-1e2f-4a7b-9c01-0d9a8c7b6e5f",
      "copySourceFolderId": "aa2b5c1e-7f8a-4d9e-8c01-1a2b3c4d5e6f",
      "documentVersionId": "2d97e267-0618-4822-a515-281cd4f31ae8-72324ca30d263b32bb38a481cc5f7a0b",
      "userId": "750eb5c5-ac0b-7d11-4997-e0ce9d8896c8"
    }
  ]
}

Changes

  • 3400f8333094Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • db1b8a86b58eRevision changes
    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status