Store endpoints
Minimum role: manager for all /store paths. App icon and logo assets are exempt from token validation (they are frontend asset paths).
On the v1 tree store apps live under /store/addons; on /v2 under /store/apps. The v1 paths are shown; handlers are shared.
| Method | Path | Role | Description |
|---|---|---|---|
| GET | /store | manager | Store apps and repositories |
| POST | /store/reload | manager | Reload all store repositories |
| GET | /store/addons | manager | All store apps |
| GET | /store/addons/{app} | manager | Store app details |
| GET | /store/addons/{app}/{version} | manager | Store app details (by version path) |
| GET | /store/addons/{app}/icon | none | App icon (image/png) |
| GET | /store/addons/{app}/logo | none | App logo (image/png) |
| GET | /store/addons/{app}/changelog | manager | Changelog (text/plain) |
| GET | /store/addons/{app}/documentation | manager | Documentation (text/plain) |
| GET | /store/addons/{app}/availability | manager | Empty success if installable on this system |
| POST | /store/addons/{app}/install | manager | Install app |
| POST | /store/addons/{app}/install/{version} | manager | Install specific version |
| POST | /store/addons/{app}/update | manager | Update app |
| POST | /store/addons/{app}/update/{version} | manager | Update to specific version |
| GET | /store/repositories | manager | List repositories |
| GET | /store/repositories/{repository} | manager | Repository details |
| POST | /store/repositories | manager | Add a repository |
| DELETE | /store/repositories/{repository} | manager | Remove a repository |
| POST | /store/repositories/{repository}/repair | manager | Reset a broken repository checkout |
GET /store
Response data: addons (v2: apps) — list of store app objects — and repositories.
Store app object: advanced, arch, available, build, description, documentation, apexos (minimum Core version), icon, installed, logo, name, repository, slug, stage, update_available, url, version_latest, version (installed version or null).
GET /store/addons/{app} additionally includes: apparmor, auth_api, detached, docker_api, full_access, supervisor_api, supervisor_role, apexos_api, host_network, host_pid, ingress, long_description, rating, signed.
Repository object: slug, name, source, url, maintainer.
POST /store/addons/{app}/install[/{version}]
| Field | Type | Default | Description |
|---|---|---|---|
background | boolean | false | Return immediately with job_id |
POST /store/addons/{app}/update[/{version}]
| Field | Type | Default | Description |
|---|---|---|---|
backup | boolean | — | Create a partial backup before updating |
background | boolean | false | Return immediately with job_id |
An app cannot update itself; such requests are rejected.
POST /store/repositories
| Field | Type | Required |
|---|---|---|
repository | repository URL | yes |
Legacy aliases under /addons
The v1 tree also registers these store handlers under the installed-apps prefix:
| Method | Path | Same as |
|---|---|---|
| POST | /addons/reload | /store/reload |
| POST | /addons/{app}/install | /store/addons/{app}/install |
| POST | /addons/{app}/update | /store/addons/{app}/update |
| GET | /addons/{app}/icon | /store/addons/{app}/icon |
| GET | /addons/{app}/logo | /store/addons/{app}/logo |
| GET | /addons/{app}/changelog | /store/addons/{app}/changelog |
| GET | /addons/{app}/documentation | /store/addons/{app}/documentation |