Skip to content
autom8y

Get Audit Logs

GET
/auth/audit-logs

Query audit logs for a business (admin-only).

Returns audit trail entries for the specified business, optionally filtered by event type.

Args: business_id: Business/tenant UUID event_type: Optional event type filter (e.g., “user.login”, “role.created”) limit: Maximum number of logs to return (default: 100, max: 1000) offset: Pagination offset (default: 0) authorization: Authorization header with admin token db: Database session

Returns: Paginated audit logs with count metadata

Raises: 403: User lacks admin:roles permission 400: Invalid business_id

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
business_id
required
Business Id
string
event_type
Any of:
string
limit
Limit
integer
default: 100
offset
Offset
integer
0

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Response Get Audit Logs Auth Audit Logs Get
object
key
additional properties
any

403

Section titled “403 ”

Forbidden

ErrorResponse

Error response.

object
error
required
Error

Error code

string
message
required
Message

Error message

string

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object