---
title: "Create magic link for workspace authentication"
method: POST
path: "/v1/workspace/client/magic-link"
tags: ["Authentication"]
---

# Create magic link for workspace authentication

`POST /v1/workspace/client/magic-link`

## Request

- Base URL: `https://api.lindo.ai`
- URL: `https://api.lindo.ai/v1/workspace/client/magic-link`
- Auth: HTTP bearer

Generates a magic link and verification code for passwordless authentication in a workspace

## Request body

- MagicLinkCreateRequest
  - `email` string, email, required: Email address to send magic link to

## Response `200`

Magic link created successfully

- MagicLinkCreateResponse
  - `success` true, required: Indicates the operation was successful
  - `result` MagicLinkCreateResult, required
    - `email` string, email, required: Email address the magic link was sent to
    - `magic_link` string, uri, required: The generated magic link URL for authentication
    - `expires_in` string, required: Time until the magic link expires
    - `created_date` string, required: Date when the magic link was created

## Other responses

- `400`: Bad request - validation error
- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - user does not have access to this workspace
- `404`: Not found - workspace not found

---

[API](https://skmtc.dev/lindo/apis/lindo-unified-api.md) · [All operations](https://skmtc.dev/lindo/apis/lindo-unified-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lindo/apis/lindo-unified-api/revisions/2672f34525a4?raw)