---
title: "Update Label"
description: "Rename, recolor, describe, move or reorder a label or group."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Label

Use the Speak AI MCP server tool `update_label` to rename, recolor, describe, move
or reorder a label or group.

## What does it do?

Rename, recolor, describe, move or reorder a label or group. Send only the fields to
change. parentId null moves a label to the top level. An archived label cannot be
edited (`restore_label` first), and a group cannot take a color or a parent. 409
means another active label under the same parent already has the name. Requires the
labels update permission (every member by default). The change is recorded in your
Speak Notifications under Label (type label).

## Parameters

`update_label` takes 6 parameters, 1 of them required.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `labelId` | string | Yes | labelId from `list_labels` |
| `name` | string | No | New name (1 to 80 characters) |
| `description` | string | No | New description (up to 500 characters, empty clears it) |
| `color` | string | No | New color as #rrggbb |
| `parentId` | string or null | No | labelId of a group to move into, or null for the top level |
| `sortOrder` | number | No | New position among its siblings (0 to 1000000) |

## Behaviour

The Speak AI MCP server publishes these behaviour hints for `update_label`.

- Can change data in your workspace.
- Can delete or overwrite data. Use with care.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.

## Related

- [Labels & comments](/mcp/tools/labels-comments/) lists the rest of the Labels &
  comments category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/labels-comments/update_label/index.mdx