extension.upgrade
Upgrade an installed extension to the platform's current manifest version: re-validates (or migrates) the stored config; permission growth (new scopes / PII / required secrets) needs consent: true from the owner: the reconcile sweep applies only additive upgrades by itself.
- scope:
store:admin - storefront-visible (bumps the catalog generation): yes
- destructive: no
Payload
| field | type | required | notes |
|---|---|---|---|
extensionId | string (/^[a-z0-9-]+\.[a-z0-9-]+$/) | yes | |
consent | boolean (default false) | no |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"extensionId": {
"type": "string",
"pattern": "^[a-z0-9-]+\\.[a-z0-9-]+$"
},
"consent": {
"default": false,
"type": "boolean"
}
},
"required": [
"extensionId"
],
"additionalProperties": false
}Generated from the live platform registries at build time: reference pages cannot go stale. Markdown variant: /reference/commands/extension.upgrade.md