---
title: "Update Doc Folder"
method: PUT
path: "/api/v1/docs/folders/{folder_id}"
tags: ["docs"]
---

# Update Doc Folder

`PUT /api/v1/docs/folders/{folder_id}`

Rename, move (parent_id null = root) and reorder a folder in one write.

## Path parameters

- `folder_id` string, uuid, required

## Request body

- DocFolderUpdate — PUT semantics: every field is written. ``parent_id: null`` is the root.
  - `name` string, required
  - `parent_id` string, uuid, nullable
  - `position` integer

## Response `200`

Successful Response

- DocFolderRead
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `name` string, required
  - `parent_id` string, uuid, nullable, required
  - `position` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `403` — Error
- `404` — Error
- `409` — Error
- `422` — Validation Error

## Changes

- **2026-09-04** `a9141b6e4e7e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/docs/folders/:folder_id/put.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/41c5e4645524?raw)