> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowengineering.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List workspace-wide admin audit log entries

> User administration (members joining and leaving, role and project-access changes) and organization review-policy changes, newest first. Requires an admin with access to every project. Page with `cursor` from `0`, passing back `nextCursor` until `moreAvailable` is false. To poll for new entries, pass `since` and deduplicate by `id`.



## OpenAPI

````yaml /openapi/customer-api.json get /audit-log
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Flow customer API reference. Start with the [quickstart](/api/quickstart)
    and [authentication guide](/api/authentication).
  title: Customer API
  version: 1.0.0
servers:
  - description: Flow API
    url: '{baseUrl}'
    variables:
      baseUrl:
        default: https://backend.branch.flowengineering.com
security: []
tags:
  - name: Audit
  - name: Automations
  - name: Branches
  - name: Comments
  - name: Convert
  - name: Data Model
  - name: Diagrams
  - name: Entities
  - name: Events
  - name: Files
  - name: Import
  - name: Notifications
  - name: Persistent agents
  - name: Projects
  - name: ReqIF
  - name: ReqIF Import
  - name: Review policy
  - name: Shared Access Grants
  - name: User Groups
  - name: Users
paths:
  /audit-log:
    get:
      tags:
        - Audit
      summary: List workspace-wide admin audit log entries
      description: >-
        User administration (members joining and leaving, role and
        project-access changes) and organization review-policy changes, newest
        first. Requires an admin with access to every project. Page with
        `cursor` from `0`, passing back `nextCursor` until `moreAvailable` is
        false. To poll for new entries, pass `since` and deduplicate by `id`.
      operationId: WorkspaceAuditController_list
      parameters:
        - in: query
          name: limit
          required: false
          schema:
            default: 50
            maximum: 200
            minimum: 1
            type: number
        - description: Keyset cursor. Use 0 for the first page, then pass back nextCursor.
          in: query
          name: cursor
          required: false
          schema:
            default: '0'
            type: string
        - in: query
          name: search
          required: false
          schema:
            maxLength: 200
            type: string
        - description: >-
            Only entries created at or after this time, as an RFC 3339 date-time
            with a time zone (e.g. 2026-10-01T00:00:00Z). Composes with cursor
            paging and search.
          in: query
          name: since
          required: false
          schema:
            format: date-time
            type: string
        - description: Workspace identifier
          in: header
          name: customer
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminAuditLogPageDto'
          description: ''
      security:
        - api-key: []
        - bearer: []
components:
  schemas:
    AdminAuditLogPageDto:
      properties:
        entries:
          items:
            $ref: '#/components/schemas/AdminAuditLogEntryDto'
          type: array
        limit:
          type: number
        moreAvailable:
          type: boolean
        nextCursor:
          type: string
        offset:
          type: number
        total:
          type: number
      required:
        - entries
        - limit
      type: object
    AdminAuditLogEntryDto:
      properties:
        action:
          enum:
            - category.create
            - category.rename
            - category.config_update
            - category.delete
            - category.reorder
            - field.add
            - field.update
            - field.default_formula_reapply
            - field.remove
            - field.reorder
            - view.create
            - view.rename
            - view.update
            - view.delete
            - view.reorder
            - baseline.create
            - baseline.rename
            - project.ai_model_update
            - review_policy.update
            - template.create
            - template.rename
            - template.update
            - template.delete
            - template.reorder
            - automation.create
            - automation.update
            - automation.delete
            - automation.reorder
            - automation.claim
            - flow_md.update
            - skill.create
            - skill.update
            - skill.delete
            - skill.reorder
            - skill_folder.create
            - skill_folder.update
            - skill_folder.delete
            - skill_folder.reorder
            - agent.create
            - agent.archive
            - user.access_granted
            - user.role_change
            - user.project_access_update
            - user.access_removed
          type: string
        actorAgentId:
          nullable: true
          type: string
        actorEmail:
          nullable: true
          type: string
        actorUserId:
          nullable: true
          type: string
        createdAt:
          type: string
        detail:
          additionalProperties: true
          nullable: true
          type: object
        id:
          type: string
        resourceId:
          nullable: true
          type: string
        resourceName:
          nullable: true
          type: string
        resourceType:
          enum:
            - data_model
            - view
            - baseline
            - project
            - template
            - automation
            - flow_md
            - skill
            - user
            - review_policy
            - agent
          type: string
        revertible:
          type: boolean
        summary:
          type: string
      required:
        - id
        - action
        - resourceType
        - summary
        - createdAt
        - revertible
      type: object
  securitySchemes:
    api-key:
      in: header
      name: X-API-Key
      type: apiKey
    bearer:
      bearerFormat: JWT
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.