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

# Replace classification assignments

> Replaces all classification assignments for a single entity (item or store). Existing assignments not in the request are deleted.

<ParamField header="x-api-key" type="string" required>
  BOH API key with `catalog:write` scope.
</ParamField>

<ParamField path="vendorId" type="string" required>
  Vendor UUID.
</ParamField>

<ParamField body="entity_type" type="string" required>
  `ITEM` or `STORE`.
</ParamField>

<ParamField body="entity_id" type="string" required>
  UUID of the item or store being classified.
</ParamField>

<ParamField body="assignments" type="object[]" required>
  One entry per classification category:

  <Expandable title="assignment entry fields">
    <ParamField body="classification_category_id" type="string" required>UUID of the classification category.</ParamField>
    <ParamField body="classification_ids" type="string[]" required>UUIDs of the values to assign within this category. Pass `[]` to clear the category.</ParamField>
  </Expandable>
</ParamField>

<ParamField body="external_user_id" type="string">
  Actor for audit trail.
</ParamField>

<ResponseField name="items" type="object[]">
  The complete list of assignments now in effect for the entity. Each entry: `id`, `classification_category_id`, `classification_id`, `entity_type`, `entity_id`.
</ResponseField>

<Warning>
  This endpoint **replaces** all existing assignments for the entity. If you only want to update one category, you must include all other categories you want to keep.
</Warning>

<RequestExample>
  ```json theme={null}
  {
    "entity_type": "ITEM",
    "entity_id": "itm_01j5k...",
    "assignments": [
      {
        "classification_category_id": "cat_familia_01...",
        "classification_ids": ["val_proteinas_01..."]
      },
      {
        "classification_category_id": "cat_temp_01...",
        "classification_ids": ["val_refrigerado_01...", "val_congelado_01..."]
      }
    ],
    "external_user_id": "user_setup_01"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "asgn_01...",
        "account_id": "acc_01...",
        "vendor_id": "vnd_01...",
        "classification_category_id": "cat_familia_01...",
        "classification_id": "val_proteinas_01...",
        "entity_type": "ITEM",
        "entity_id": "itm_01j5k...",
        "metadata": {},
        "created_at": "2026-08-07T14:30:00.000Z",
        "updated_at": "2026-08-07T14:30:00.000Z"
      }
    ]
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "kind": "item_not_found",
      "message": "Item not found"
    }
  }
  ```
</ResponseExample>