Skip to content

Get audit logs

GET
/api/v1/audit-logs
curl --request GET \
--url 'http://127.0.0.1:58259/api/v1/audit-logs?page=0&size=25&action=LOGIN_SUCCESS'

Retrieve paginated audit logs with optional filters. Requires admin.

page
integer format: int32
0

Page number

size
integer format: int32
default: 25

Page size

action
string
Allowed values: LOGIN_SUCCESS LOGIN_FAILED USER_CREATED USER_UPDATED USER_DELETED PASSWORD_CHANGED PERMISSIONS_CHANGED LIBRARY_CREATED LIBRARY_UPDATED LIBRARY_DELETED LIBRARY_SCANNED BOOK_UPLOADED BOOK_DELETED BOOK_SENT METADATA_UPDATED SETTINGS_UPDATED OIDC_CONFIG_CHANGED TASK_EXECUTED SHELF_CREATED SHELF_UPDATED SHELF_DELETED MAGIC_SHELF_CREATED MAGIC_SHELF_UPDATED MAGIC_SHELF_DELETED EMAIL_PROVIDER_CREATED EMAIL_PROVIDER_UPDATED EMAIL_PROVIDER_DELETED OPDS_USER_CREATED OPDS_USER_DELETED OPDS_USER_UPDATED NAMING_PATTERN_CHANGED LOGIN_RATE_LIMITED REFRESH_RATE_LIMITED DUPLICATE_BOOKS_MERGED BOOK_FILE_DETACHED AUTHOR_METADATA_UPDATED AUTHOR_DELETED LOGOUT BACKCHANNEL_LOGOUT OIDC_GROUP_MAPPING_CREATED OIDC_GROUP_MAPPING_UPDATED OIDC_GROUP_MAPPING_DELETED OIDC_CONNECTION_TEST OIDC_FORCE_ONLY_MODE_CHANGED OIDC_LOGIN_SUCCESS OIDC_LOGIN_FAILED OIDC_USER_PROVISIONED OIDC_ACCOUNT_LINKED

Filter by action

userId
integer format: int64

Filter by user ID

username
string

Filter by username

from
string format: date-time

Filter from date

to
string format: date-time

Filter to date

Audit logs returned successfully

Media type */*
object
content
Array<object>
object
id
integer format: int64
userId
integer format: int64
username
string
action
string
Allowed values: LOGIN_SUCCESS LOGIN_FAILED USER_CREATED USER_UPDATED USER_DELETED PASSWORD_CHANGED PERMISSIONS_CHANGED LIBRARY_CREATED LIBRARY_UPDATED LIBRARY_DELETED LIBRARY_SCANNED BOOK_UPLOADED BOOK_DELETED BOOK_SENT METADATA_UPDATED SETTINGS_UPDATED OIDC_CONFIG_CHANGED TASK_EXECUTED SHELF_CREATED SHELF_UPDATED SHELF_DELETED MAGIC_SHELF_CREATED MAGIC_SHELF_UPDATED MAGIC_SHELF_DELETED EMAIL_PROVIDER_CREATED EMAIL_PROVIDER_UPDATED EMAIL_PROVIDER_DELETED OPDS_USER_CREATED OPDS_USER_DELETED OPDS_USER_UPDATED NAMING_PATTERN_CHANGED LOGIN_RATE_LIMITED REFRESH_RATE_LIMITED DUPLICATE_BOOKS_MERGED BOOK_FILE_DETACHED AUTHOR_METADATA_UPDATED AUTHOR_DELETED LOGOUT BACKCHANNEL_LOGOUT OIDC_GROUP_MAPPING_CREATED OIDC_GROUP_MAPPING_UPDATED OIDC_GROUP_MAPPING_DELETED OIDC_CONNECTION_TEST OIDC_FORCE_ONLY_MODE_CHANGED OIDC_LOGIN_SUCCESS OIDC_LOGIN_FAILED OIDC_USER_PROVISIONED OIDC_ACCOUNT_LINKED
entityType
string
entityId
integer format: int64
description
string
ipAddress
string
countryCode
string
createdAt
string format: date-time
page
object
size
integer format: int64
number
integer format: int64
totalElements
integer format: int64
totalPages
integer format: int64