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

POST /article

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

Create article in category

Creates an article under an authorized category (parentId).

Body (JSON)

Field	Required	Type	Description
categoryId	yes	integer	Category ID under which to create the article
name	yes	string
desc	no	string	Article description text/HTML
seo	no	string	SEO text
track_stock	no	boolean	Whether to track inventory stock (defaults to false)

{
  "categoryId": 10,
  "name": "New article"
}

Signals

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

Response 201

Created

{
  "article": {
    "id": 1,
    "categoryId": 1,
    "name": "…",
    "sku": "…",
    "track_stock": true
  }
}

Errors

Status	Description
400	Validation error — {"error":"…"}
401	Unauthorized — {"error":"…"}
403	Not authorized for parent category — {"error":"…"}
404	Parent not found — {"error":"…"}
409	SKU already exists — {"error":"…"}

---

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