Help Screens Developer credentials
Create API key KEY-02
Create a key with least-privilege permissions.
| Who can use it | api_keys.manage or app owner (app-scoped) |
|---|---|
| Where it is | /dev/keys/new · link: https://hub.substratalapps.com/dev/keys/new or substratal://dev/keys/new |
| Available on | Web (PWA), iOS / iPadOS, Android, Windows, Linux (GNOME), macOS |
| Phase | MVP |
What you can do here
- Create — 201 ApiKeyWithSecret → KEY-03
Related guides
- API keys — Create keys for servers and agents, store the secret, rotate without downtime, and revoke.
- Rotate an API key without downtime — Replace a server's key with no failed requests.
- Register an application and launch it from the Hub — From an empty catalog entry to people opening your app from Home.
- Test end to end without touching live data — Use test-mode keys and test users to exercise your integration safely.
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 |
|---|---|---|
| POST | /api-keys | Create a key (api_keys.manage, or the Application's owner for an app-scoped key) |
Every call sends Substratal-Version: 1. Paths are at the host root, with no /v1.