Apps API

Use the Apps API to discover app and build UUIDs, then configure the default Chrome extensions loaded with a web app. All requests require an API key in the X-API-Key header. See API Reference for authentication.

List Apps

GET /api/v1/apps — Returns 200 OK

platform

string

Optional platform filter: ios, android, web, or chrome-extension.

curl "https://backend.autosana.ai/api/v1/apps?platform=chrome-extension" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "apps": [
    {
      "id": "extension-app-uuid",
      "name": "MetaMask",
      "platform": "chrome-extension",
      "bundle_id": "nkbihfbeogaeaoehlefnkodbefgpgknn",
      "active_build": {
        "id": "extension-build-uuid"
      }
    }
  ],
  "count": 1
}

active_build is null when an app has no active build. bundle_id may also be null.

List App Dependencies

List the Chrome extensions attached by default to a web app.

GET /api/v1/apps/{app_id}/dependencies — Returns 200 OK

curl "https://backend.autosana.ai/api/v1/apps/WEB_APP_UUID/dependencies" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "app_id": "web-app-uuid",
  "dependencies": [
    {
      "app": {
        "id": "extension-app-uuid",
        "name": "MetaMask",
        "platform": "chrome-extension",
        "bundle_id": "nkbihfbeogaeaoehlefnkodbefgpgknn",
        "active_build": {
          "id": "extension-build-uuid"
        }
      }
    }
  ],
  "count": 1
}

Attach a Dependency

Attach a Chrome extension app to a web app. Future runs inherit the extension’s active build unless the run request supplies an explicit dependencies override.

POST /api/v1/apps/{app_id}/dependencies — Returns 201 Created

curl -X POST \
  "https://backend.autosana.ai/api/v1/apps/WEB_APP_UUID/dependencies" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dependency_app_id": "EXTENSION_APP_UUID"}'

{
  "app_id": "web-app-uuid",
  "dependency": {
    "app": {
      "id": "extension-app-uuid",
      "name": "MetaMask",
      "platform": "chrome-extension",
      "bundle_id": "nkbihfbeogaeaoehlefnkodbefgpgknn",
      "active_build": {
        "id": "extension-build-uuid"
      }
    }
  }
}

The primary app must have platform web, and the dependency must have platform chrome-extension. Both apps must belong to the API key’s organization.

Detach a Dependency

DELETE /api/v1/apps/{app_id}/dependencies/{dependency_app_id} — Returns 200 OK

curl -X DELETE \
  "https://backend.autosana.ai/api/v1/apps/WEB_APP_UUID/dependencies/EXTENSION_APP_UUID" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "app_id": "web-app-uuid",
  "dependency_app_id": "extension-app-uuid",
  "detached": true
}

Detaching changes future runs only. Historical run results retain the exact extension build UUIDs they used. To override defaults for one run, including running with no extensions, see Run Flows.

Getting Started

Core Features

Guides

Integrations

Uploading Your App

APIs

List Apps

List App Dependencies

Attach a Dependency

Detach a Dependency

​List Apps

​List App Dependencies

​Attach a Dependency

​Detach a Dependency

List Apps

List App Dependencies

Attach a Dependency

Detach a Dependency