Rename folder

Rename an existing folder by folder number.

POST /api/v1/folders/rename/{folderNo}

cURL

curl --request POST \
  --url 'https://upload.autorender.io/api/v1/folders/rename/53855hxPoq' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "demo2"
}'

200

{
  "id": "f3b738aa-c8f7-480d-a861-f5c5895f258b",
  "folder_no": "53855hxPoq",
  "name": "demo2",
  "parent_folder": "84248393-8f6c-4f33-995d-16cf9c738424",
  "workspace_id": "4328e3bf-8252-4f07-a0ec-b3265ffe1552",
  "workspace_no": "FWA7PWC7LZ",
  "is_delete": false,
  "is_active": true,
  "created_by": "27d7fa01-2cd1-4326-9f56-015af7df06e1",
  "created_at": "2026-03-27T15:21:40.693Z",
  "updated_at": "2026-03-27T16:01:38.284Z",
  "source": "app",
  "path": "demo_nested_folder/demo2",
  "workspace": {
    "workspace_no": "FWA7PWC7LZ"
  }
}

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 POST \
  --url 'https://upload.autorender.io/api/v1/folders/rename/53855hxPoq' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "demo2"
}'

200

{
  "id": "f3b738aa-c8f7-480d-a861-f5c5895f258b",
  "folder_no": "53855hxPoq",
  "name": "demo2",
  "parent_folder": "84248393-8f6c-4f33-995d-16cf9c738424",
  "workspace_id": "4328e3bf-8252-4f07-a0ec-b3265ffe1552",
  "workspace_no": "FWA7PWC7LZ",
  "is_delete": false,
  "is_active": true,
  "created_by": "27d7fa01-2cd1-4326-9f56-015af7df06e1",
  "created_at": "2026-03-27T15:21:40.693Z",
  "updated_at": "2026-03-27T16:01:38.284Z",
  "source": "app",
  "path": "demo_nested_folder/demo2",
  "workspace": {
    "workspace_no": "FWA7PWC7LZ"
  }
}

Overview

Renames the folder identified by folderNo. Send the new name in JSON; the response returns the full folder record, including its path, workspace, and timestamps.

Path parameters

Parameter	Description
folderNo	Folder number to rename

Request body

Field	Type	Required	Description
name	string	Yes	New folder name

Next steps

List folders

Browse the folders in your workspace.

Delete folder

Remove a folder from your workspace.

Authorizations

x-api-key · string · header · required

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

Path Parameters

folderNo · string · required

Body

application/json

name · string · required

New folder name without slashes

Response

200

application/json

Renamed folder

Renamed folder

id · string<uuid> · required

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

folder_no · string · required

name · string · required

path · string · required

parent_folder_no · string | null · required

created_at · string<date-time> · required

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

updated_at · string<date-time> | null · required

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$