---
title: "Update folder"
method: PUT
path: "/knowledgeBase/{kbId}/folder/{folderId}"
tags: ["Knowledge Base"]
---

# Update folder

`PUT /knowledgeBase/{kbId}/folder/{folderId}`

Rename a folder.

**Required permission:** WRITER or higher

## Path parameters

- `kbId` string, required
- `folderId` string, required

## Request body

- object
  - `folderName` string, required

## Response `200`

Folder updated successfully

- FolderUpdateResponseSchema — Response returned by PUT /knowledgeBase/{kbId}/folder/{folderId} (updateFolder).
  - `success` boolean, required
  - `message` string, required

## Other responses

- `400` — Invalid request. Possible reasons: - Missing or empty folder name - Folder name exceeds 255 characters - XSS or invalid characters in folder name
- `401` — Unauthorized - Valid bearer token required
- `403` — Forbidden. Possible reasons: - OAuth token lacks the `kb:write` scope - User lacks WRITER or higher permission on the knowledge base
- `404` — Knowledge base or folder not found
- `409` — Folder with this name already exists at the knowledge base root
- `500` — Internal server error while updating folder
- `503` — Connector service unavailable or connection refused

---

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