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

# Update a store

> Partially updates a store. Only the fields you send are changed; omitted fields keep their current values.

<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 path="storeId" type="string" required>
  Store UUID.
</ParamField>

<ParamField body="name" type="string">
  New display name.
</ParamField>

<ParamField body="code" type="string">
  New short code.
</ParamField>

<ParamField body="timezone" type="string">
  New IANA timezone identifier.
</ParamField>

<ParamField body="external_store_id" type="string">
  New external store identifier.
</ParamField>

<ParamField body="tax_id" type="string">
  New fiscal identifier (RUC, CNPJ, CUIT, NIT, RUT, RFC…, max 64 chars). Set to `null` to clear.
</ParamField>

<ParamField body="metadata" type="object">
  Replaces the existing metadata object.
</ParamField>

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

<ResponseField name="id" type="string">Store UUID.</ResponseField>
<ResponseField name="name" type="string">Updated display name.</ResponseField>
<ResponseField name="status" type="string">Current status.</ResponseField>

<RequestExample>
  ```json theme={null}
  {
    "name": "Main Kitchen - Updated",
    "external_user_id": "user_admin_01"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "str_main_01...",
    "account_id": "acc_01j5k...",
    "code": "STR-001",
    "name": "Main Kitchen - Updated",
    "timezone": "America/Mexico_City",
    "status": "ACTIVE",
    "external_store_id": "store-main",
    "tax_id": "0991234560001",
    "metadata": {},
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-08-07T15:00:00.000Z"
  }
  ```

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