> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Store Settings

> Patch a whitelisted subset of the merchant store general settings.

Patch a whitelisted subset of fields on the merchant's general store
settings. The endpoint **silently ignores** unknown fields if any allowed
field is also present, but **returns 400** when the request contains *only*
non-whitelisted fields. This prevents accidental privilege escalation
(e.g., trying to set `id`, `password`, role flags, etc.).

**Required scope:** `write_settings`

## Allowed fields

Only the following fields are writable:

`name`, `business`, `businessEmail`, `phone`, `profileImage`, `storeURL`,
`category`, `country`, `storeAdd`, `gstNumber`, `availableCountries`,
`availableLanguages`, `defaultLanguage`, `useManualExchangeRates`,
`manualExchangeRates`, `currencyConversionFee`.

Any other field (e.g. `id`, `email`, `password`, internal flags) is rejected.

## Request Body

<ParamField body="name" type="string">Store display name.</ParamField>
<ParamField body="business" type="string">Legal business name.</ParamField>
<ParamField body="businessEmail" type="string">Business contact email.</ParamField>
<ParamField body="phone" type="string">Phone number.</ParamField>
<ParamField body="profileImage" type="string">Logo / profile image URL.</ParamField>
<ParamField body="storeURL" type="string">Custom store URL slug.</ParamField>
<ParamField body="category" type="string">Store category.</ParamField>
<ParamField body="country" type="string">ISO country code.</ParamField>
<ParamField body="storeAdd" type="object">Store address.</ParamField>
<ParamField body="gstNumber" type="string">Tax / GST registration number.</ParamField>
<ParamField body="availableCountries" type="array">Countries the store ships to.</ParamField>
<ParamField body="availableLanguages" type="array">Languages the storefront supports.</ParamField>
<ParamField body="defaultLanguage" type="string">Default language code.</ParamField>
<ParamField body="useManualExchangeRates" type="boolean">Toggle manual exchange rates.</ParamField>
<ParamField body="manualExchangeRates" type="object">Currency → rate map.</ParamField>
<ParamField body="currencyConversionFee" type="number">Surcharge on converted prices.</ParamField>

## Response

On success, returns the updated settings object — same shape as
[Get Store Settings](/api-reference/settings/get).

If no writable fields are supplied, returns 400 with a helpful message
listing the allowed fields.

<ResponseExample>
  ```json theme={null}
  {
    "status": 200,
    "state": "success",
    "message": null,
    "data": {
      "settings": {
        "id": "7374cb9e-9f9c-4041-87de-379aea6ed21a",
        "name": "Acme Store (renamed)",
        "business": "Acme Pvt Ltd",
        "currencyConversionFee": 0
      }
    },
    "pagination": null
  }
  ```
</ResponseExample>