---
search:
  tags:
    - Kategorien
    - POST
seo:
  description: >-
    Kategorie aktualisieren (POST-Body ist partiell). Erfordert einen Write-Key.
    Leere allowStore- oder hideStore-Arrays entfernen das Feld.
sidebar:
  label: Kategorie aktualisieren
  badge: POST
title: Kategorie aktualisieren
type: openapi-operation
---
Kategorie aktualisieren (POST-Body ist partiell). Erfordert einen Write-Key. Leere `allowStore`- oder `hideStore`-Arrays entfernen das Feld.

`POST /categories/{categoryId}`

**Request body** (`application/json`, required)

- `name` (string)
- `externalId` (string) — Optionale externe Kennung
- `index` (number)
- `showOnScreen` (boolean)
- `imageUrl` (string)
- `marginMinPercent` (number)
- `marginMaxPercent` (number)
- `hideStore` (string[]) — Leeres Array entfernt das Feld.
- `allowStore` (string[]) — Leeres Array entfernt das Feld.
- `deleted` (boolean) — Auf true setzen zum Soft-Löschen.

Request body example:

```json
{
  "index": 2
}
```

**Responses**

- `200` — Aktualisiert
- `400` — Ungültige Parameter oder ungültiger Body.
- `403` — Fehlender, unbekannter oder inaktiver API-Key oder ein Read-Key bei einem Schreibzugriff.
- `404` — Kein Eintrag mit dieser ID.

Response example, 200:

```json
{
  "success": true
}
```

Response example, 400:

```json
{
  "statusCode": 400,
  "message": "Validation failed for Field: name, Error: Required",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/suppliers"
}
```

Response example, 403:

```json
{
  "statusCode": 403,
  "message": "Unknown Error",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/products"
}
```