Skip to main content
POST
/
serve
/
api
/
v1
/
delete_videos
Delete Videos
curl --request POST \
  --url https://api.memories.ai/serve/api/v1/delete_videos \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
[
  "VI1234567890",
  "VI0987654321"
]
'
{
  "code": "0000",
  "msg": "success",
  "data": {},
  "success": true,
  "failed": false
}

Documentation Index

Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt

Use this file to discover all available pages before exploring further.

Product: Visual Search Use case: Upload videos and images, auto-index them, then search by natural language, image, or transcript phrase Host: https://api.memories.ai/serve/api/v1 Auth: Authorization: sk-mavi-... (no Bearer prefix)
Permanently delete one or more videos from your Private Video Library. Deleted videos cannot be recovered.

​
Prerequisites

​
Endpoint

POST /serve/api/v1/delete_videos Rate limit: Maximum 100 videos per request.

​
Request Example

import requests

headers = {"Authorization": "sk-mavi-..."} 
# List of video IDs to delete
data = ["VI1234567890", "VI0987654321"]
params = {"unique_id": "default"}

response = requests.post( 
    "https://api.memories.ai/serve/api/v1/delete_videos", 
    headers=headers, 
    json=data, 
    params=params
)
print(response.json())

​
Request Body

Array of video IDs (strings) — sent as a raw JSON array. 
["VI1234567890", "VI0987654321"]

​
Request Parameters

​
unique_id
string
Unique ID for scope (query parameter). Defaults to “default”.
​
[video_no]
string[]
required
Array of video identifiers to delete. Maximum 100 per request.

​
Response Example

Status code 200 
{
    "code": "0000",
    "msg": "success",
    "data": null,
    "success": true,
    "failed": false
}
Delete is idempotent for unknown video_nos. Passing an array containing a video_no that does not exist (or belongs to a different namespace) still returns code: "0000" with success: true — the call is treated as a no-op for those IDs. There is no per-video status array in the response.

​
Error Responses

// Empty array
{"code":"0001","msg":"The video number list cannot be empty!","data":null,"success":false,"failed":true}

// More than 100 IDs in the array
{"code":"0001","msg":"The number of videos to delete cannot exceed 100!","data":null,"success":false,"failed":true}
unique_id is optional — omitting it falls back to the default namespace and the request still succeeds with code: "0000".

​
Response Fields

​
code
string
Business status code. "0000" indicates success — applies even when none of the supplied video_no values actually existed.
​
msg
string
Human-readable status message. "success" on success; for failures see the Error Responses section above.
​
data
null
Always null on this endpoint — there is no per-video result array.
​
success
boolean
true when the request was accepted (input validation passed). Note that this does not mean any video was actually deleted — see the idempotency note above.
​
failed
boolean
Inverse of success.

Authorizations

​
Authorization
string
header
required

Query Parameters

​
unique_id
string
default:default

Unique ID scope.

Body

application/json

Response

200 - application/json

Successful response

​
code
Example:

"0000"

​
msg
string
Example:

"success"

​
data
​
success
boolean
Example:

true

​
failed
boolean
Example:

false