---
title: Security audit
description: Security audit log list and row components.
---

Audit log surfaces for the [security](/convex-auth/security) event trail.

### `ConvexSecurityAuditList`

**Props**

| Name              | Type                                                  | Optional | Description |
| ----------------- | ----------------------------------------------------- | -------- | ----------- |
| `classNames`      | `ConvexSecurityAuditListClassNames`                   | Yes      |             |
| `copy`            | `ConvexSecurityAuditListCopy`                         | No       |             |
| `formatCreatedAt` | `(createdAt: number) => string`                       | Yes      |             |
| `logs`            | `readonly ConvexSecurityAuditListItem[] \| undefined` | No       |             |
| `renderBadge`     | `(args: __type) => ReactNode`                         | Yes      |             |

**classNames keys**

| Key              | Type     |
| ---------------- | -------- |
| `action`         | `string` |
| `badge`          | `string` |
| `details`        | `string` |
| `list`           | `string` |
| `metadata`       | `string` |
| `row`            | `string` |
| `rowContent`     | `string` |
| `rowHeader`      | `string` |
| `secondaryBadge` | `string` |
| `stateText`      | `string` |
| `title`          | `string` |

**copy keys**

| Key                | Type     |
| ------------------ | -------- |
| `afterLabel`       | `string` |
| `beforeLabel`      | `string` |
| `emptyMessage`     | `string` |
| `loadingMessage`   | `string` |
| `systemActorLabel` | `string` |
| `userAgentLabel`   | `string` |

### `ConvexSecurityAuditRow`

**Props**

| Name              | Type                                   | Optional |
| ----------------- | -------------------------------------- | -------- |
| `classNames`      | `ConvexSecurityAuditListClassNames`    | Yes      |
| `copy`            | `Partial<ConvexSecurityAuditListCopy>` | Yes      |
| `formatCreatedAt` | `(createdAt: number) => string`        | Yes      |
| `log`             | `ConvexSecurityAuditListItem`          | No       |
| `renderBadge`     | `(args: __type) => ReactNode`          | Yes      |

**classNames keys**

| Key              | Type     |
| ---------------- | -------- |
| `action`         | `string` |
| `badge`          | `string` |
| `details`        | `string` |
| `list`           | `string` |
| `metadata`       | `string` |
| `row`            | `string` |
| `rowContent`     | `string` |
| `rowHeader`      | `string` |
| `secondaryBadge` | `string` |
| `stateText`      | `string` |
| `title`          | `string` |