---
title: "Request a magic link for registration"
method: POST
path: "/api/v1/auth/register/link"
tags: ["auth"]
---

# Request a magic link for registration

`POST /api/v1/auth/register/link`

Starts a passwordless registration flow by sending a verification link to the given
email address. The recipient clicks the link and is redirected to `redirect_uri` with
a token; pass that token to `/auth/verify_link` to complete registration and obtain
session tokens.

Profile fields (`full_name`, `alias`, `timezone`) are captured now and applied when
the link is verified. Requests are rate-limited per IP (10 per minute) and per
email-IP pair (3 per minute) — exceeding either limit returns HTTP 429. Returns
HTTP 204 on success.

## Request body

- object
  - `alias` string — Display alias (handle) for the new account.
  - `email` string — Email address to send the registration magic link to.
  - `full_name` string — Full name for the new account.
  - `redirect_uri` string — URL the user is redirected to after clicking the registration link. The token is appended as a query parameter.
  - `timezone` string — IANA timezone name for the new account, e.g. `"America/New_York"`.

## Response `204`

No content

## Other responses

- `400` — Missing email
- `422` — Validation failed
- `429` — Rate limited

---

[API](https://skmtc.net/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.net/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/revisions/a8772b442f86/schema)