A new address to sign in with (doc/launch.md

This page as Markdown, or in an AI chatMore ways to read this page

A new address to sign in with (doc/launch.md, 2.5): a link goes to it, and nothing changes until the link is opened. Only the person, signed in themselves: a token cannot move where a person's mail goes.

# A new address to sign in with (doc/launch.md

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/post-me-email

`POST /api/v1/me/email`

A new address to sign in with (doc/launch.md, 2.5): a link goes to it, and nothing changes until the link is opened. Only the person, signed in themselves: a token cannot move where a person's mail goes.

## What to send

`EmailChange`: A new address to sign in with: a link goes to it, and the change is made when it is opened (doc/launch.md, 2.5).

- `email` (string, needed)

## The answer

202, `Sent`: The same answer whoever asked and whatever was found: a page that sends a link cannot be used to learn who has an account.

- `again_in` (integer, needed): How long before another can be asked for, in seconds.
- `minutes` (integer, needed): How long the link works, in minutes.
- `sent` (boolean, needed)

## Asking

```sh
curl -X POST https://tidekeeper.eu/api/v1/me/email \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"email": "…"}'
```

What to send

EmailChange A new address to sign in with: a link goes to it, and the change is made when it is opened (doc/launch.md, 2.5).

email: stringneeded

The answer

Status 202

Sent The same answer whoever asked and whatever was found: a page that sends a link cannot be used to learn who has an account.

again_in: integerneededHow long before another can be asked for, in seconds.
minutes: integerneededHow long the link works, in minutes.
sent: booleanneeded

Asking

curlJavaScript

With your token from Settings

curl -X POST https://tidekeeper.eu/api/v1/me/email \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"email": "…"}'

With your token from Settings

const answer = await fetch("https://tidekeeper.eu/api/v1/me/email", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TIDEKEEPER_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"email": "…"}),
}).then((r) => r.json());