Update plugin ecosystem enablement

PATCH

/plugins/settings

curl --request PATCH \
  --url https://example.com/api/v1/plugins/settings \
  --header 'Content-Type: application/json' \
  --data '{ "pluginsEnabled": true }'

• API v1

Persists the global enablement flag and hot-applies it: enabling initializes the plugin host; disabling clears the live registry snapshot. Durable registry rows are retained. Browser requests must be same-origin; authenticated non-browser clients may omit Origin.

Request Body^required

Media typeapplication/json

object

pluginsEnabled

required

Persist and hot-apply global plugin ecosystem enablement without restart.

boolean

Example^generated

{
  "pluginsEnabled": true
}

Responses

200

Updated plugin ecosystem enablement

Media typeapplication/json

Global plugin-ecosystem enablement (UI-backed master switch; default off).

object

pluginsEnabled

required

When false, plugin management/reload/observe are hard no-ops. Nav remains visible.

boolean

Example^generated

{
  "pluginsEnabled": true
}

400

Invalid settings payload

Media typeapplication/json

object

code

required

Stable management failure code; raw filesystem/database diagnostics are never returned.

string

Allowed values: invalid_identity plugins_disabled plugin_not_found internal_error

error

required

string

Example

{
  "code": "invalid_identity"
}

403

Cross-origin browser request rejected before mutation

500

Failed to update plugin settings

Media typeapplication/json

object

code

required

Stable management failure code; raw filesystem/database diagnostics are never returned.

string

Allowed values: invalid_identity plugins_disabled plugin_not_found internal_error

error

required

string

Example

{
  "code": "invalid_identity"
}