---
title: "List embed links the caller can manage"
method: GET
path: "/api/v1/embed-links"
tags: ["Embed Links"]
---

# List embed links the caller can manage

`GET /api/v1/embed-links`

## Request

- Base URL: `https://api-docs.busabase.com`
- URL: `https://api-docs.busabase.com/api/v1/embed-links`
- Auth: HTTP bearer

## Query parameters

- `type` 'node' | 'change-request' | 'record-detail': Which kind of target the links point at. Omitting it returns links of every kind.
- `typeId` string: The target's id, interpreted according to `type`.

## Response `200`

Embed link metadata without capability secrets.

- object[]
  - `id` string, required
  - `type` 'node' | 'change-request' | 'record-detail', required
  - `typeId` string, required
  - `targetName` string, required
  - `nodeType` 'base' | 'doc' | 'file' | 'drive' | 'skill' | 'folder' | 'airapp', required
  - `createdAt` string, date-time, required
  - `expiresAt` string, date-time, required
  - `revokedAt` string, date-time, required
  - `active` boolean, required
  - `framePolicy` object, required
    - `mode` 'anywhere' | 'origins' | 'top-level-only', required
    - `allowedOrigins` string[], required

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404

---

[API](https://skmtc.dev/busabase/apis/busabase-api.md) · [All operations](https://skmtc.dev/busabase/apis/busabase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/busabase/apis/busabase-api/revisions/bc6a7d5ff4c1?raw)