u

docs/api/routes/article/create.md

@@ -2,15 +2,21 @@
 
 Protected. Requires a valid session cookie (`credentials: 'include'`).
 
-Create article
+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 |  |
+| `track_stock` | no | boolean | Whether to track inventory stock (defaults to true) |
+
 ```json
 {
-  "parentId": 10,
+  "categoryId": 10,
   "name": "New article"
 }
 ```
@@ -27,7 +33,7 @@ Created
 {
   "article": {
     "id": 1,
-    "parentId": 1,
+    "categoryId": 1,
     "name": "…",
     "sku": "…",
     "track_stock": true