---
title: "Update Label"
method: PUT
path: "/user/label/{id}"
tags: ["Labels"]
---

# Update Label

`PUT /user/label/{id}`

## Request

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

Rename a label or change its color

[Docs](https://docs.famulor.io/api-v1/labels/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 label ID
    - `name` string: The label name
    - `color` string: The label color (or `null`)
    - `assistants_count` integer: Number of assistants this label is applied to

## 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)