Skip to content

Get the signed-in person

getMe

GET /api/v1/me

Scope: profileRate cost: 1

Who the token acts as

The same body as GET /api/me, which stays.

Terminal window
curl "$FOLDR/api/v1/me" \
-H "Authorization: Bearer $TOKEN"

$FOLDR is your site’s address (for example https://files.example.com) and $TOKEN is an access token. See Getting access.

StatusMeaningBody
200The Me.application/json: Me

Me:

FieldTypeDescription
namestringRequired. Display name, or the username where there is none.
emailstring or nullRequired. Email address, where the directory has one.
usernamestringRequired. Sign-in name.

Example:

{
"name": "string",
"email": "string",
"username": "string"
}

Every error is an application/problem+json document (ProblemDetails); branch on its type or code. See Errors.

StatusProblem typesWhen
400invalid-requestInvalid request (invalid-request).
401invalid-tokenInvalid token (invalid-token).
403insufficient-scopeInsufficient scope (insufficient-scope).
429rate-limitedToo many requests (rate-limited).
500internal-errorInternal error (internal-error).