---
title: "Request a one-use sign-in link"
method: POST
path: "/v1/auth/magic"
---

# Request a one-use sign-in link

`POST /v1/auth/magic`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/auth/magic`
- Auth: none required

## Request body

- MagicLinkRequest
  - `email` string, required
  - `ref` string, nullable

## Response `200`

Accepted

- object
  - `data` object, required
    - `accepted` true, required

## Other responses

- `default`: Error envelope

---

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