---
title: "List audit log events"
method: GET
path: "/teams/{team_id}/list_audit_log_events"
tags: ["Teams"]
---

# List audit log events

`GET /teams/{team_id}/list_audit_log_events`

## Request

- Base URL: `https://api.convex.dev/v1`
- URL: `https://api.convex.dev/v1/teams/{team_id}/list_audit_log_events`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

List a team's audit log events within a time range, with optional filters.

## Path parameters

- `team_id` integer, required

## Query parameters

- `from` integer, required
- `to` integer, required
- `memberId` integer
- `action` 'team:join' | 'team:create' | 'team:update' | 'team:delete' | 'project:create' | 'project:transfer' | 'project:receive' | 'project:update' | 'project:delete' | 'defaultEnvironmentVariable:create' | 'defaultEnvironmentVariable:update' | 'defaultEnvironmentVariable:delete' | 'deployment:create' | 'deployment:delete' | 'member:invite' | 'member:cancelInvitation' | 'member:remove' | 'member:updateRole' | 'project:updateMemberRole' | 'billing:paymentMethod:update' | 'billing:contact:update' | 'billing:address:update' | 'billing:subscription:create' | 'billing:subscription:resume' | 'billing:subscription:cancel' | 'billing:subscription:changePlan' | 'team:token:create' | 'team:token:update' | 'team:token:delete' | 'team:token:view' | 'project:token:create' | 'project:token:update' | 'project:token:delete' | 'project:token:view' | 'deployment:token:create' | 'deployment:token:update' | 'deployment:token:delete' | 'deployment:token:view' | 'member:token:createWithSsoAccess' | 'team:domain:create' | 'team:domain:delete' | 'deployment:customDomain:create' | 'deployment:customDomain:delete' | 'deployment:backups:create' | 'deployment:backups:import' | 'deployment:backups:configurePeriodic' | 'deployment:backups:disablePeriodic' | 'deployment:backups:delete' | 'team:disableExceedingSpendingLimits' | 'billing:spendingLimit:update' | 'team:applyReferralCode' | 'oauthApplication:create' | 'oauthApplication:update' | 'oauthApplication:delete' | 'oauthApplication:verify' | 'oauthApplication:generateClientSecret' | 'integration:workos:team:create' | 'integration:workos:environment:create' | 'integration:workos:environment:delete' | 'integration:workos:environment:retrieveCredentials' | 'integration:workos:team:disconnect' | 'integration:workos:team:inviteMember' | 'integration:workos:projectEnvironment:create' | 'integration:workos:projectEnvironment:delete' | 'integration:workos:projectEnvironment:retrieveCredentials' | 'sso:enable' | 'sso:disable' | 'sso:update' | 'member:loginWithSso' | 'directorySync:enable' | 'directorySync:disable' | 'directorySync:updateGroupMapping' | 'directorySync:deleteGroupMapping' | 'deployment:transfer' | 'deployment:receive' | 'deployment:update' | 'customRole:create' | 'customRole:update' | 'customRole:delete'
- `limit` integer, nullable
- `cursor` string, nullable

## Response `200`

- ListAuditLogEventsResponse
  - `items` AuditLogEventResponse[], required
    - `teamId` integer, required
    - `actor` union, required: The identity that executed 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 token.
        - `member_id` integer
        - `token_id` integer, required
        - `client_id` string, nullable: Client ID of the OAuth application the token was issued to or is managed by, if any.
        - `kind` 'token', required
      - object: An integration (OAuth application).
        - `client_id` string, required: Client ID of the integration
        - `kind` 'integration', required
    - `action` 'team:join' | 'team:create' | 'team:update' | 'team:delete' | 'project:create' | 'project:transfer' | 'project:receive' | 'project:update' | 'project:delete' | 'defaultEnvironmentVariable:create' | 'defaultEnvironmentVariable:update' | 'defaultEnvironmentVariable:delete' | 'deployment:create' | 'deployment:delete' | 'member:invite' | 'member:cancelInvitation' | 'member:remove' | 'member:updateRole' | 'project:updateMemberRole' | 'billing:paymentMethod:update' | 'billing:contact:update' | 'billing:address:update' | 'billing:subscription:create' | 'billing:subscription:resume' | 'billing:subscription:cancel' | 'billing:subscription:changePlan' | 'team:token:create' | 'team:token:update' | 'team:token:delete' | 'team:token:view' | 'project:token:create' | 'project:token:update' | 'project:token:delete' | 'project:token:view' | 'deployment:token:create' | 'deployment:token:update' | 'deployment:token:delete' | 'deployment:token:view' | 'member:token:createWithSsoAccess' | 'team:domain:create' | 'team:domain:delete' | 'deployment:customDomain:create' | 'deployment:customDomain:delete' | 'deployment:backups:create' | 'deployment:backups:import' | 'deployment:backups:configurePeriodic' | 'deployment:backups:disablePeriodic' | 'deployment:backups:delete' | 'team:disableExceedingSpendingLimits' | 'billing:spendingLimit:update' | 'team:applyReferralCode' | 'oauthApplication:create' | 'oauthApplication:update' | 'oauthApplication:delete' | 'oauthApplication:verify' | 'oauthApplication:generateClientSecret' | 'integration:workos:team:create' | 'integration:workos:environment:create' | 'integration:workos:environment:delete' | 'integration:workos:environment:retrieveCredentials' | 'integration:workos:team:disconnect' | 'integration:workos:team:inviteMember' | 'integration:workos:projectEnvironment:create' | 'integration:workos:projectEnvironment:delete' | 'integration:workos:projectEnvironment:retrieveCredentials' | 'sso:enable' | 'sso:disable' | 'sso:update' | 'member:loginWithSso' | 'directorySync:enable' | 'directorySync:disable' | 'directorySync:updateGroupMapping' | 'directorySync:deleteGroupMapping' | 'deployment:transfer' | 'deployment:receive' | 'deployment:update' | 'customRole:create' | 'customRole:update' | 'customRole:delete', 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

## Changes

- **2026-09-26** `2ded7dd7ebcf`: 1 warning, 1 info
  - added the new `member:loginWithSso` enum value to the `items/items/action` response property for the response status `200`
  - added the new enum value `member:loginWithSso` to the `query` request parameter `action`
- **2026-09-24** `85ada3c29a3c`: 1 warning, 1 info
  - added the new `member:token:createWithSsoAccess` enum value to the `items/items/action` response property for the response status `200`
  - added the new enum value `member:token:createWithSsoAccess` to the `query` request parameter `action`
- **2026-09-18** `d5ab97149ad8`: 2 warning, 2 info
  - added the new `team:domain:create` enum value to the `items/items/action` response property for the response status `200`
  - added the new `team:domain:delete` enum value to the `items/items/action` response property for the response status `200`
  - added the new enum value `team:domain:create` to the `query` request parameter `action`
  - added the new enum value `team:domain:delete` to the `query` request parameter `action`
- …earlier changes not shown

[Operation history](https://skmtc.dev/convex/apis/convex-management-api/changes/teams/:team_id/list_audit_log_events/get.md)

---

[API](https://skmtc.dev/convex/apis/convex-management-api.md) - [All operations](https://skmtc.dev/convex/apis/convex-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/convex/apis/convex-management-api/revisions/2ded7dd7ebcf?raw)