---
title: "Update Folder"
method: PUT
path: "/user/folder/{id}"
tags: ["Folders"]
---

# Update Folder

`PUT /user/folder/{id}`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/folder/{id}`
- Auth: HTTP bearer

Rename a folder or change its color

[Docs](https://docs.famulor.io/api-v1/folders/update)

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string: New name (max 255 characters). Must be unique within your account.
  - `color` 'gray' | 'slate' | 'red' | 'orange' | 'amber' | 'green' | 'teal' | 'blue' | 'purple' | 'pink': New color. One of: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`. Send `null` to clear it.

## Response `200`

Success Response

- object
  - `message` string: Success message
  - `data` object
    - `id` integer: The folder ID
    - `name` string: The folder name
    - `color` string: The folder color (or `null`)
    - `assistants_count` integer: Number of assistants in this folder

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `404`: Not Found
- `422`: Die Anfrage ist inhaltlich ungültig.

---

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