Skip to main content

Get the authenticated account

GET 
/api/v1/me

Returns the account the token belongs to, its plan, the scopes the token carries, and the profiles it can act on.

Requires no scope — any valid token may call it, so a client can discover what it is allowed to do before attempting it. Never returns the token itself, only its prefix.

profiles is the set of subjects this token may address. Each entry's username is what goes in the {handle} segment of every resource endpoint. The list is empty for an account that has not finished setup and so has no username yet.

The literal handle me resolves while exactly one profile is listed. With more than one, resource endpoints answer 400 ambiguous_subject to me and the username must be named — so a client that reads this list and uses the username never has to change.

Request​

Responses​

The authenticated account