Files
dashback/docs/api/routes/article/set-brand.md
2026-10-02 00:15:22 +02:00

1.8 KiB

PUT /article/{sku}/brand

Protected. Requires a valid session cookie (credentials: 'include').

Set or clear article brand by SKU

Sets the article's brandId (must belong to the article's company). Pass null to clear the brand. Returns the same shape as GET by SKU.

Path parameters

Param Required Type Description
sku yes string

Body (JSON)

Field Required Type Description
brandId yes integer
{
  "brandId": 3
}

Signals

On success, emits SSE signal: article-<sku> (see GET /events).

Response 200

Updated article detail

{
  "article": {
    "id": 1,
    "sku": "…",
    "name": "…",
    "slug": "…",
    "track_stock": true,
    "unitamount": 1,
    "weight": 1,
    "unit": {},
    "brand": {},
    "categoryIds": [
      1
    ],
    "photos": [
      {}
    ],
    "eans": [
      "…"
    ],
    "prices": [
      {
        "minmultiplier": 1,
        "net": 1,
        "taxRate": 1,
        "customergroupId": 1
      }
    ],
    "suppliers": [
      {
        "id": 1,
        "articleId": 1,
        "entityId": 1,
        "supplierName": "…",
        "sku": "…",
        "pu": 1,
        "stock": 1,
        "sort": 1,
        "priceId": 1,
        "price": {
          "net": 1,
          "taxId": 1,
          "taxRate": 1
        }
      }
    ]
  }
}

Errors

Status Description
400 Validation error — {"error":"…"}
401 Unauthorized — {"error":"…"}
403 Not authorized — {"error":"…"}
404 Article or brand not found — {"error":"…"}

Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.