---
title: "Create a share link"
method: POST
path: "/presentations/{id}/shares"
---

# Create a share link

`POST /presentations/{id}/shares`

## Request

- Base URL: `https://lumdeck.com/api/v1`
- URL: `https://lumdeck.com/api/v1/presentations/{id}/shares`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `kind` 'link' | 'password' | 'email_gate'
  - `password` string
  - `label` string
  - `expiresAt` string, date-time, nullable
  - `maxViews` integer, nullable
  - `allowDownload` boolean
  - `embedOrigins` string[]: Pro and Team. Origins allowed to embed the link, such as https://client.com.

## Response `201`

Created

- object
  - `share` Share
    - `id` string
    - `kind` 'link' | 'password' | 'email_gate'
    - `url` string, uri
    - `label` string, nullable
    - `expiresAt` string, date-time, nullable
    - `viewCount` integer
    - `embedOrigins` string[]: Websites allowed to embed this link. Empty means the page cannot be framed. Pro and Team.
    - `status` string
    - `createdAt` string, date-time

## Other responses

- `400`: Error
- `401`: Missing, unknown, revoked or expired API key
- `403`: The key lacks the scope, or its creator lacks the role
- `404`: Not found in this workspace
- `429`: Per-key request limit or daily publish quota reached

---

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