---
title: "Create deck share"
method: POST
path: "/v1/decks/{deck_id}/share"
tags: ["Sharing"]
---

# Create deck share

`POST /v1/decks/{deck_id}/share`

## Request

- Base URL: `https://api.slides.com`
- URL: `https://api.slides.com/v1/decks/{deck_id}/share`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://slides.com/oauth/authorize`, token URL `https://slides.com/oauth/token`, scopes: `manage`)

Creates a private share link for an owned private or team-visible deck.

## Path parameters

- `deck_id` union, required
  - string
  - integer

## Request body

- object
  - `name` string: Name identifying the private share link.
  - `password` string: Password recipients must enter before viewing the deck through this link.
  - `expires_at` string, date-time, nullable: ISO 8601 timestamp after which the private share link expires.
  - `notify_on_view` boolean: Whether to notify the deck owner when the deck is first viewed through this link.

## Response `201`

Returns the new private share link with default and fullscreen URLs. Passwords are never returned. Each deck is limited to 100 private share links.

- ApiResponse
  - `data` unknown, required
  - `meta` object

## Other responses

- `401`: A valid API key or OAuth access token is required.
- `403`: The credential or account cannot perform this operation.
- `404`: The requested resource was not found.
- `422`: The request parameters or body are invalid.
- `429`: The request rate limit was exceeded.

---

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