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

# List Audit Events



## OpenAPI

````yaml https://api.notte.cc/openapi.json get /audit-events
openapi: 3.1.0
info:
  title: Notte API
  description: >-
    Notte API is a REST API that allows you to interact with Notte. It is used
    to create cloud browser sessions, scrape webpages, and run web ai agents to
    act on your behalf on the internet.
  version: 1.9.6
  x-logo:
    url: https://www.notte.cc/images/logo/logo-white.png
servers: []
security: []
tags:
  - name: agents
    description: Web AI agents (start, stop, status, replay, etc.)
  - name: sessions
    description: Session management (start, stop, status, etc.)
  - name: debug
    description: Session debugging tools (replay,logs, recording, etc.)
  - name: page
    description: Page operations withing a session (observe, step, scrape, etc.)
  - name: storage
    description: File storage interface (upload, download, list, etc.)
  - name: network
    description: Network requests/responses withing a session (intercept, etc.)
  - name: vaults
    description: >-
      Vault & Credentials management (create/delete vaults, create/delete
      credentials, etc.)
  - name: personas
    description: Persona management (create, delete, list emails, list sms, etc.)
  - name: scrape
    description: >-
      Webpage scraping (scrape, screenshot, etc.) with automatic session
      management.
  - name: health
    description: Health check endpoint.
  - name: usage
    description: Usage logs (usage, logs, etc.)
  - name: audit
    description: Audit trail of account and workspace changes.
  - name: functions
    description: Functions management (create, delete, list, etc.)
paths:
  /audit-events:
    get:
      tags:
        - audit
      summary: List Audit Events
      operationId: list_audit_events
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Events per page
            default: 50
            title: Limit
          description: Events per page
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: '`next_cursor` from the previous page'
            title: Cursor
          description: '`next_cursor` from the previous page'
        - name: since
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: Only events at or after this time (ISO-8601)
            title: Since
          description: Only events at or after this time (ISO-8601)
        - name: until
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: Only events before this time (ISO-8601)
            title: Until
          description: Only events before this time (ISO-8601)
        - name: action
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Only events with this action, e.g. `created`
            title: Action
          description: Only events with this action, e.g. `created`
        - name: entity_type
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Only events about this kind of resource, e.g. `api_key`
            title: Entity Type
          description: Only events about this kind of resource, e.g. `api_key`
        - name: actor_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Only events performed by this user
            title: Actor Id
          description: Only events performed by this user
        - name: x-notte-request-origin
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Notte-Request-Origin
        - name: x-notte-sdk-version
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Notte-Sdk-Version
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuditEventListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - OAuth2PasswordBearer: []
      x-codeSamples: []
components:
  schemas:
    AuditEventListResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/AuditEvent'
          type: array
          title: Items
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
          description: >-
            Opaque cursor for the next (older) page. Null when there are no more
            events.
        has_more:
          type: boolean
          title: Has More
      type: object
      required:
        - items
        - has_more
      title: AuditEventListResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AuditEvent:
      properties:
        id:
          type: integer
          title: Id
        created_at:
          type: string
          format: date-time
          title: Created At
        entity_type:
          type: string
          title: Entity Type
        entity_id:
          type: string
          title: Entity Id
        action:
          type: string
          title: Action
        user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: User Id
        actor_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Actor Id
        actor_type:
          type: string
          title: Actor Type
        actor_email:
          anyOf:
            - type: string
            - type: 'null'
          title: Actor Email
          description: >-
            Email of the actor when it is a workspace member the caller may see.
            Null for system actors.
        actor_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Actor Name
        resource_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Resource Name
          description: >-
            Human-readable name of the resource (an API key's label, a secret's
            name, a member's email) when one is known. Never a secret value.
        source:
          type: string
          title: Source
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
        org_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Org Id
      type: object
      required:
        - id
        - created_at
        - entity_type
        - entity_id
        - action
        - actor_type
        - source
      title: AuditEvent
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: token

````

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