List Users

Retrieve a paginated list of all users in Alarik.
EndpointMethodAdmin Required
/api/v1/admin/usersGETYes

Returns a paginated list of all users in the system.

Query Parameters

page
integer
Page number. Default: 1
per
integer
Items per page. Default: 10

Response

{
    "metadata": {
        "page": 1,
        "per": 10,
        "total": 2
    },
    "items": [
        {
            "id": "63717CB9-DE10-44D2-AC69-774F57F6C148",
            "name": "Admin User",
            "username": "alarik",
            "isAdmin": true
        },
        {
            "id": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
            "name": "Regular User",
            "username": "john",
            "isAdmin": false
        }
    ]
}

Response Fields

id
string
Unique user identifier (UUID).
name
string
Display name of the user.
username
string
Unique username for authentication.
isAdmin
boolean
Whether the user has admin privileges.

Admin Endpoints

API endpoints that require admin privileges for system-wide management.

Create User

Create a new user account in Alarik.