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

Renaming retags every product that carried the old label, because the label is the join key rather than an ID.

**Errors**

- `404 category_not_found` — unknown ID, or one belonging to another tenant.
- `409 category_name_taken` — the new label already exists.
- `409 preset_category_immutable` — a built-in category can't be edited.

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