> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Apps API

> List apps and their builds, and manage default Chrome extension dependencies

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](/docs/api-reference.md) for authentication.

## List Apps

> [!NOTE]
>
> **GET** `/api/v1/apps` — Returns `200 OK`

**platform** `string`

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

**bundle\_id** `string`

Optional. Only apps with exactly this bundle ID.

**app\_id** `string`

Optional. Only apps with this `app_id`: a mobile app's custom app ID when it has one, otherwise its bundle ID. This is not the UUID in `id`.

**environment** `string`

Optional. Only apps in the environment with this name. An unknown name returns `400`.

```bash theme={null}
curl "https://backend.usebugradar.com/api/v1/apps?platform=chrome-extension" \
  -H "X-API-Key: YOUR_API_KEY"
```

```json theme={null}
{
  "apps": [
    {
      "id": "extension-app-uuid",
      "name": "MetaMask",
      "platform": "chrome-extension",
      "bundle_id": "nkbihfbeogaeaoehlefnkodbefgpgknn",
      "app_id": "nkbihfbeogaeaoehlefnkodbefgpgknn",
      "ios_keychain_access_group_remapping_enabled": false,
      "active_build": {
        "id": "extension-build-uuid"
      }
    }
  ],
  "count": 1
}
```

`id` is the app's UUID, which the other endpoints on this page take in their
path. `app_id` is the ID you pass as `app_id` when you upload or run: a mobile
app's custom app ID when it has one, otherwise its bundle ID. For a web app it
is the app ID. When a mobile app's `app_id` equals its bundle ID, passing it is
the same as leaving `app_id` out, so it never creates a second app.

`active_build` is `null` when an app has no active build. `bundle_id` and
`app_id` may also be `null`. `ios_keychain_access_group_remapping_enabled` is an app-level iOS
preference for future `.ipa` uploads; it does not indicate whether the active
build was instrumented.

To find the app for one release version, combine the filters, then use the
returned `id` to [list its builds](#list-app-builds):

```bash theme={null}
curl "https://backend.usebugradar.com/api/v1/apps?platform=android&bundle_id=com.example.app&app_id=v7.12.0" \
  -H "X-API-Key: YOUR_API_KEY"
```

## List App Builds

List all of an app's builds, newest first, with the commit and branch each one
was built from. Filter by `commit_sha` or `branch_name` to find a specific build,
then pass its `id` as `app_build_id` when you [run flows](/docs/api-runs.md#run-flows).

> [!NOTE]
>
> **GET** `/api/v1/apps/{app_id}/builds` — Returns `200 OK`

**app\_id** `string` *required*

The app's UUID: the `id` returned by [List Apps](#list-apps), not its `app_id` or bundle ID. Anything else returns `404`.

**commit\_sha** `string`

Optional. A full 40-character commit SHA, or a prefix of at least 7
characters. Matching is case-insensitive.

**branch\_name** `string`

Optional. Exact branch name, such as `main` or `feature/login`. Combine it
with `limit=1` to get the latest build on a branch.

**limit** `integer`

Optional. Return only the newest builds, from `1` to `1000` of them. Leave it
out to get every matching build.

```bash theme={null}
curl "https://backend.usebugradar.com/api/v1/apps/APP_UUID/builds?commit_sha=0123456" \
  -H "X-API-Key: YOUR_API_KEY"
```

```json theme={null}
{
  "app_id": "app-uuid",
  "builds": [
    {
      "id": "build-uuid",
      "commit_sha": "0123456789abcdef0123456789abcdef01234567",
      "branch_name": "main",
      "created_at": "2026-10-05T18:00:00+00:00"
    }
  ],
  "count": 1
}
```

`builds` is empty when nothing matches. When both filters are set, a build
must match both. A commit can have more than one build if it was uploaded
again, so take the first result for the most recent one.
`commit_sha` and `branch_name` are `null` for builds uploaded without git
metadata, and deleted builds are not listed. An invalid `commit_sha` or `limit`
returns `422`.

## List App Dependencies

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

> [!NOTE]
>
> **GET** `/api/v1/apps/{app_id}/dependencies` — Returns `200 OK`

```bash theme={null}
curl "https://backend.usebugradar.com/api/v1/apps/WEB_APP_UUID/dependencies" \
  -H "X-API-Key: YOUR_API_KEY"
```

```json theme={null}
{
  "app_id": "web-app-uuid",
  "dependencies": [
    {
      "app": {
        "id": "extension-app-uuid",
        "name": "MetaMask",
        "platform": "chrome-extension",
        "bundle_id": "nkbihfbeogaeaoehlefnkodbefgpgknn",
        "app_id": "nkbihfbeogaeaoehlefnkodbefgpgknn",
        "ios_keychain_access_group_remapping_enabled": false,
        "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.

> [!NOTE]
>
> **POST** `/api/v1/apps/{app_id}/dependencies` — Returns `201 Created`

```bash theme={null}
curl -X POST \
  "https://backend.usebugradar.com/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"}'
```

```json theme={null}
{
  "app_id": "web-app-uuid",
  "dependency": {
    "app": {
      "id": "extension-app-uuid",
      "name": "MetaMask",
      "platform": "chrome-extension",
      "bundle_id": "nkbihfbeogaeaoehlefnkodbefgpgknn",
      "app_id": "nkbihfbeogaeaoehlefnkodbefgpgknn",
      "ios_keychain_access_group_remapping_enabled": false,
      "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

> [!NOTE]
>
> **DELETE** `/api/v1/apps/{app_id}/dependencies/{dependency_app_id}` — Returns `200 OK`

```bash theme={null}
curl -X DELETE \
  "https://backend.usebugradar.com/api/v1/apps/WEB_APP_UUID/dependencies/EXTENSION_APP_UUID" \
  -H "X-API-Key: YOUR_API_KEY"
```

```json theme={null}
{
  "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](/docs/api-runs.md#run-flows).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.