This commit is contained in:
seb
2026-10-04 19:38:16 +02:00
parent a3926d3547
commit e00533f9fa
3 changed files with 34 additions and 9 deletions

View File

@@ -4,7 +4,15 @@ Protected. Requires a valid session cookie (`credentials: 'include'`).
Toggle father mode for an article
Enables or disables father article status. Enabling requires specifying an attributeNameId; disabling requires the article to have zero children.
Enables or disables father article status. Enabling requires specifying an
attributeNameId; disabling requires the article to have zero children.
`attributeNameId` is **conditionally required**: it is optional in the schema
because it is only required when `isFather` is `true`. Omitting it (or passing
`0`/a negative value) together with `isFather: true` returns `400`
`attributeNameId is required to become a father article`. It must not be sent
when `isFather` is `false`.
## Path parameters
@@ -17,7 +25,7 @@ Enables or disables father article status. Enabling requires specifying an attri
| Field | Required | Type | Description |
|-------|----------|------|-------------|
| `isFather` | yes | boolean | True to make article a father, false to revert to regular article |
| `attributeNameId` | no | integer | Required when isFather is true. The attributename id for variants. |
| `attributeNameId` | no | integer | **Conditionally required when `isFather` is `true`** (required iff isFather=true). The attributename id used for the article's variants. Omitting it while enabling father mode returns 400. Must be omitted when `isFather` is `false`. |
```json
{
@@ -46,7 +54,10 @@ Updated article
| Status | Description |
|--------|-------------|
| 400 | Invalid input or article still has children |
| 400 | Invalid input, `attributeNameId` missing while `isFather` is true, article still
has children, article has stock/suppliers/a Stückliste/options, or the attribute is
already used by an ancestor father article.
|
| 404 | Article or attribute name not found |
---