Get the authenticated user

GET/user

Returns the authenticated caller's own user record. Unlike the gist list endpoints this is a fully-private resource with no public form, so a token lacking the scope gets 403 rather than a reduced response.

Request

Headers

Name	Type	Scopes
Authorizationrequired	string	user:read

Responses

Status	Body	Description
200	PrivateUser	The authenticated user.
401	Error	Missing or invalid credentials.
403	Error	The token lacks the required scope or permission.

Request

curl -X GET \
  --url "https://opengist.example.com/api/user" \
  -H "Authorization: Bearer og_xxxxxxxx"

Response 200

{
  "id": 1,
  "login": "string",
  "username": "string",
  "avatar_url": "https://opengist.example/...",
  "type": "string",
  "created_at": "2024-01-01T00:00:00Z",
  "email": "string"
}