Rename file

Change a file display name; server may normalize extension.

PATCH /api/v1/files/{fileNo}/rename

cURL

curl --request PATCH \
  --url 'https://upload.autorender.io/api/v1/files/2338045312/rename' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "demo"
}'

200

{
  "id": "974628c2-9b55-4ce4-adf1-9b63edff6baa",
  "file_no": "2338045312",
  "name": "demo.png",
  "folder_id": null,
  "path": null,
  "url": "FWA7PWC7LZ/demo.png",
  "original_url": null,
  "workspace_id": "4328e3bf-8252-4f07-a0ec-b3265ffe1552",
  "workspace_no": "FWA7PWC7LZ",
  "height": 910,
  "width": 1849,
  "format": "png",
  "file_size": 194141,
  "is_delete": false,
  "is_active": true,
  "created_by": "27d7fa01-2cd1-4326-9f56-015af7df06e1",
  "meta_data": {
    "size": 194141,
    "width": 1849,
    "format": "image/png",
    "height": 910,
    "orientation": null
  },
  "created_at": "2026-03-27T14:56:20.511Z",
  "updated_at": "2026-03-27T17:55:05.675Z",
  "transform_string": null,
  "source": "app",
  "is_default": false,
  "orientation": "square",
  "extension": "image"
}

Key type: requires a private key. A public key returns 403 here, because it may only upload — see key types and scope. Call this from your server, never from browser code.

cURL

curl --request PATCH \
  --url 'https://upload.autorender.io/api/v1/files/2338045312/rename' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "demo"
}'

200

{
  "id": "974628c2-9b55-4ce4-adf1-9b63edff6baa",
  "file_no": "2338045312",
  "name": "demo.png",
  "folder_id": null,
  "path": null,
  "url": "FWA7PWC7LZ/demo.png",
  "original_url": null,
  "workspace_id": "4328e3bf-8252-4f07-a0ec-b3265ffe1552",
  "workspace_no": "FWA7PWC7LZ",
  "height": 910,
  "width": 1849,
  "format": "png",
  "file_size": 194141,
  "is_delete": false,
  "is_active": true,
  "created_by": "27d7fa01-2cd1-4326-9f56-015af7df06e1",
  "meta_data": {
    "size": 194141,
    "width": 1849,
    "format": "image/png",
    "height": 910,
    "orientation": null
  },
  "created_at": "2026-03-27T14:56:20.511Z",
  "updated_at": "2026-03-27T17:55:05.675Z",
  "transform_string": null,
  "source": "app",
  "is_default": false,
  "orientation": "square",
  "extension": "image"
}

Overview

Updates a file’s display name. Send the new base name as name in JSON; the server keeps or appends the correct extension (e.g. "demo" becomes "demo.png").

Request body

Field	Type	Required	Description
name	string	Yes	New name (extension may be normalized by the server)

Success body

Returns the updated file record — fields such as id, file_no, name, url, workspace_no, meta_data, and timestamps.

Next steps

File details

Fetch the full metadata for the renamed file.

Delete file

Permanently remove a file from your workspace.

Authorizations

x-api-key · string · header · required

API key for public endpoints. Can also be provided via Authorization: Bearer

Path Parameters

fileNo · string · required

Body

application/json

name · string · required

New file name without extension or path separators

Response

200

application/json

Renamed file

Renamed file

success · enum<boolean> · required

Available options: true

data · object · required

Show child attributes