---
title: "Update a folder"
method: PATCH
path: "/folder/{folder_id}/update/"
tags: ["Folders"]
---

# Update a folder

`PATCH /folder/{folder_id}/update/`

## Request

- Base URL: `https://hovercode.com/api/v2`
- URL: `https://hovercode.com/api/v2/folder/{folder_id}/update/`
- Auth: API key in header `Authorization`

Rename (`name`; slug regenerated) and/or move (`parent`: id or slug, or null for top level). A folder can't be moved into itself or a subfolder.

## Path parameters

- `folder_id` string, uuid, required

## Request body

- object
  - `name` string
  - `parent` string, nullable: Folder id or slug; null = top level.

## Response `200`

OK

- Folder
  - `id` string, uuid, required
  - `name` string, required
  - `slug` string, nullable, required
  - `path` string, required
  - `parent` string, uuid, nullable, required
  - `code_count` integer, required
  - `created` string, date-time, required

## Other responses

- `400`: Validation error.
- `401`: Missing or invalid API token.
- `404`: Not found, or not in a workspace you belong to.
- `415`: Request body was not JSON.
- `429`: Rate limit exceeded. Wait `Retry-After` seconds before retrying.

---

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