dashback/docs/api/routes/brand/create.md

POST /brand

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

Create brand

Creates a brand for the selected company. Fails with Brand already exists if the name is taken. Emits SSE signal brand with payload { sender, brandId } (sender echoes the caller's x-client-id).

Body (JSON)

Field	Required	Type	Description
name	yes	string
gsprpinfo	no	string

{
  "name": "Acme",
  "gsprpinfo": "Acme GmbH"
}

Signals

On success, emits SSE signal: brand (see GET /events).

Response 201

Created brand

{
  "brand": {
    "id": 1,
    "name": "…",
    "gsprpinfo": "…",
    "pics": [
      {
        "fullHash": "…",
        "thumbW": 1,
        "thumbH": 1,
        "thumbHash": "…"
      }
    ]
  }
}

Errors

Status	Description
400	Invalid brand or no company selected — {"error":"…"}
401	Unauthorized — {"error":"…"}
403	Not authorized — {"error":"…"}
404	Company not found — {"error":"…"}
409	Brand already exists — {"error":"…"}

---

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