---
title: "Request a new access link"
method: POST
path: "/v3/public/auth/link"
tags: ["Public API"]
---

# Request a new access link

`POST /v3/public/auth/link`

## Request

- Base URL: `https://api.rhinoartisan.com`
- URL: `https://api.rhinoartisan.com/v3/public/auth/link`
- Auth: API key in header `apikey`
- TypeScript: <https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/docs/v3/public/auth/link/post.ts> (a function with typed inputs; its response is checked against the schema)

Sends a new invitation email to an address with a pending invitation, or a password-recovery email to an address with an account. The response is the same in every case (it never says whether the address is known). Rate limited per email (3 / 15 min) and per IP (30 / hour).

## Request body

- object
  - `email` string, email, required

## Response `200`

Request accepted

## Other responses

- `400`: Invalid email
- `429`: Too many requests

## Changes

- **2026-10-02** `82c79770c36b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/public/auth/link/post.md)

---

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