---
title: "Rename a folder"
method: POST
path: "/api/folders/{id}"
tags: ["Folders"]
---

# Rename a folder

`POST /api/folders/{id}`

## Request

- Base URL: `https://morfee.furo.solutions`
- URL: `https://morfee.furo.solutions/api/folders/{id}`
- Auth: one of:
  - API key in header `X-Api-Key`
  - HTTP bearer

Needs a key scoped `write` or `full`.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string, required

## Response `200`

Renamed.

- object
  - `ok` boolean
  - `folder` Folder
    - `id` string, required
    - `name` string, required
    - `templates` integer: How many templates sit on this shelf.
    - `createdAt` string, date-time

## Other responses

- `400`: Something in the request is wrong, and the message says what.
- `401`: No key, an unknown key or a revoked one.
- `403`: The key is real and the organization is right, but the scope on it does not cover this. The message names the scope the key has, what that scope may do, and how to get a wider one, because the thing reading it is usually the thing that has to act on it.
- `404`: Not there, or not yours. Both give the same answer on purpose: a different one would let a caller find out which ids exist in another organization.

---

[API](https://skmtc.dev/furo/apis/morfee.md) · [All operations](https://skmtc.dev/furo/apis/morfee/llms.txt) · [OpenAPI document](https://skmtc.dev/furo/apis/morfee/revisions/83f95f89653f?raw)