v1

latestOpenAPI 3.1.02026-07-2416666272.6 KB

Folders

Update folder

Updates a folder — rename (name), move (parent_folder_id), or toggle status. All body fields are optional.

put/folders/{folder_id}

Path parameters

folder_idstring uuid required

Unique identifier of the folder

Request body

namestring

New folder name

parent_folder_idstring uuid nullable

New parent folder ID (null to move to root)

statusboolean

Folder status (true for active, false for inactive)

Example request

{
  "name": "Updated Folder Name",
  "status": true
}

Response

Folder updated successfully

messagestring

Example response

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "My Video Folder",
    "user_id": "0fc88232-a673-42b1-9e6c-e974d9a937b7",
    "status": true,
    "created_at": "2025-08-01T10:30:00.000Z",
    "updated_at": "2025-08-01T10:30:00.000Z",
    "Videos": [
      {
        "id": "789e0123-e89b-12d3-a456-426614174000",
        "title": "Introduction Video",
        "video_external_id": "ext_video_123",
        "status": "READY",
        "created_at": "2025-08-01T10:30:00.000Z"
      }
    ],
    "funnel": {
      "id": "456e7890-e89b-12d3-a456-426614174000"
    },
    "drm_groups": [
      {
        "id": "321e4567-e89b-12d3-a456-426614174000",
        "name": "Premium Content Group",
        "status": true
      }
    ]
  },
  "message": "Success"
}