---
title: "List Audit Log"
method: GET
path: "/api/v1/authz/audit/"
tags: ["Authorization"]
---

# List Audit Log

`GET /api/v1/authz/audit/`

Return a paginated slice of the audit log filtered by the given query params.

Superuser only. The composite indexes on ``(user_id, timestamp)`` and
``(resource_type, resource_id)`` keep both "show me events for user X"
and "show me events on resource Y" fast at scale.

## Query parameters

- `user_id` string, uuid, nullable — Filter by acting user id.
- `resource_type` string, nullable — Filter by resource type slug, e.g. ``flow`` or ``deployment``.
- `resource_id` string, uuid, nullable — Filter by resource UUID.
- `action` string, nullable — Filter by action string, e.g. ``flow:read`` or ``share:create``.
- `result` string, nullable — Filter by decision result (``allow`` / ``deny`` / ``owner_override``).
- `since` string, date-time, nullable — Inclusive lower bound on ``timestamp``.
- `until` string, date-time, nullable — Exclusive upper bound on ``timestamp``.
- `page` integer
- `size` integer

## Response `200`

Successful Response

- AuthzAuditPage — Paginated audit-log response.
  - `items` AuthzAuditLogRead[], required
    - `action` string, required
    - `details` object, nullable, required
    - `id` string, uuid, required
    - `resource_id` string, uuid, nullable, required
    - `resource_type` string, nullable, required
    - `result` string, required
    - `timestamp` string, date-time, required
    - `user_id` string, uuid, nullable, required
  - `page` integer, required
  - `pages` integer, required
  - `size` integer, required
  - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langflow-ai/apis/langflow.md) · [All operations](https://skmtc.net/langflow-ai/apis/langflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langflow-ai/langflow/versions/22962dc5e81b/schema)