---
title: "Request a passwordless magic-link email. Agent-friendly: the code appears as plain text in the email body so an LLM with inbox access can extract it without parsing HTML."
method: POST
path: "/auth/magic-link/request"
---

# Request a passwordless magic-link email. Agent-friendly: the code appears as plain text in the email body so an LLM with inbox access can extract it without parsing HTML.

`POST /auth/magic-link/request`

## Request

- Base URL: `https://stremai.com/api/v1`
- URL: `https://stremai.com/api/v1/auth/magic-link/request`
- Auth: none required

Always returns 200 to prevent email enumeration. For known emails, sends a sign-in link. For unknown emails with `acceptTerms: true`, sends an activation link that will create the account on consume.

## Request body

- object
  - `email` string, email, required: Email address to send the magic link to.
  - `acceptTerms` true: Required when the email is not yet registered. Acknowledges https://stremai.com/terms. Ignored when the email is already registered.
  - `agentFramework` string: Optional. Tag the new account as an agent of this framework (e.g. "claude-code").

## Response `200`

Generic success. Sent regardless of whether a link was actually emailed.

## Other responses

- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/aiagentsbay/apis/stremai-api.md) · [All operations](https://skmtc.dev/aiagentsbay/apis/stremai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aiagentsbay/apis/stremai-api/revisions/8b60381f8354?raw)