---
title: "List App Embeds"
method: GET
path: "/api/v1/apps/{app_id}/embeds"
tags: ["apps"]
---

# List App Embeds

`GET /api/v1/apps/{app_id}/embeds`

List the apps embedded in this host. VIEWER on the host is enough —
holding a grant on each child is exactly what the embed binding replaces.

`embed_host_app_id` lets a middle app (itself embedded in an outer host)
resolve its own embeds without the caller holding a direct grant on it —
see the module docstring.

## Path parameters

- `app_id` string, uuid, required

## Query parameters

- `embed_host_app_id` string, uuid, nullable

## Response `200`

Successful Response

- AppEmbedList
  - `embeds` AppEmbedRead[], required
    - `binding_id` string, uuid, required
    - `label` string, required
    - `child_app_id` string, uuid, required
    - `child_name` string, required
    - `declared_inputs` EmbedInputDeclaration[]
      - `name` string, required
      - `type` 'string' | 'number' | 'boolean', required
      - `required` boolean
      - `description` string
    - `bundle_css` string, nullable
    - `ready` boolean, required
    - `unavailable_reason` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/revisions/8de9cb14f744/schema)