---
title: "Update Folder"
method: POST
path: "/video/workspaces/{workspace_id}/folders/{folder_id}"
tags: ["API Endpoints"]
---

# Update Folder

`POST /video/workspaces/{workspace_id}/folders/{folder_id}`

Rename a folder, move it to another parent folder, or move assets into the folder by sending `asset_ids`.

## Path parameters

- `workspace_id` string, required
- `folder_id` string, required

## Request body

- union
  - object
    - `name` string — New folder name.
    - `parent_id` string, nullable — New parent folder id. Send `null` to move the folder to the root level.
    - `asset_ids` string[], required — Asset ids to move into this folder.
  - object
    - `name` string, required — New folder name.
    - `parent_id` string, nullable — New parent folder id. Send `null` to move the folder to the root level.
    - `asset_ids` string[] — Asset ids to move into this folder.
  - object
    - `name` string — New folder name.
    - `parent_id` string, nullable, required — New parent folder id. Send `null` to move the folder to the root level.
    - `asset_ids` string[] — Asset ids to move into this folder.

## Response `200`

200

- union
  - object
    - `id` string
    - `name` string
    - `video_source_id` string
    - `parent_id` string, nullable
    - `path` string[]
    - `path_names` string[]
    - `depth` integer
    - `subdirectory_count` integer
    - `asset_count` integer
    - `created_at` string
    - `updated_at` string
  - object
    - `message` string
    - `movedCount` integer

## Other responses

- `400` — 400
- `404` — 404

---

[API](https://skmtc.net/gumlet/apis/gumlet-rest-apis.md) · [All operations](https://skmtc.net/gumlet/apis/gumlet-rest-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gumlet/gumlet-rest-apis/versions/b1f7ac2aeeec/schema)