List file versions

Get all versions of a file. The response contains a list of the versions for the file. Each version includes the file version metadata and the download URL. The download URL is valid for a limited time. The response is paginated and the number of items returned can be controlled using the limit query parameter.

• status - To retrieve soft deleted file’s versions, set status attribute as deleted. To retrieve active file’s versions, set status attribute as active. Hard deleted file’s versions cannot be retrieved.

• complete - To get full file response set complete parameter as true. By default it is false and minimal response will be returned.

• pageSize - To control the number of items returned in the response, set pageSize attribute. By default, it is set to 100.

• nextPageToken - To get the next set of items, set nextPageToken attribute with the value from the previous response.

Prerequisites

• A file should be created. To know more about uploading a file refer here

Request

GET {baseUrl}/spaces/{spaceId}/files/{fileId}/versions

• HEADER:

  • Authorization: Bearer {tid token}

Response

Example response:

{
     "items": [
       {
         "id": "f85bc802-5481-4581-b972-c4652d595ec7",
         "name": "My File",
         "type": "FILE",
         "spaceId": "f85bc802-5481-4581-b972-c4652d595ec7",
         "version": "1.0",
         "createdAt": "2023-03-19T11:00:00Z",
         "updatedAt": "2024-03-19T11:00:00Z",
         "createdByTrn": "trn:tid:user:6529d0b3-5856-41ab-88b3-86f7955cddf1",
         "updatedByTrn": "trn:tid:user:7529d0b3-5856-41ab-88b3-86f7955cddf1",
         "deleted": false
       },
       {
         "id": "f85bc802-5481-4581-b972-c4652d595ec7",
         "name": "Got a new name",
         "type": "FILE",
         "spaceId": "f85bc802-5481-4581-b972-c4652d595ec7",
         "version": "1.1",
         "createdAt": "2023-03-17T00:00:00Z",
         "updatedAt": "2024-03-26T11:00:00Z",
         "createdByTrn": "trn:tid:user:6529d0b3-5856-41ab-88b3-86f7955cddf1",
         "updatedByTrn": "trn:tid:user:7529d0b3-5856-41ab-88b3-86f7955cddf1",
         "deleted": false
       }
     ],
     "links": {
       "next": {
         "href": "/spaces/_space_id_/files/_file_id_/versions?nextPageToken=eyJwYXRoXyI6eyJTIjoiL1JTbWJtL3hPUXhrIn0sInJldmlzaW9uIjp7IkIiOiJVY1pVaFlDUVR4V2ZqMzdFaWVZOWdnPT0ifX0"
       }
     }
   }

To know more about the List file versions refer here. For List file versions by path refer here.