> ## Documentation Index
> Fetch the complete documentation index at: https://autorender.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Rename folder
> Rename an existing folder by folder number.
```bash cURL theme={null}
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"
}'
```
```json 200 theme={null}
{
"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"
}
}
```
```json 404 theme={null}
{
"error": "Folder not found"
}
```
```json 401 theme={null}
{
"success": false,
"error": "Unauthorized",
"message": "Invalid or missing API key"
}
```
## 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
Browse the folders in your workspace.
Remove a folder from your workspace.
## OpenAPI
````yaml api-reference/openapi.json POST /api/v1/folders/rename/{folderNo}
openapi: 3.0.0
info:
title: AutoRender Public API
description: >-
REST API for uploading, managing, and serving media assets. All endpoints
require an API key via the x-api-key header or Authorization: Bearer .
version: 1.0.0
contact:
name: AutoRender Support
email: support@autorender.io
servers:
- url: https://app-api.autorender.io
description: Production server
security:
- apiKey: []
tags:
- name: Uploads
description: Upload endpoints (API key required)
- name: Files
description: File management endpoints (API key required)
- name: Folders
description: Folder management endpoints (API key required)
paths:
/api/v1/folders/rename/{folderNo}:
post:
tags:
- Folders
summary: Rename folder
operationId: renameFolder
parameters:
- schema:
type: string
in: path
name: folderNo
required: true
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: New folder name without slashes
required:
- name
responses:
'200':
description: Renamed folder
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
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:
type: string
name:
type: string
path:
type: string
parent_folder_no:
nullable: true
type: string
created_at:
type: string
format: date-time
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:
nullable: true
type: string
format: date-time
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))$
required:
- id
- folder_no
- name
- path
- parent_folder_no
- created_at
- updated_at
additionalProperties: false
description: Renamed folder
'400':
description: Invalid payload
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
additionalProperties: false
description: Invalid payload
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
additionalProperties: false
description: Unauthorized
'404':
description: Folder not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
additionalProperties: false
description: Folder not found
'409':
description: Folder name already exists
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
additionalProperties: false
description: Folder name already exists
'429':
description: Rate limit exceeded
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
retryAfterSeconds:
type: number
required:
- error
- message
additionalProperties: false
description: Rate limit exceeded
'503':
description: Limit service unavailable
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
additionalProperties: false
description: Limit service unavailable
security:
- apiKey: []
components:
securitySchemes:
apiKey:
type: apiKey
name: x-api-key
in: header
description: >-
API key for public endpoints. Can also be provided via Authorization:
Bearer
````