---
search:
  tags:
    - Stores
    - POST
seo:
  description: >-
    Update a store (POST body is partial). Requires a Write key. Send null to
    clear an… Reference for the POST /stores/{storeId} endpoint in the scango.ch
    API.
sidebar:
  label: Update store
  badge: POST
title: Update store
type: openapi-operation
---
Update a store (POST body is partial). Requires a Write key. Send `null` to clear an optional field. Payment provider credentials (Zahls) remain dashboard-only.

`POST /stores/{storeId}`

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

- `name` (string)
- `address` (string | null)
- `zipCode` (string | null)
- `city` (string | null) — Human-readable store label within the organization
- `vatNumber` (string | null)
- `paymentCash` (boolean | null)
- `paymentPaytec` (boolean | null)
- `paymentZahls` (boolean | null)
- `paymentZahlsOffline` (boolean | null)
- `paymentCashOffline` (boolean | null)
- `showSupplier` (boolean | null)
- `hideTextStart` (boolean | null)
- `generalMargin` (number | null)
- `customMessage` (string | null)
- `backgroundImageCart` (string | object | null) — \`null\` removes the field.
- `backgroundImage` (string | object | null) — \`null\` removes the field.
- `backgroundColor` (string | null)
- `backgroundFontColor` (string | null)
- `playSound` (boolean | null)
- `standardSound` (string | null)
- `adminMail` (string | null)
- `showInfoButton` (boolean | null)
- `showPictures` (boolean | null)
- `showPicturesScale` (boolean | null)
- `deleteCountdown` (number | null)
- `logoUrl` (string | null)
- `languageMulti` (boolean | null)
- `languageMain` (string | null)
- `languageSelector` (string[] | null)
- `translations` (object | null)
- `deleted` (boolean) — Set true to soft-delete.

Request body example:

```json
{
  "city": "Bern"
}
```

**Responses**

- `200` — Updated
- `400` — Invalid parameters or body.
- `403` — Missing, unknown or inactive API key, or a Read key on a write operation.
- `404` — No item with this 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"
}
```