Skip to main content
PATCH
/
api
/
v1
/
files
/
{fileNo}
/
rename
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"
}'

{
  "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"
}

Documentation Index

Fetch the complete documentation index at: https://autorender.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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"
}'

{
  "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

PATCH /api/v1/files/{fileNo}/rename updates the file’s name. Pass the new base name in JSON; the API may keep or append the correct extension (e.g. "demo" → "demo.png").

​
Request body

FieldTypeRequiredDescription
namestringYesNew name (extension may be normalized by the server)

​
Success body

Returns the updated file record (database fields such as id, file_no, name, url, workspace_no, meta_data, timestamps, etc.).

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
fileNo
string
required

File number

Example:

"2338045312"

Body

application/json
​
name
string
required

New base name; extension may be applied by the server

Response

File renamed; returns updated file record

Updated file record after rename

​
id
string<uuid>
​
file_no
string
​
name
string
​
folder_id
string | null
​
path
string | null
​
url
string
​
original_url
string | null
​
workspace_id
string<uuid>
​
workspace_no
string
​
height
integer | null
​
width
integer | null
​
format
string
​
file_size
integer
​
is_delete
boolean
​
is_active
boolean
​
created_by
string<uuid>
​
meta_data
object
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
transform_string
string | null
​
source
string
​
is_default
boolean
​
orientation
string | null
​
extension
string