foliot docs

API reference / Status and identity / Identify the current token

Identify the current token

GET/me

Authenticate with an app API key or a signed-in Foliot Console session.

What the presented token is: an app’s id, or a signed-in person with the workspaces they belong to and their role in each. A closed workspace is listed to its owners alone, with closedAt and purgeAfter. For a person this is current on every call. A person who has been invited is let in first: Foliot checks which addresses they have verified with their sign-in account and joins them to every workspace with a pending invitation for one of them, whatever else they belong to. The check runs from time to time, never on every call, and never fails this call.

Responses

200 Principal Who the bearer token belongs to.
401 Error Missing, malformed or unknown bearer token.
403 Error The token is valid but not permitted on this route.
503 Error A dependency this route needs is unreachable.