Tenant & infrastructure BIL-04
Where an Application owner's data lives, and support-run tier changes. Tenants aren't billed.
| Who can use it | Tenant owner (read), tenants.manage (write) |
|---|---|
| Where it is | /dev/tenant · link: https://hub.substratalapps.com/dev/tenant or substratal://dev/tenant |
| Available on | Web (PWA), iOS / iPadOS, Android, Windows, Linux (GNOME), macOS |
| Phase | Phase 2 |
What you can do here
- Open request — 422/409 errors
- Open request detail — polls every 30 s while visible
- Advance request — staff only; status scheduled → in_progress → completed, or cancelled
Related guides
- Registering and managing applications — Register an app, configure redirect URIs, settings and roles, set up push, and the review lifecycle.
On your platform
| App | Status | How it's built |
|---|---|---|
| Web (PWA) | — | Detail pane with header, tablist, toolbar; full page < 768 px |
| iOS / iPadOS | — | Pushed view; segmented Picker; toolbar actions |
| Android | Planned | Detail pane / pushed screen; PrimaryTabRow; top-bar actions |
| Windows | — | Detail pane / drill-in page; SelectorBar tabs; CommandBar actions |
| Linux (GNOME) | — | Content pane; AdwViewSwitcher; header-bar actions |
| macOS | — | Detail column; tabs as segmented Picker in toolbar principal |
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 | /tenants | List Tenants (your own; all with tenants.manage) |
| GET | /tenants/{id} | Fetch one Tenant |
| GET | /tenants/{id}/tier-change-requests | List tier-change requests for a Tenant |
| POST | /tenants/{id}/tier-change-requests | Open a tier-change request on a customer's behalf (tenants.manage) |
| GET | /tenants/{id}/tier-change-requests/{requestId} | Fetch one tier-change request |
| PATCH | /tenants/{id}/tier-change-requests/{requestId} | Schedule, start, complete, or cancel a tier-change request (tenants.manage) |
Every call sends Substratal-Version: 1. Paths are at the host root, with no /v1.