---
title: "Confirm Canonical Name"
method: PATCH
path: "/api/products/{product_id}/canonical"
tags: ["Products"]
---

# Confirm Canonical Name

`PATCH /api/products/{product_id}/canonical`

## Request

- Base URL: `https://api.soeru.biz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.soeru.biz/api/products/{product_id}/canonical`
- Auth: none declared. Required headers: `authorization`

Confirm/lock canonical names for this product (Layer 3 manual_2step).

## Path parameters

- `product_id` string, required

## Headers

- `x-shop-id` string, nullable: Optional shop ID
- `authorization` string, required: Bearer <token>

## Request body

- ConfirmCanonicalRequest: Request to confirm the canonical (4-register) product names. `conversational` is the primary name SOERU should use when addressing the customer (e.g., 「スパイスカレーキット」). The other three are optional — if omitted, we leave the existing value untouched (so Haiku's prior canonicalization is preserved where the operator didn't override it).
  - `conversational` string, required
  - `formal` string, nullable
  - `category` string, nullable
  - `vague` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/soeru/apis/soeru-api.md) · [All operations](https://skmtc.dev/soeru/apis/soeru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soeru/apis/soeru-api/revisions/63f8d371abed?raw)