# Audit Events

Fetches audit events from the Coda Admin API, providing comprehensive monitoring and compliance data for your Coda organization.

**Sync Type: Incremental**

## Requirements
- A Coda account with at least one Enterprise workspace (auditing is only available for Enterprise workspaces)
- Organization admin privileges to generate API tokens
- Access to your Coda Organization ID from the organization settings

### Finding Your Organization ID
1. Navigate to your Coda dashboard
2. Click on **More options** (found at the bottom left of the dashboard)
3. Select **Organization Settings**
4. The Organization ID can be found in the URL of the Organization Settings page
5. Look for the path segment beginning with `org-` (e.g., `org-aBcDeFgHiJ`)

### Generating an API Token
1. Go to **Account Settings** > **API Settings**
2. Create a new API token with **Read only** permissions
3. Copy the generated token (format: `12345678-abcd-9012-abfe-345789012345`)
4. Save this token securely as it will be needed for the connector configuration

**Note**: API tokens must be created by an organization admin.

## Details
Monad uses the `timestamp` field from audit events to implement incremental synchronization. The connector tracks the timestamp of the last successfully processed event and only fetches newer events on subsequent runs. If this is the first time running the connector, a full sync of available audit events is performed.

The connector processes events in ascending chronological order to ensure proper incremental updates and uses pagination to handle large volumes of audit data efficiently.

## Configuration
The following configuration defines the input parameters. Each field's specifications, such as type, requirements, and descriptions, are detailed below.

#### Settings

| Setting         | Type   | Required | Description                                                                             |
| --------------- | ------ | -------- | --------------------------------------------------------------------------------------- |
| Organization ID | string | Yes      | Your Coda Organization ID found in the organization settings URL (e.g., org-aBcDeFgHiJ) |
| Backfill Start Time | string | No | The date to start fetching data from. If not specified, no past records will be fetched. |
| API Rate Limit | object | No | Optional limit on the connector's outbound request rate to the source API. Leave blank to use the connector's default behavior. See [API Rate Limiting](../../../guides/rate-limiting) for the field format, limits, and how to choose a value. |

#### Secrets

| Secret    | Type   | Required | Description                                                                                                   |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------- |
| API Token | string | Yes      | API Token for the Coda Admin API. This must be generated by an organization admin with read-only permissions. |

## Connector Limitations
- **Enterprise Requirement**: The Coda account must contain at least one Enterprise workspace for auditing to be enabled
- **Rate Limits**: This connector is subject to [Coda's API rate limits](https://coda.io/developers/apis/v1#section/Using-the-API/Rate-Limiting), which may affect the speed of data collection for organizations with high audit event volumes
- **Admin Access**: API tokens can only be created by organization administrators
- **Data Retention**: Audit event availability depends on your Coda plan's data retention policies

## Related Articles
- [Coda Admin API Documentation](https://coda.io/developers/apis/admin)
- [Coda Enterprise Features](https://coda.io/product/enterprise)
- [Coda API Authentication](https://coda.io/developers/apis/v1#authentication)