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

# User Events

> Audit log events for user profile and settings access

## Overview

User-related audit log events track actions and access related to user profiles and settings across the Centure platform. These events provide a comprehensive record of user interactions for security and compliance purposes.

## user.view\_settings

Triggered when a user views their account settings in the Centure platform.

### Event Details

* **Action Name**: `user.view_settings`
* **Actor**: The user viewing their settings
* **Target**: The same user whose settings are being viewed

### Event Schema

```typescript theme={null}
{
  action: "user.view_settings",
  actor: {
    type: "user",
    id: string,
    name: string,
    metadata: {
      first_name: string,
      last_name: string,
      email: string,
      // Optional impersonator details
      impersonator_email?: string,
      impersonator_reason?: string
    }
  },
  targets: [{
    type: "user",
    id: string,
    name: string,
    metadata: {
      first_name: string,
      last_name: string,
      email: string
    }
  }],
  context: {
    location: string, // IP address or "unknown"
    userAgent: string // Browser/device information or "unknown"
  },
  metadata: {
    source: string // User-facing page route
  }
}
```

### Example Payload

```json theme={null}
{
  "action": "user.view_settings",
  "actor": {
    "type": "user",
    "id": "user_123",
    "name": "Jane Doe",
    "metadata": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@example.com"
    }
  },
  "targets": [{
    "type": "user",
    "id": "user_123",
    "name": "Jane Doe",
    "metadata": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@example.com"
    }
  }],
  "context": {
    "location": "203.0.113.10",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
  },
  "metadata": {
    "source": "/settings/profile"
  }
}
```

### Logging Conditions

* Event is logged when a user navigates to their settings page
* Does not log individual setting modifications, only settings page access
* Requires audit logging to be enabled for the organization's subscription tier

### Security Notes

* Captures IP address and user agent for additional context
* Supports tracking of admin impersonation sessions
* Values are sanitized to prevent potential injection or oversized field issues

### Scope of User Audit Events

The `user.view_settings` event is currently the only Centure audit event for users. This event tracks when users access their account settings within the Centure platform.

### Authentication and Lifecycle Events

User authentication, lifecycle, and profile events are tracked as **system events** by WorkOS (our authentication provider), not as Centure audit events. These system events include:

* User authentication attempts (SSO, OAuth, password, MFA)
* User account creation and deletion
* Profile updates and password changes
* Session management
* Email verification and password resets

To view these system events, navigate to your organization's **System Events** page (admin-only). For detailed information, see [System Events](/logs/system-events) or the [WorkOS Events documentation](https://workos.com/docs/events).