# 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": "…"}'
```