---
title: "Update a media folder"
method: PATCH
path: "/workspace/media/folders/{folderId}"
tags: ["Media Library"]
---

# Update a media folder

`PATCH /workspace/media/folders/{folderId}`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/workspace/media/folders/{folderId}`
- Auth: API key in header `Authorization`

Update a media folder.

## Path parameters

- `folderId` string, required

## Request body

- object
  - `name` string
  - `parent_folder_id` string, nullable
  - `description` string, nullable
  - `icon_type` 'folder' | 'code' | 'video' | 'audio' | 'image' | 'document' | 'star' | 'spark'

## Response `200`

Successful response

- object
  - `success` true, required
  - `folder` object, required
    - `id` string, required
    - `name` string, required
    - `parentFolderId` string, nullable, required
    - `description` string, nullable
    - `iconType` string, nullable

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)