Settings — Per app SET-02
Override global settings and set app-specific preferences from the app's settings_schema.
| Who can use it | Self, active entitlement |
|---|---|
| Where it is | /settings/apps/:appId · link: https://hub.substratalapps.com/settings/apps/:appId or substratal://settings/apps/:appId |
| Available on | Web (PWA), iOS / iPadOS, Android, Windows, Linux (GNOME), macOS |
| Phase | Phase 2 |
What you can do here
- Change row — 422 → field error from details (enum_mismatch, out_of_range, undeclared_key).
Related guides
- Your account, privacy and app settings — Profile, changing your email, downloading or deleting your data, and settings for each app.
On your platform
| App | Status | How it's built |
|---|---|---|
| Web (PWA) | — | Grouped settings rows in main pane |
| iOS / iPadOS | — | Inset-grouped List/Form |
| Android | Planned | Grouped ListItems |
| Windows | — | Page of SettingsCards |
| Linux (GNOME) | — | AdwPreferencesPage |
| macOS | — | Detail column Form(.grouped); per-row save |
Status is reported by each app's repository; — means that app doesn't report it yet.
For developers: API calls
| Method | Path | What it does |
|---|---|---|
| GET | /users/{id}/apps/{appId}/settings | Fetch fully resolved per-app settings (self, the app's own key, or platform users.list) |
| PATCH | /users/{id}/apps/{appId}/settings | Write per-app overrides (validated against settings_schema; null clears) |
| GET | /applications/{id} | Fetch one Application |
Every call sends Substratal-Version: 1. Paths are at the host root, with no /v1.