---
title: "List audit log events"
method: GET
path: "/list_audit_log_events"
tags: ["Audit Log"]
---

# List audit log events

`GET /list_audit_log_events`

## Request

- Base URL: `https://happy-animal-123.convex.cloud/api/v1`
- URL: `https://happy-animal-123.convex.cloud/api/v1/list_audit_log_events`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - API key in header `Authorization`

List a deployment's audit log events on or after a timestamp, from least to
most recent. Pass the returned `cursor` (along with the same `from`) to
fetch the next page.

## Query parameters

- `from` integer, required
- `limit` integer, nullable
- `cursor` string, nullable

## Response `200`

- ListDeploymentAuditLogEventsResponse
  - `items` DeploymentAuditLogEventResponse[], required: The audit log events for this page, from least to most recent.
    - `actor` union, required: The identity that performed an audit log action.
      - object: The internal Convex system.
        - `kind` 'system', required
      - object: A member acting via the dashboard.
        - `member_id` integer, required
        - `kind` 'member', required
      - object: A deploy key or access token.
        - `member_id` integer
        - `token_id` integer, required
        - `client_id` string, nullable: Client ID of the OAuth application, if the token belongs to one.
        - `kind` 'token', required
    - `action` 'create_environment_variable' | 'update_environment_variable' | 'delete_environment_variable' | 'create_usage_limit' | 'update_usage_limit' | 'delete_usage_limit' | 'usage_limit_exceeded' | 'change_usage_limit_stop_state' | 'replace_environment_variable' | 'update_canonical_url' | 'delete_canonical_url' | 'push_config' | 'push_config_with_components' | 'build_indexes' | 'change_deployment_state' | 'pause_deployment' | 'unpause_deployment' | 'change_system_stop_state' | 'clear_tables' | 'snapshot_import' | 'delete_scheduled_jobs_table' | 'delete_tables' | 'delete_component' | 'cancel_all_scheduled_functions' | 'cancel_scheduled_function' | 'request_export' | 'cancel_export' | 'set_export_expiration' | 'create_integration' | 'update_integration' | 'delete_integration' | 'add_documents' | 'delete_documents' | 'update_documents' | 'create_table' | 'delete_files' | 'generate_upload_url' | 'create_data_sync', required
    - `createTime` integer, required: Time the event was created, in milliseconds since epoch.
    - `metadata` unknown, required
    - `clientIp` string, nullable: IP address of the client that performed the action, if known.
    - `clientUserAgent` string, nullable: User agent of the client that performed the action, if known.
  - `pagination` PaginationMetadata, required
    - `hasMore` boolean, required
    - `nextCursor` string, nullable

---

[API](https://skmtc.dev/operatornest/apis/convex-deployment-api.md) · [All operations](https://skmtc.dev/operatornest/apis/convex-deployment-api/llms.txt) · [OpenAPI document](https://skmtc.dev/operatornest/apis/convex-deployment-api/revisions/bd0de6c553a7?raw)