Delete Folder
Folder Management
Delete Folder
Delete a folder from your Private Video Library.
POST
Delete 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 legacy API folder (-2) cannot be deleted.
Prerequisites
- You have created a memories.ai API key.
- You have a folder id from List Folders.
Request Example
Uses
application/x-www-form-urlencoded — send folder_id as a form field.cURL
Parameters
Id of the folder to delete. Must be > 0 and belong to your account. The Default folder (
-1) and legacy API folder (-2) cannot be deleted.Response Example
Response Fields
Business status code.
0000 indicates success.Human-readable status message.
Notes & Limits
- If the folder contains a video with status
PARSE, deletion is rejected withData in the current folder cannot be deleted. Move parsed videos out with Move Videos first. - A folder that does not belong to your account returns
Folder does not exist or does not belong to the current user. - Passing
folder_id<= 0returns an error — the default/virtual folders are not deletable.
Authorizations
Body
application/x-www-form-urlencoded
Folder id to delete. Must be > 0 and belong to your account. Fails if it contains parsed videos.
Example:
671631448308117500
