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

# Event

## The Event Object

Events represent activities and actions within your application. They can trigger webhooks and are used for audit logging.

### Attributes

<ResponseField name="id" type="string" required>
  Unique identifier for the event

  **Example:** `evt_123`
</ResponseField>

<ResponseField name="app_id" type="string" required>
  Application ID where the event occurred
</ResponseField>

<ResponseField name="slug" type="string" required>
  Event type identifier

  **Example:** `user.created`
</ResponseField>

<ResponseField name="category" type="string" required>
  Event category for grouping related events

  **Example:** `user`
</ResponseField>

<ResponseField name="controller" type="string">
  Originating controller that triggered the event

  **Example:** `UsersController`
</ResponseField>

<ResponseField name="action" type="string">
  Originating action that triggered the event

  **Example:** `create`
</ResponseField>

<ResponseField name="app_user_id" type="string">
  ID of the user associated with this event
</ResponseField>

<ResponseField name="data" type="object" required>
  Event payload containing relevant data

  **Example:** `{ "user_id": "usr_123", "email": "user@example.com" }`
</ResponseField>

<ResponseField name="metadata" type="object">
  Additional metadata about the event

  **Example:** `{ "ip_address": "192.168.1.1", "user_agent": "Mozilla/5.0" }`
</ResponseField>

<ResponseField name="params" type="object">
  Captured request parameters
</ResponseField>

<ResponseField name="note" type="string">
  Optional note or description
</ResponseField>

<ResponseField name="ip_address" type="string">
  IP address where the event originated

  **Example:** `192.168.1.1`
</ResponseField>

<ResponseField name="user_agent" type="string">
  Browser or client user agent string

  **Example:** `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)`
</ResponseField>

<ResponseField name="created_at" type="string" required>
  ISO 8601 timestamp when the event was created
</ResponseField>

<ResponseField name="updated_at" type="string" required>
  ISO 8601 timestamp when the event was last updated
</ResponseField>

## Example Event Object

```json theme={null}
{
  "id": "evt_123",
  "app_id": "app_123",
  "slug": "user.created",
  "category": "user",
  "controller": "UsersController",
  "action": "create",
  "app_user_id": "usr_456",
  "data": {
    "user_id": "usr_456",
    "email": "user@example.com",
    "name": "John Doe"
  },
  "metadata": {
    "source": "api",
    "version": "v1"
  },
  "params": {},
  "ip_address": "192.168.1.1",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}
```