Grant app to organization / member scope ORG-07
Create an org-wide grant or change who it includes.
| Who can use it | entitlements.manage or app owner; scope edits by org_admin |
|---|---|
| Where it is | /orgs/:orgId/apps/grant · link: https://hub.substratalapps.com/orgs/:orgId/apps/grant or substratal://orgs/:orgId/apps/grant |
| Available on | Web (PWA), iOS / iPadOS, Android, Windows, Linux (GNOME), macOS |
| Phase | Phase 2 |
What you can do here
- Grant — 409 entitlement_already_exists → already granted (view it). 422 → field errors.
- Save scope
Related guides
- Organizations, plans and billing — Free and Standard, organizations, seats, and who pays.
On your platform
| App | Status | How it's built |
|---|---|---|
| Web (PWA) | — | Modal <dialog> ≥ 768 px; bottom sheet (drag handle, snap points) < 768 px |
| iOS / iPadOS | — | .sheet with NavigationStack + Form (Cancel / primary in toolbar) |
| Android | Planned | Full-screen Dialog (compact) / ModalBottomSheet (short forms) / dialog (expanded) |
| Windows | — | ContentDialog (≤ 5 fields) or drill-in page |
| Linux (GNOME) | — | AdwDialog with AdwPreferencesGroup |
| macOS | — | .sheet with Form(.grouped); ⌘↩ submits, Esc cancels |
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 |
|---|---|---|
| PATCH | /entitlements/{id} | The toggle: change status, term, source (trial→purchase), order_id, or an org grant's member scope |
| POST | /organizations/{id}/entitlements | Grant an app to the whole Organization |
Every call sends Substratal-Version: 1. Paths are at the host root, with no /v1.