API Reference

List published apps. Query params: q (search), category, sort (popular | newest | top-rated | name), page, limit (max 50).

curl "https://YOUR-MARKETPLACE/api/apps?q=dashboard&sort=popular&page=1"

Featured apps, in curated order.

Reviews for an app. Params: page, limit, sort (newest | helpful | highest | lowest).

Download an app's package (.zip). Optional params: version (defaults to the current version), client_id (opaque installer id for analytics). Each call records an install.

curl -L -o app.zip "https://YOUR-MARKETPLACE/api/apps/hello-world/download"

Get a time-limited URL to upload a file directly to storage. Body: kind (package | media), filename, slug. Returns uploadUrl (PUT target), blobUrl (store this), and required headers.

curl -X POST https://YOUR-MARKETPLACE/api/publish/upload-url \
  -H "X-API-Key: aihub_..." -H "Content-Type: application/json" \
  -d '{"kind":"package","filename":"my-app-v1.zip","slug":"my-app"}'

# then upload the file itself:
curl -X PUT "<uploadUrl>" \
  -H "x-ms-blob-type: BlockBlob" \
  --data-binary @my-app-v1.zip

Create or update an app listing and add a version. Required: name, shortDescription, description (markdown), category, version (semver). Recommended: packageUrl / packageSize / packageChecksum (SHA-256) from the upload step, plus tags, license, releaseNotes, iconUrl, setupWizard.

Publishing the same slug again with a new version updates the listing; re-using an existing version number is rejected with 409.

List the authenticated developer's published apps.

Upgrade the account to developer and receive an API key (shown once). Idempotent — if you're already a developer it returns your profile without generating a new key.

Regenerate the API key. The old key stops working immediately; the new key is returned once.

Latest EveriApp Builder release metadata (proxied from GitHub Releases). Returns 404 when no public release exists yet.