Get File By Path

Get file by path. The response contains the file metadata and the download URL for the file. The download URL is valid for a limited time.

• path - The path of the file for which metadata needs to be retrieved.

• status - To retrieve soft deleted file, set status attribute as deleted. Hard deleted file 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.

Prerequisites

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

Request

GET {baseUrl}/spaces/{spaceId}/files?path={path}

• HEADER:

  • Authorization: Bearer {tid token}

Response

Example response:

{
       "id": "f85bc802-5481-4581-b972-c4652d595ec7",
       "name": "name",
       "type": "FILE",
       "version": "1.1",
       "acl": {
           "ContentManager": [
               "trn:tid:application:<applicationId>"
           ]
       },
       "metadata": {
           "testkey": "testvalue5"
       }
       "spaceId": "f85bc802-5481-4581-b972-c4652d595ec7",
       "createdAt": "2024-03-17T00:00:00Z",
       "updatedAt": "2023-03-19T11:00:00Z",
       "createdByTrn": "trn:tid:user:<userId>",
       "updatedByTrn": "trn:tid:user:<userId>",
       "deleted": false
   }

To know more about the Get file by path API refer here.