Skip to main content
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)
Delete a folder you created. A folder that still contains parsed videos cannot be deleted — move or delete those videos first. Unparsed/failed videos in the folder are removed together with it. The built-in Default folder (-1) and legacy API folder (-2) cannot be deleted.

Prerequisites

Request Example

Uses application/x-www-form-urlencoded — send folder_id as a form field.
cURL

Parameters

folder_id
integer
required
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

code
string
Business status code. 0000 indicates success.
msg
string
Human-readable status message.

Notes & Limits

  • If the folder contains a video with status PARSE, deletion is rejected with Data 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 <= 0 returns an error — the default/virtual folders are not deletable.

Authorizations

Authorization
string
header
required

Body

application/x-www-form-urlencoded
folder_id
integer
required

Folder id to delete. Must be > 0 and belong to your account. Fails if it contains parsed videos.

Example:

671631448308117500

Response

200 - application/json

Successful response

code
Example:

"0000"

msg
string
Example:

"success"

data
success
boolean
Example:

true

failed
boolean
Example:

false