---
title: "Create Embed"
method: POST
path: "/v1/embeds"
tags: ["embeds"]
---

# Create Embed

`POST /v1/embeds`

## Request

- Base URL: `https://api.usekeel.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.usekeel.io/v1/embeds`
- Auth: none declared

Mint a short-lived signed embed URL for a resource the org owns.

Same authorization bucket as share-link creation (``sharing.create``) —
an embed URL is a time-boxed share capability.

## Headers

- `Authorization` string, nullable
- `X-Org-Id` string, nullable

## Request body

- CreateEmbedRequest
  - `resource_type` string, required
  - `resource_id` string, required
  - `ttl_seconds` integer, nullable

## Response `201`

Successful Response

- EmbedResponse
  - `embed_id` string, required
  - `embed_token` string, required
  - `embed_url` string, required
  - `expires_at` string, required
  - `resource_type` string, required
  - `resource_id` string, required

## Other responses

- `422`: Validation Error

---

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