Connect a local theme dev server (numu-theme dev)

POST

https://numueg.app/api/v1/stores/{store_id}/themes/external/dev-mode

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

x-numu-scope:themes:write

Connect a local theme dev server URL to this store.

The dev server should be running numu-theme dev (default port: 4321).
The backend probes the dev server to verify it's reachable, then stores
the URL in theme_settings.external_theme with mode="dev" so the storefront
knows to bypass caching and always re-fetch the bundle.

Used for the local development workflow:

Developer runs numu-theme dev in their theme repo

Developer pastes the URL (http://localhost:5173) into the dashboard

Storefront loads from the dev URL, no caching

Developer edits files → vite rebuilds → developer refreshes storefront

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 'https://numueg.app/api/v1/stores//themes/external/dev-mode' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "dev_url": "string"
}'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "has_external_theme": true,
        "theme_id": "string",
        "bundle_url": "string",
        "css_url": "string",
        "version": "string",
        "source_repo": "string",
        "built_at": "2019-08-24T14:15:22.123Z"
    },
    "message": "string"
}

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

Remove External Theme

Get Build Status