---
title: "Request a magic link for share access."
method: POST
path: "/v1/shares/{share_id}/magic_link/request/"
---

# Request a magic link for share access.

`POST /v1/shares/{share_id}/magic_link/request/`

## Request

- Base URL: `https://app.iconik.io/API/assets`
- URL: `https://app.iconik.io/API/assets/v1/shares/{share_id}/magic_link/request/`
- Auth: none declared
- TypeScript: <https://skmtc.dev/iconik/apis/iconik-assets/docs/v1/shares/:share_id/magic_link/request/post.ts> (a function with typed inputs; its response is checked against the schema)

<br/>Creates a ShareUser and generates a magic link token for the recipient.

## Path parameters

- `share_id` string, required

## Request body

- MagicLinkRequestSchema
  - `email` string, email, required

## Response `200`

Magic link sent successfully

- object
  - `expires_in_minutes` integer
  - `message` string

## Other responses

- `400`: Bad request
- `404`: Share not found
- `429`: Rate limit exceeded
- `default`: Error response

---

[API](https://skmtc.dev/iconik/apis/iconik-assets.md) - [All operations](https://skmtc.dev/iconik/apis/iconik-assets/llms.txt) - [OpenAPI document](https://skmtc.dev/iconik/apis/iconik-assets/revisions/62580d9e640e?raw)