Skip to main content
POST
Move Videos to 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)
Move existing videos into a folder. The target folder must already exist and belong to your account (it is not created automatically). Only videos that belong to your account are moved.

Prerequisites

Request Example

Uses application/json — send the request body as JSON.
cURL

Parameters

folder_id
integer
required
Target folder id. -1 moves videos into the Default folder. The target must already exist and belong to your account — it is not created automatically. Values other than -1 must be > 0.
video_nos
array
required
Video identifiers to move. Maximum 500 per request. Videos that do not belong to your account are rejected.

Response Example

Response Fields

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

Notes & Limits

  • Target must exist: a non-existent target folder (including -1 if your Default folder was never created) returns Folder does not exist or does not belong to the current user.
  • If none of the supplied video_nos belong to your account, the request returns No videos found for the provided video numbers.
  • At most 500 videos can be moved in a single request.

Authorizations

Authorization
string
header
required

Body

application/json
folder_id
integer
required

Target folder id. -1 = Default folder. Must already exist and belong to your account (not auto-created).

Example:

671631448308117500

video_nos
string[]
required

Video identifiers to move. Max 500 per request.

Maximum array length: 500
Example:

Response

200 - application/json

Successful response

code
Example:

"0000"

msg
string
Example:

"success"

data
success
boolean
Example:

true

failed
boolean
Example:

false