Rename Folder
Folder Management
Rename Folder
Rename an existing folder in your Private Video Library.
POST
Rename Folder
Product: Visual Search
Use case: Organize your indexed videos into folders and scope uploads/searches to a folder
Host:
https://api.memories.ai/serve/api/v1
Auth: Authorization: sk-mavi-... (no Bearer prefix)-1) and the legacy API folder (-2) cannot.
Prerequisites
- You have created a memories.ai API key.
- You have a folder id from List Folders or Create Folder.
Request Example
Uses
application/x-www-form-urlencoded — send folder_id and new_name as form fields.cURL
Parameters
Id of the folder to rename. Must be > 0 and belong to your account. The Default folder (
-1) and legacy API folder (-2) cannot be renamed.New folder name. Maximum 100 characters. Must not collide with an existing folder name in your account.
Response Example
Response Fields
Business status code.
0000 indicates success.Human-readable status message.
Identifier of the renamed folder (unchanged).
The new folder name.
Notes & Limits
- Passing
folder_id<= 0returns an error — the default/virtual folders are not renamable. - A folder that does not belong to your account returns
Folder does not exist or does not belong to the current user. - Renaming to an existing name returns
Folder with this name already exists.
Authorizations
Body
application/x-www-form-urlencoded
