---
title: "Request Magic Link"
method: POST
path: "/v1/session/magic-link"
tags: ["session"]
---

# Request Magic Link

`POST /v1/session/magic-link`

## Request

- Base URL: `https://app.teetra.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.teetra.com/v1/session/magic-link`
- Auth: none declared

Issue a magic link and deliver it out-of-band. The token is NOT returned.

## Request body

- MagicLinkRequest
  - `subject_id` string, required
  - `principal_kind` string: 'consumer' or 'producer'
  - `email` string, nullable: Optional explicit email delivery target
  - `renewal_path` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/teetra/apis/warrant.md) · [All operations](https://skmtc.dev/teetra/apis/warrant/llms.txt) · [OpenAPI document](https://skmtc.dev/teetra/apis/warrant/revisions/a33505db716f?raw)