# Share a deck

> Sending a deck outside MakoDeck: a link for each person, and how an agent asks for one.

- A share link shows one deck, made for one person with no account, until it expires or is revoked. It always shows the deck's current copy, so a fix reaches links already sent.
- The person makes links on the deck's page with **Share**. MakoDeck never emails the recipient: the person sends the link themselves.
- The person sees when each link is opened, by how many viewers, and how long each slide was viewed; the privacy policy linked from the recipient's page says so.

## Ask for a link

Only when the person asked you to send that deck to that recipient: `create_share_link` with `deck_id` and `recipient` (the person's own label for them, never shown to the recipient). With a token: `POST https://makodeck.com/api/v1/decks/<deck_id>/share-links`, an `Idempotency-Key` header and `recipient` as JSON.

- `pending`, the usual: the link shows nothing until the person activates it. Give them `activate_url`: it opens the deck's Share dialog on the link, where **Activate** turns it on and shows the address to send.
- `active`: give the person `url`. Only a personal API token with the **Share links** scope, which a workspace's owners and admins give, makes one. A connector in an AI app never does.
- No such tool, `sharing_disabled` or `sharing_not_allowed`: you can't ask for a link here. `plan_limit`: the person's free account has all the live links it allows (`limit`); they revoke one first. Any other refusal's message says what to do.

With the **Link totals** scope, `list_share_links` reads each link's totals, never its address. You can't activate, extend or revoke links, and you never send one: those are the person's, on the deck's page.