Rename File

Rename a file within the same space. The file will be renamed to the new name provided in the request. The file identifier will remain the same. The rename operation is immediate and the response contains the updated file name.

Prerequisites

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

Request

POST {baseUrl}/spaces/{spaceId}/files/{fileId}/rename?complete=true

• HEADER:

  • Authorization: Bearer {tid token}

• BODY:

  • name - new name of the file

Example request body:

{
    "name": "new_name"
}

Response

Example response:

{
    "id": "e28982f5-ebd8-4a76-97f4-0783fc143f30",
    "spaceId": "f85bc802-5481-4581-b972-c4652d595ec7",
    "name": "new_name",
    "acl": {
        "contentManager": [
        "trn:tid:user:6529d0b3-5856-41ab-88b3-86f7955cddf1",
        "trn:tid:user:7529d0b3-5856-41ab-88b3-86f7955cddf1"
        ],
        "contentContributor": [
        "trn:tid:application:f85bc802-5481-4581-b972-c4652d595ec7",
        "trn:tid:application:e28982f5-ebd8-4a76-97f4-0783fc143f31"
        ],
        "contentViewer": [
        "trn:tid:device:8529d0b3-5856-41ab-88b3-86f7955cddf1"
        ]
    },
    "createdAt": "2023-05-30T10:30:00Z",
    "createdByTrn": "trn:tid:application:f85bc802-5481-4581-b972-c4652d595ec7",
    "updatedAt": "2023-05-30T10:30:00Z",
    "updatedByTrn": "trn:tid:application:f85bc802-5481-4581-b972-c4652d595ec7",
    "deleted": false,
    "parentId": "e492c129-141d-4679-b0a7-829580679b6a",
    "path": "testA/new_name/",
    "version": "1.3",
    "fileset": false,
    "restrictedAccess": false,
    "expiresAt": "2024-01-01T12:25:00.000Z",
    "metadata": {
        "language": "Suomi"
    },
    "download": {
        "url": "https://example.com/download/12345678-90ab-cdef-1234-567890abcdef.1"
    },
    "multipart": false,
    "responseHeaders": {
        "response-content-type": "image/jpeg",
        "response-content-disposition": "inline",
        "response-cache-control": "max-age=3000"
    },
    "malwareScanStatus": "CLEAN",
    "lastMalwareScanDate": "2023-05-30T10:30:00Z",
    "size": 1024
}

To know more about the rename file API refer here.