---
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}`

## Request

- Base URL: `https://api.gumlet.com/v1`
- URL: `https://api.gumlet.com/v1/video/workspaces/{workspace_id}/folders/{folder_id}`
- Auth: API key in header `Authorization`

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.dev/gumlet/apis/gumlet-rest-apis.md) - [All operations](https://skmtc.dev/gumlet/apis/gumlet-rest-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/gumlet/apis/gumlet-rest-apis/revisions/b1f7ac2aeeec?raw)