Update app settings

PUT

https://numueg.app/api/v1/stores/{store_id}/apps/{slug}/settings

Last modified:2026-09-19 16:39:33

x-numu-scope:settings:write

Update per-store app settings.

MERGES by default. A full replace loses writes whenever two tabs, or a
settings form and an onboarding step, save overlapping keys — the second
save silently drops whatever the first added, with no ETag and no version
history to notice it. Send replace: true to deliberately overwrite the
whole blob (the only honest way to REMOVE a key).

Busts both caches on the way out. Doing neither is what this endpoint did
before: app settings ride the store payload, which the API caches in Redis
for 60s and the storefront caches again under store-{subdomain}, so a
merchant changing a swatch shape saw nothing change and tried again.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://numueg.app/api/v1/stores//apps//settings' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "settings": {
        "property1": "string",
        "property2": "string"
    },
    "replace": false
}'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "slug": "string",
        "name": "string",
        "description": "string",
        "icon_url": "string",
        "version": "string",
        "is_enabled": true,
        "settings": {
            "property1": "string",
            "property2": "string"
        },
        "blocks": [],
        "settings_schema": [],
        "granted_scopes": [],
        "install_status": "active",
        "missing_scopes": [],
        "listing": {
            "tagline": "string",
            "developer": {
                "property1": "string",
                "property2": "string"
            },
            "lockup_url": "string",
            "screenshots": [],
            "highlights": [],
            "locales": {},
            "app_locales": {},
            "features": [],
            "pricing": {
                "property1": "string",
                "property2": "string"
            },
            "languages": [],
            "compatibility": {
                "property1": "string",
                "property2": "string"
            }
        },
        "app_status": "published",
        "is_live": true
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Install an app

Disable app