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

# Get apiaudittrailv1auditevents



## OpenAPI

````yaml /api-specs/6.3/public-api.json get /api/audittrail/v1/auditevents
openapi: 3.0.3
info:
  title: Domino Public API
  description: Reference for Domino's public REST API endpoints.
  version: 6.3.0
  x-catalog-key: nucleus
servers:
  - url: https://mycluster.domino.tech
    description: >-
      Replace 'mycluster.domino.tech' with your Domino cluster hostname. For
      Domino Cloud customers, that is `your-subdomain`.domino.tech (e.g.,
      acme.domino.tech). For self-hosted deployments, it is the hostname you
      reach the Domino UI at.
security: []
tags:
  - name: AIGateway
    x-displayName: AIGateway
  - name: AppInstances
    x-displayName: AppInstances
  - name: AppVersions
    x-displayName: AppVersions
  - name: Apps
    x-displayName: Apps
  - name: AsyncPredictions
    x-displayName: AsyncPredictions
  - name: AuditTrail
    x-displayName: AuditTrail
  - name: BillingTag
    x-displayName: BillingTag
  - name: BillingTagSettings
    x-displayName: BillingTagSettings
  - name: Cost
    x-displayName: Cost
  - name: CustomMetrics
    x-displayName: CustomMetrics
  - name: DataSource
    x-displayName: DataSource
  - name: DatasetRw
    x-displayName: DatasetRw
  - name: DeploymentTargets
    x-displayName: DeploymentTargets
  - name: Environments
    x-displayName: Environments
  - name: Extensions
    x-displayName: Extensions
  - name: GenAI
    x-displayName: GenAI
  - name: HPC Jobs
    x-displayName: HPC Jobs
  - name: HardwareTier
    x-displayName: HardwareTier
  - name: Jobs
    x-displayName: Jobs
  - name: ModelAPI
    x-displayName: ModelAPI
  - name: ModelAPIVersion
    x-displayName: ModelAPIVersion
  - name: ModelDeployment
    x-displayName: ModelDeployment
  - name: Organizations
    x-displayName: Organizations
  - name: PPM
    x-displayName: PPM
  - name: PersonalAccessToken
    x-displayName: PersonalAccessToken
  - name: ProjectSharedDatasets
    x-displayName: ProjectSharedDatasets
  - name: ProjectTemplates
    x-displayName: ProjectTemplates
  - name: Projects
    x-displayName: Projects
  - name: ProjectsCommits
    x-displayName: ProjectsCommits
  - name: ProjectsFiles
    x-displayName: ProjectsFiles
  - name: RegisteredModels
    x-displayName: RegisteredModels
  - name: ServiceAccounts
    x-displayName: ServiceAccounts
  - name: Users
    x-displayName: Users
  - name: Workspaces
    x-displayName: Workspaces
  - name: nucleus_other
    x-displayName: other
  - name: PersonalAccessTokenAdmin
    x-displayName: PersonalAccessTokenAdmin
  - name: Git Credentials
    x-displayName: Git Credentials
  - name: Activity
    x-displayName: Activity
  - name: Admin
    x-displayName: Admin
  - name: Notifications
    x-displayName: Notifications
  - name: Adminnotifications
    x-displayName: Adminnotifications
  - name: UserManagement
    x-displayName: UserManagement
  - name: WhiteLabel
    x-displayName: WhiteLabel
  - name: Authentication and Authorization
    x-displayName: Authentication and Authorization
  - name: Code
    x-displayName: Code
  - name: ComputeCluster
    x-displayName: ComputeCluster
  - name: Control Center
    x-displayName: Control Center
  - name: controlcenter
    x-displayName: controlcenter
  - name: DataSourceCredential
    x-displayName: DataSourceCredential
  - name: DataMount
    x-displayName: DataMount
  - name: DataPlane
    x-displayName: DataPlane
  - name: dataset
    x-displayName: dataset
  - name: Datasets
    x-displayName: Datasets
  - name: datasetrw.api
    x-displayName: datasetrw.api
  - name: DatasetObjectStore
    x-displayName: DatasetObjectStore
  - name: DevelopV1ProjectTemplates
    x-displayName: DevelopV1ProjectTemplates
  - name: DevelopV1Projects
    x-displayName: DevelopV1Projects
  - name: Execution Events
    x-displayName: Execution Events
  - name: Files
    x-displayName: Files
  - name: Frontend
    x-displayName: Frontend
  - name: Gateway
    x-displayName: Gateway
  - name: Runs
    x-displayName: Runs
  - name: Search
    x-displayName: Search
  - name: Git
    x-displayName: Git
  - name: Metadata
    x-displayName: Metadata
  - name: Gruz
    x-displayName: Gruz
  - name: Guardrails
    x-displayName: Guardrails
  - name: Hardware Tier
    x-displayName: Hardware Tier
  - name: ActionableInsights
    x-displayName: ActionableInsights
  - name: Socket
    x-displayName: Socket
  - name: Job
    x-displayName: Job
  - name: Tags
    x-displayName: Tags
  - name: JobComments
    x-displayName: JobComments
  - name: LogsWithProblemSuggestion
    x-displayName: LogsWithProblemSuggestion
  - name: JobResults
    x-displayName: JobResults
  - name: Layout
    x-displayName: Layout
  - name: Metrics
    x-displayName: Metrics
  - name: MLFlow
    x-displayName: MLFlow
  - name: ModelManager
    x-displayName: ModelManager
  - name: Model Products
    x-displayName: Model Products
  - name: Project Goals
    x-displayName: Project Goals
  - name: ProjectManagement
    x-displayName: ProjectManagement
  - name: Templates
    x-displayName: Templates
  - name: Project
    x-displayName: Project
  - name: Launchers
    x-displayName: Launchers
  - name: Scheduled Jobs
    x-displayName: Scheduled Jobs
  - name: Quota
    x-displayName: Quota
  - name: RemoteFileSystem
    x-displayName: RemoteFileSystem
  - name: Scheduled Runs
    x-displayName: Scheduled Runs
  - name: Workspace
    x-displayName: Workspace
  - name: Logs
    x-displayName: Logs
  - name: WorkspaceComments
    x-displayName: WorkspaceComments
  - name: WorkspaceResults
    x-displayName: WorkspaceResults
  - name: Resource
    description: The Data Plane Resource API
    x-displayName: Resource
  - name: authz
    x-displayName: authz
  - name: volumes
    x-displayName: volumes
  - name: data transfers
    x-displayName: data transfers
  - name: downloads
    x-displayName: downloads
  - name: filesystems
    x-displayName: filesystems
  - name: snapshots
    x-displayName: snapshots
  - name: tasks
    x-displayName: tasks
  - description: Manage taxonomy namespaces.
    name: Tagging - Namespaces
    x-displayName: Tagging - Namespaces
  - description: Manage tags within namespaces.
    name: Tagging - Tags
    x-displayName: Tagging - Tags
  - description: Assign, remove, and list tag assignments on entities.
    name: Tagging - Entity Tags
    x-displayName: Tagging - Entity Tags
  - description: Look up entities by tag.
    name: Tagging - Entities
    x-displayName: Tagging - Entities
  - description: Fetch the full namespace + tag hierarchy.
    name: Tagging - Taxonomy Tree
    x-displayName: Tagging - Taxonomy Tree
  - description: Validate and import taxonomy data from a file.
    name: Tagging - Import
    x-displayName: Tagging - Import
  - description: Export the current taxonomy to a file.
    name: Tagging - Export
    x-displayName: Tagging - Export
  - description: Internal-only endpoints for service-account callers.
    name: Tagging - Internal
    x-displayName: Tagging - Internal
  - description: Manage property definitions and their groups.
    name: Properties - Definitions
    x-displayName: Properties - Definitions
  - description: Read and update an entity's property values.
    name: Properties - Values
    x-displayName: Properties - Values
  - description: Internal-only endpoints for service-account callers (properties).
    name: Properties - Internal
    x-displayName: Properties - Internal
  - name: config
    x-displayName: config
  - name: Workloads
    description: Everything related to deploying and managingDomino Workloads
    x-displayName: Workloads
  - name: Executor
    description: Executor-related commands
    x-displayName: Executor
  - name: HPC
    description: HPC workload management
    x-displayName: HPC
  - name: Endpoints
    x-displayName: Endpoints
  - name: mlflow-proxy_other
    x-displayName: other
  - name: attachments
    x-displayName: attachments
  - name: bundle-stages
    x-displayName: bundle-stages
  - name: bundles
    x-displayName: bundles
  - name: findings
    x-displayName: findings
  - name: drafts
    x-displayName: drafts
  - name: evidence-templates
    x-displayName: evidence-templates
  - name: policies
    x-displayName: policies
  - name: policy-versions
    x-displayName: policy-versions
  - name: policy-enforcers
    x-displayName: policy-enforcers
  - name: results
    x-displayName: results
  - name: rpc
    x-displayName: rpc
  - name: approvals
    x-displayName: approvals
  - description: >-
      Create, query, bulk-update, and evaluate priority-based access control
      rules.
    name: rules
    x-displayName: rules
  - name: domino-connect_other
    x-displayName: other
  - name: events
    x-displayName: events
  - name: curated-central-configs
    x-displayName: curated-central-configs
  - name: nodepools
    x-displayName: nodepools
  - name: ip-allowlist
    x-displayName: ip-allowlist
externalDocs:
  description: OpenAPI
  url: https://swagger.io/resources/open-api/
paths:
  /api/audittrail/v1/auditevents:
    get:
      tags:
        - AuditTrail
      operationId: fetchAuditEvents
      parameters:
        - $ref: '#/components/parameters/nucleus_startTimestamp'
        - $ref: '#/components/parameters/nucleus_endTimestamp'
        - $ref: '#/components/parameters/nucleus_actorId'
        - $ref: '#/components/parameters/nucleus_actorName'
        - $ref: '#/components/parameters/nucleus_event'
        - $ref: '#/components/parameters/nucleus_targetType'
        - $ref: '#/components/parameters/nucleus_targetId'
        - $ref: '#/components/parameters/nucleus_targetName'
        - $ref: '#/components/parameters/nucleus_withinProjectId'
        - $ref: '#/components/parameters/nucleus_withinProjectName'
        - $ref: '#/components/parameters/nucleus_sort'
        - $ref: '#/components/parameters/nucleus_limit'
        - $ref: '#/components/parameters/nucleus_offset'
        - $ref: '#/components/parameters/nucleus_columns'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/nucleus_AuditEventsResponse'
            text/csv:
              schema:
                type: string
          description: >-
            Provides audit events matching the specified filters and within the
            specified offset and limit
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/nucleus_Error'
          description: Bad request
      security:
        - nucleus_DominoApiKey: []
        - nucleus_BearerAuthentication: []
components:
  parameters:
    nucleus_startTimestamp:
      description: unix timestamp in milliseconds
      in: query
      name: startTimestamp
      required: false
      schema:
        type: integer
    nucleus_endTimestamp:
      description: unix timestamp in milliseconds
      in: query
      name: endTimestamp
      required: false
      schema:
        type: integer
    nucleus_actorId:
      in: query
      name: actorId
      required: false
      schema:
        type: string
    nucleus_actorName:
      in: query
      name: actorName
      required: false
      schema:
        type: string
    nucleus_event:
      in: query
      name: event
      required: false
      schema:
        type: string
    nucleus_targetType:
      description: all events in which the target's type matches
      example: dataset
      in: query
      name: targetType
      required: false
      schema:
        type: string
    nucleus_targetId:
      description: all events in which the target's id matches
      example: dataset_id
      in: query
      name: targetId
      required: false
      schema:
        type: string
    nucleus_targetName:
      description: all events in which the target's name matches
      example: my_dataset_name
      in: query
      name: targetName
      required: false
      schema:
        type: string
    nucleus_withinProjectId:
      description: events that occurred within the context of a project with this id
      in: query
      name: withinProjectId
      required: false
      schema:
        type: string
    nucleus_withinProjectName:
      description: events that occurred within the context of a project with this name
      in: query
      name: withinProjectName
      required: false
      schema:
        type: string
    nucleus_sort:
      description: >-
        a comma separated list of fields, each prefixed with either a + or - to
        indicates asc or desc (no prefix defaults to asc). The list of supported
        sort fields are timestamp, actorId, actorName, withinProjectId,
        withinProjectName, event, targetType, and targetName
      example: '-timestamp,+actorId'
      in: query
      name: sort
      required: false
      schema:
        type: string
    nucleus_limit:
      description: Max number to fetch. Defaults to 10.
      in: query
      name: limit
      required: false
      schema:
        type: integer
    nucleus_offset:
      description: How many from the start to skip. Defaults to 0.
      in: query
      name: offset
      required: false
      schema:
        type: integer
    nucleus_columns:
      description: >-
        the name of a column that should be included in the csv download. This
        parameter can be repeated to include multiple columns. The order in
        which the column names are provided dictates the order of the columns in
        the csv. This will cause a 400 if the Accept header is not csv or if the
        column name is unsupported
      example: date_time
      in: query
      name: column
      required: false
      schema:
        enum:
          - date_time
          - user_name
          - first_name
          - last_name
          - event
          - reason_for_change
          - reason_for_change_additional_info
          - electronically_signed
          - target_name
          - project_name
          - dataset_name
          - file_name
          - target_user
          - before_value
          - after_value
          - feature_flag
          - jobs
          - environment
          - workspace
        type: string
  schemas:
    nucleus_AuditEventsResponse:
      properties:
        events:
          items:
            $ref: '#/components/schemas/nucleus_AuditEvent'
          type: array
        total:
          type: integer
      required:
        - estimatedMatches
        - events
      type: object
    nucleus_Error:
      allOf:
        - properties:
            errors:
              description: What caused the request to fail
              items:
                type: string
              type: array
            requestId:
              description: Id used to correlate a request with server actions.
              example: bbd78579-93c4-45ee-a983-0d5c8da6d5b1
              type: string
          required:
            - errors
    nucleus_AuditEvent:
      properties:
        action:
          $ref: '#/components/schemas/nucleus_Action'
        actor:
          $ref: '#/components/schemas/nucleus_Actor'
        affecting:
          $ref: '#/components/schemas/nucleus_Affecting'
        from:
          $ref: '#/components/schemas/nucleus_Entity'
        in:
          $ref: '#/components/schemas/nucleus_Entity'
        metadata:
          $ref: '#/components/schemas/nucleus_StringStringMap'
        targets:
          $ref: '#/components/schemas/nucleus_TargetList'
        timestamp:
          format: int64
          type: integer
        to:
          $ref: '#/components/schemas/nucleus_Entity'
      required:
        - timestamp
        - actor
        - action
        - targets
        - affecting
        - metadata
      type: object
    nucleus_Action:
      properties:
        electronicallySigned:
          type: boolean
        eventName:
          type: string
        reasonForChange:
          type: string
        reasonForChangeAdditionalInfo:
          type: string
        traceId:
          type: string
        using:
          $ref: '#/components/schemas/nucleus_UsingList'
      required:
        - eventName
        - using
      type: object
    nucleus_Actor:
      properties:
        id:
          type: string
        idpId:
          type: string
        name:
          type: string
      required:
        - id
    nucleus_Affecting:
      items:
        $ref: '#/components/schemas/nucleus_Entity'
      type: array
    nucleus_Entity:
      properties:
        entityType:
          type: string
        id:
          type: string
        name:
          type: string
        tags:
          items:
            type: string
          type: array
      required:
        - entityType
        - tags
      type: object
    nucleus_StringStringMap:
      type: object
      additionalProperties:
        type: string
    nucleus_TargetList:
      items:
        $ref: '#/components/schemas/nucleus_Target'
      type: array
    nucleus_UsingList:
      items:
        $ref: '#/components/schemas/nucleus_Entity'
      type: array
    nucleus_Target:
      properties:
        entity:
          $ref: '#/components/schemas/nucleus_Entity'
        fieldChanges:
          items:
            $ref: '#/components/schemas/nucleus_PolymorphicFieldStateChange'
          type: array
      required:
        - entity
        - fieldChanges
    nucleus_PolymorphicFieldStateChange:
      discriminator:
        mapping:
          scalar:
            $ref: '#/components/schemas/nucleus_ScalarFieldStateChange'
          sequence:
            $ref: '#/components/schemas/nucleus_SequenceFieldStateChange'
        propertyName: fieldType
      oneOf:
        - $ref: '#/components/schemas/nucleus_ScalarFieldStateChange'
        - $ref: '#/components/schemas/nucleus_SequenceFieldStateChange'
    nucleus_ScalarFieldStateChange:
      allOf:
        - $ref: '#/components/schemas/nucleus_FieldStateChange'
      properties:
        after:
          type: string
        before:
          type: string
        unit:
          type: string
    nucleus_SequenceFieldStateChange:
      allOf:
        - $ref: '#/components/schemas/nucleus_FieldStateChange'
      properties:
        added:
          items:
            $ref: '#/components/schemas/nucleus_Entity'
          type: array
        removed:
          items:
            $ref: '#/components/schemas/nucleus_Entity'
          type: array
    nucleus_FieldStateChange:
      properties:
        fieldName:
          type: string
        fieldType:
          $ref: '#/components/schemas/nucleus_FieldType'
      type: object
    nucleus_FieldType:
      enum:
        - scalar
        - sequence
      type: string
  securitySchemes:
    nucleus_DominoApiKey:
      type: apiKey
      name: X-Domino-Api-Key
      in: header
    nucleus_BearerAuthentication:
      type: apiKey
      name: Authorization
      in: header

````

## Related topics

- [Get started](/6.3/platform-overview/for-modelers-and-builders/index.md)
- [Get started with R](/6.3/platform-overview/for-modelers-and-builders/get-started-r/index.md)
- [Get an environment](/6.3/api-reference/environments/get-an-environment.md)
- [Get apiaudittrailv1fieldvalues](/6.3/api-reference/nucleus_other/get-apiaudittrailv1fieldvalues.md)
