Move Videos to Folder
Folder Management
Move Videos to Folder
Move one or more videos into a target folder.
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)Prerequisites
- You have created a memories.ai API key.
- The target folder exists — create it with Create Folder, or use
-1for the Default folder.
Request Example
Uses
application/json — send the request body as JSON.cURL
Parameters
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 identifiers to move. Maximum 500 per request. Videos that do not belong to your account are rejected.
Response Example
Response Fields
Business status code.
0000 indicates success.Human-readable status message.
Notes & Limits
- Target must exist: a non-existent target folder (including
-1if your Default folder was never created) returnsFolder does not exist or does not belong to the current user. - If none of the supplied
video_nosbelong to your account, the request returnsNo videos found for the provided video numbers. - At most 500 videos can be moved in a single request.
Authorizations
Body
application/json
