---
search:
  tags:
    - Surfaces
    - PUT
seo:
  description: >-
    The configuration is a string map by design: its shape is… Reference for the
    PUT /stores/{store_id}/surfaces/{surface_id}/config endpoint in the Sarvex
    V1 API.
sidebar:
  label: Replace the merchant-supplied configuration for a surface
  badge: PUT
title: Replace the merchant-supplied configuration for a surface
type: openapi-operation
---
The configuration is a string map by design: its shape is the surface's own
business, declared by the descriptor's `config_schema`, so typing it here
would put surface-specific knowledge into the generic layer. A surface that
declares a schema has the map validated against it (unknown keys and ill-typed
values are a `422`); one that declares none accepts any map. Prerequisites are
re-evaluated against the new configuration before the response is returned.

`PUT /stores/{store_id}/surfaces/{surface_id}/config`