Skip to main content
PUT
/
api
/
v1
/
settings
Update Store Settings
curl --request PUT \
  --url https://api.launchmystore.io/api/v1/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "business": "<string>",
  "businessEmail": "<string>",
  "phone": "<string>",
  "profileImage": "<string>",
  "storeURL": "<string>",
  "category": "<string>",
  "country": "<string>",
  "storeAdd": {},
  "gstNumber": "<string>",
  "availableCountries": [
    {}
  ],
  "availableLanguages": [
    {}
  ],
  "defaultLanguage": "<string>",
  "useManualExchangeRates": true,
  "manualExchangeRates": {},
  "currencyConversionFee": 123
}
'
{
  "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
}
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

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

​
Response

On success, returns the updated settings object — same shape as Get Store Settings. If no writable fields are supplied, returns 400 with a helpful message listing the allowed fields. 
{
  "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
}