Skip to main content

App Installation

This category lists the 9 Runtime system commands under system.app..

1. Retrieve release​

Full name: system.app.release.get

Retrieve app release resource. This tenant-scoped Runtime command validates its input against the registered command schema. · Risk: Read

sl system app release get --app-id value --version value [--json]

Parameters:

  • appId（required）— Immutable reverse-domain application identifier
  • version（required）— Immutable SemVer release version

2. Install app​

Full name: system.app.install

Install the app Runtime operation. This tenant-scoped command validates its input against the registered command schema. · Risk: Write

sl system app install \
  --app-id value --version value \
  (--configuration-json json|--configuration-file path) \
  --accept-permissions [--json]

Parameters:

  • appId（required）— Application identifier returned by release.get
  • version（required）— Exact release version returned by release.get
  • configuration（required）— Configuration object validated against the reviewed release JSON Schema
  • acceptedPermissions（required）— Must be true to accept the reviewed permission declaration

3. List installations​

Full name: system.app.installation.list

List app installation records. This tenant-scoped Runtime command validates its input against the registered command schema. · Risk: Read

sl system app installation list [--json]

Parameters: none beyond common options such as --json.

4. Retrieve installation​

Full name: system.app.installation.get

Retrieve app installation resource. This tenant-scoped Runtime command validates its input against the registered command schema. · Risk: Read

sl system app installation get --app-id value [--json]

Parameters:

  • appId（required）— Installed application identifier

5. Retrieve configuration​

Full name: system.app.configuration.get

Retrieve app configuration resource. This tenant-scoped Runtime command validates its input against the registered command schema. · Risk: Read

sl system app configuration get --app-id value [--json]

Parameters:

  • appId（required）— Active installed application identifier

6. Update configuration​

Full name: system.app.configuration.update

Update app configuration resource. This tenant-scoped Runtime command validates its input against the registered command schema. · Risk: Write

sl system app configuration update \
  --app-id value (--configuration-json json|--configuration-file path) \
  [--json]

Parameters:

  • appId（required）— Active installed application identifier
  • configuration（required）— Configuration values validated against the installed reviewed release schema; omitted secrets remain unchanged

7. Activate installation​

Full name: system.app.installation.activate

Activate app installation resource. This tenant-scoped Runtime command validates its input against the registered command schema. · Risk: Write

sl system app installation activate --app-id value [--json]

Parameters:

  • appId（required）— Configured application identifier to health-check and activate

8. Disable installation​

Full name: system.app.installation.disable

Disable app installation resource. This tenant-scoped Runtime command validates its input against the registered command schema. · Risk: Write

sl system app installation disable --app-id value [--json]

Parameters:

  • appId（required）— Active application identifier to stop and disable

9. Uninstall app​

Full name: system.app.uninstall

Uninstall the app Runtime operation. This tenant-scoped command validates its input against the registered command schema. · Risk: High risk

sl system app uninstall --app-id value [--json]

Parameters:

  • appId（required）— Installed application identifier to remove