Get current user information

Returns the authenticated user along with every organization they belong to and their roles in each.

GET /whoami

Get current user information

cURL

curl --request GET \
  --url https://albus.sh/api/whoami \
  --header 'Authorization: Bearer <token>'

200

{
  "user_id": "user_123",
  "email": "[e-mail]",
  "organizations": [
    {
      "id": "42",
      "name": "Acme Corp",
      "roles": [
        "admin"
      ]
    }
  ],
  "name": "John Doe",
  "roles": [
    "admin"
  ],
  "active_organization": {
    "id": "42",
    "name": "Acme Corp",
    "roles": [
      "admin"
    ]
  },
  "issued_at": 123,
  "expires_at": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200

application/json

User information retrieved successfully

user_id · string · required

Unique user identifier

Example:

"user_123"

email · string<email> · required

User's email address

Example:

"[e-mail]"

organizations · object[] · required

Every organization the user belongs to, with their roles.

Show child attributes

name · string

User's display name

Example:

"John Doe"

roles · string[]

Roles in the active organization (present only when a single organization is in scope).

Example:

["admin"]

active_organization · object

The organization this session is scoped to. Present when the user belongs to exactly one organization; absent when they belong to several and none is selected yet.

Show child attributes

issued_at · integer<int64>

Token issue timestamp (Unix epoch)

expires_at · integer<int64>

Token expiration timestamp (Unix epoch)