auditLogs

List audit log events for your organization.

Returns a paginated, filterable, sortable list of audit log events. By default, events are sorted newest first (occurredAt descending).

Filtering — Use the filter argument to narrow results by time range, event type, actor type, or specific actor. All filters are combined with AND logic.

Example:

query {
  auditLogs(
    organizationId: "my-org"
    filter: {
      occurredAt: { after: "2025-01-01T00:00:00Z" }
      type: { startsWith: "project." }
      actorType: { in: [ACCOUNT, SERVICE_ACCOUNT] }
    }
  ) {
    data {
      id
      occurredAt
      type
      subject
      actor { type name }
    }
    cursor { next }
  }
}

auditLogs(
  organizationId: ID!
  filter: AuditLogsFilter
  sort: AuditLogsSort
  cursor: Cursor
): AuditLogsPage

Arguments

auditLogs.organizationId ● ID! non-null scalar {#organization-id}

Your organization's unique identifier.

auditLogs.filter ● AuditLogsFilter input {#filter}

Optional filter criteria to narrow results.

auditLogs.sort ● AuditLogsSort input {#sort}

Sort field and direction. Defaults to newest first.

auditLogs.cursor ● Cursor input {#cursor}

Pagination cursor from a previous response to fetch the next page.

Type

AuditLogsPage object