---
search:
  tags:
    - Colours
    - PATCH
seo:
  description: >-
    A patch: omitted fields are left alone. Reference for the PATCH
    /api/v1/colors/{id} endpoint in the Bloomcount Public API API.
sidebar:
  label: Update a colour
  badge: PATCH
title: Update a colour
type: openapi-operation
---
A patch: omitted fields are left alone.

Renaming retags every variant colour tag and event colour scheme that carried the old label, because the label
is the join key. That is a cascade across the catalogue, so rename deliberately rather than as a way to create.

**Errors**

- `404 color_not_found` — unknown ID, or one belonging to another tenant.
- `409 color_name_taken` — the new label already exists.
- `409 preset_color_immutable` — a built-in palette colour can't be edited.
- `422 invalid_hex_format` — `hex` isn't a valid hex colour.

<Operation source="reference" id="patch-api-v1-colors-id" />