Update a file

File service supports modifications to file attributes with file versioning.

The attributes are updated using a PATCH request and passing the attributes you want to change in the body.

The file content is updated by creating a new minor version. The version is an updated file that is referenced as the current file version. Other versions are stored in File service for reference.

Prerequisites

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

Request

Using the update file by ID API Call to change file attributes:

PATCH {baseUrl}/spaces/{spaceId}/files/{fileId}

• HEADER:

  • Authorization: Bearer {tid token}

• BODY:

  • acl - Access control list for the file
  • metadata - Metadata for the file

Example Request

{
       "acl": {
           "ContentManager": [
               "trn:tid:application:fae7a6aa-cf9b-42ad-945b-a89d1c1ec563"
           ]
       },
       "metadata": {
           "testkey": "testvalue5"
       }
   }

You cannot change the public/private status on an existing file. To change the status, upload a new version using the restricted_access parameter.

Response

Example response:

{
       "id": "f85bc802-5481-4581-b972-c4652d595ec7",
       "name": "name",
       "type": "FILE",
       "version": "1.1",
       "acl": {
           "ContentManager": [
               "trn:tid:application:fae7a6aa-cf9b-42ad-945b-a89d1c1ec563"
           ]
       },
       "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:6529d0b3-5856-41ab-88b3-86f7955cddf1",
       "updatedByTrn": "trn:tid:user:7529d0b3-5856-41ab-88b3-86f7955cddf1",
       "deleted": false
   }

To know more about the update file API refer here.