Skip to content

List users

GET
/api/v1/users

Returns the ADMIN-visible user catalog with zero-based pagination.

page
string
default: 0

Zero-based page number.

size
string
default: 50 >= 1 <= 200

Requested page size, clamped to the range 1 through 200.

Users returned

Zero-based page of resource results.

object
content

Results in this page.

Array<object>

Public user administration record. Password hashes and credentials are never exposed.

object
createdAt

Creation timestamp in UTC.

string format: date-time
enabled

Whether the account may authenticate.

boolean
id

User identifier.

string format: uuid
role

Global authorization role.

string
Allowed values: ADMIN OPERATOR VIEWER
updatedAt

Last update timestamp in UTC.

string format: date-time
username

Current username.

string
page

Zero-based page number.

integer format: int32
size

Effective page size, from 1 through 200.

integer format: int32
>= 1 <= 200
totalElements

Total matching resources across all pages.

integer format: int64

The request is malformed or fails validation.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object
detail
string
instance
string format: uri-reference
status
integer format: int32
title
string
type
string format: uri-reference

Authentication is required or credentials are invalid.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object
detail
string
instance
string format: uri-reference
status
integer format: int32
title
string
type
string format: uri-reference

The authenticated identity lacks the required permission.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object
detail
string
instance
string format: uri-reference
status
integer format: int32
title
string
type
string format: uri-reference