---
title: "Embed Viewer"
method: GET
path: "/v1/embeds"
tags: ["Document Embedding"]
---

# Embed Viewer

`GET /v1/embeds`

Display an embed within an iframe. If no embed id was included when creating the token, the iframe first displays a document picker where the user can create and configure a new embed. If an embed id was included, the iframe displays either an embedded document viewer, an embedded editor, or an embed configuration page depending on the token request body and embed settings.

## Query parameters

- `token` string, required

## Response `200`

The iframe content displaying the embedded document picker or viewer.

## Other responses

- `401` — Unauthorized. The token is missing or invalid.
- `403` — Forbidden. The access to the embed is forbidden.
- `404` — Not Found. The embed id is not found.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)