---
descriptions:
  audit_log_event:
    action: Identifier of what action was taken.
    occurred_at: ISO-8601 timestamp of when the action occurred.
    version: The schema version the event is associated with.
    actor: The entity that performed the action.
    actor_type: 'The type of the actor (e.g., "user", "system").'
    actor_id: The unique identifier of the actor.
    actor_name: An optional display name for the actor.
    targets: The resources affected by the action.
    target_type: The type of the target resource.
    target_id: The unique identifier of the target.
    target_name: An optional display name for the target.
    context: Additional context about where and how the action occurred.
    context_location: IP address or geolocation identifier.
    context_user_agent: The user agent string of the client.
    metadata: |
      Additional data associated with the event or entity.
      Limited to 50 keys. Key names can be up to 40 characters long,
      and values can be up to 500 characters long.
reference:
  curl:
    - url: /reference/audit-logs/event
      key: event
      id: audit_log_event
      title: event
      properties:
        - key: action
          type: string
          description: (audit_log_event.action)
        - key: occurred_at
          type: string
          description: (audit_log_event.occurred_at)
        - key: version
          type: number
          optional: true
          description: (audit_log_event.version)
        - key: actor
          type: object
          properties:
            - key: type
              type: string
              description: (audit_log_event.actor_type)
            - key: id
              type: string
              description: (audit_log_event.actor_id)
            - key: name
              type: string
              optional: true
              description: (audit_log_event.actor_name)
            - key: metadata
              type: object
              optional: true
              description: (audit_log_event.metadata)
        - key: targets
          type: array
          properties:
            - key: type
              type: string
              description: (audit_log_event.target_type)
            - key: id
              type: string
              description: (audit_log_event.target_id)
            - key: name
              type: string
              optional: true
              description: (audit_log_event.target_name)
            - key: metadata
              type: object
              optional: true
              description: (audit_log_event.metadata)
        - key: context
          type: object
          properties:
            - key: location
              type: string
              description: (audit_log_event.context_location)
            - key: user_agent
              type: string
              optional: true
              description: (audit_log_event.context_user_agent)
        - key: metadata
          type: object
          optional: true
          description: (audit_log_event.metadata)
originalPath: .tmp-workos-clone/packages/docs/content/reference/audit-logs/event/index.mdx
---

# Audit Log Event

An Audit Log Event represents a notable action taken within your application. Each event captures what happened, who did it, what was affected, and contextual information about when and where it occurred.