Documentation · API reference
GET
/api/v1/meWho you are
This page as Markdown, or in an AI chatMore ways to read this page
Who is asking: the member signed in or whose token this is, and the accounts they are in.
# Who you are
> tidekeeper's API reference: https://tidekeeper.eu/docs/api/get-me
`GET /api/v1/me`
Who is asking: the member signed in or whose token this is, and the accounts they are in.
## The answer
200, `Me`
- `account_id` (string, needed)
- `account_name` (string, needed)
- `accounts` (list of MeAccount): Every account they are in. One is the account this answer is about; a person in one account has one here.
- `email` (string, needed)
- `features` (FeatureSet, needed)
- `invite_needed` (boolean): Another account of theirs needs an invite code (doc/invites.md).
- `may` (list of string): What this request may do: `read`, `events`, `manage`, `visitors`, `own`. A page hides what would be refused.
- `name` (string): What they are called. Empty until they say.
- `operator` (boolean): Whoever runs this tidekeeper: the operator's console is theirs.
- `role` (string, needed)
- `second_step_missing` (boolean): The account's owner asked that every member has a second step at sign-in, and this member has not set one up.
- `some_sites` (boolean): Given some of the account's sites, not all.
- `user_id` (string, needed)
## Asking
```sh
curl https://tidekeeper.eu/api/v1/me \
-H "Authorization: Bearer $TIDEKEEPER_TOKEN"
```
The answer
Status 200
Me
- account_id
- stringneeded
- account_name
- stringneeded
- accounts
- list of MeAccountEvery account they are in. One is the account this answer is about; a person in one account has one here.
- stringneeded
- features
- FeatureSetneeded
- invite_needed
- booleanAnother account of theirs needs an invite code (doc/invites.md).
- may
- list of stringWhat this request may do: `read`, `events`, `manage`, `visitors`, `own`. A page hides what would be refused.
- name
- stringWhat they are called. Empty until they say.
- operator
- booleanWhoever runs this tidekeeper: the operator's console is theirs.
- role
- stringneeded
- second_step_missing
- booleanThe account's owner asked that every member has a second step at sign-in, and this member has not set one up.
- some_sites
- booleanGiven some of the account's sites, not all.
- user_id
- stringneeded
Asking
curl https://tidekeeper.eu/api/v1/me \ -H "Authorization: Bearer $TIDEKEEPER_TOKEN"
const answer = await fetch("https://tidekeeper.eu/api/v1/me", { headers: { Authorization: `Bearer ${process.env.TIDEKEEPER_TOKEN}`, }, }).then((r) => r.json());