Audit log

The audit log allows administrators to review important actions that have occurred within Kolide.

The audit log allows administrators to review important actions that have occurred within Kolide.

Accessing the audit log

You can view entries from the Audit Log both in the Kolide admin UI and programmatically through Kolide’s REST API.

Through the Kolide UI

Note

Only admins with “Full Access” can access the Audit Log in the Kolide UI.

  1. Click your user avatar in the upper-right corner of the Kolide UI.

  2. In the dropdown menu, click Settings.

  3. In the menu on the left, click Audit Log.

Through the Kolide API

If you haven’t already, create an API Key. There are no special permissions required to access audit log entries programmatically.

Refer to Kolide’s API Reference for documentation on how to programmatically access audit logs.

curl --request GET \
     --url https://api.kolide.com/audit_logs \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <TOKEN>' \
     --header 'x-kolide-api-version: {{latest_api_version}}'
{
  "data": [
    {
      "id": "256",
      "timestamp": "2019-10-25T13:25:46.213Z",
      "actor_name": "Jason Meller",
      "description": "user 'jason@kolide.co' accepted invitation to Kolide"
    },
    // SNIP
    {
      "id": "578",
      "timestamp": "2019-11-18T21:24:40.204Z",
      "actor_name": "Fritz Ifert-Miller",
      "description": "Published Live Query Campaign ID 2: AirDrop Discoverability"
    }
  ],
  "pagination": {
    "next": "https://api.kolide.com/audit_logs?cursor=NTg1LDU4NQ==",
    "next_cursor": "NTg1LDU4NQ==",
    "current_cursor": "",
    "count": 25
  }
}

Events

The following is a complete list of audit log events for Kolide Device Trust, including the name of the event, the description used in the audit log, and when Kolide began collecting audit log events of that type.

Checks

NameDescriptionCollected Since
check deletedDeleted Check "{custom\_check.name}"Sep-27-2022
check configuration changedChanged Fix Instructions Template Text for Check '{name}'Oct-6-2021
check configuration changedChanged Fix Instructions Template Strategy for Check '{name}' from '{original}' to '{new}'Oct-6-2021
check configuration changedChanged Rationale Template Text for Check '{name}'Oct-6-2021
check configuration changedChanged Rationale Template Strategy for Check '{name}' from '{original}' to '{new}'Oct-6-2021
check configuration changedReverted Check "{name}" fix instructions custom template to a prior versionOct-6-2021
check configuration changedReverted Check "{name}" fix instructions template supplement to a prior versionOct-6-2021
check configuration changedReverted Check "{name}" rationale custom template to a prior versionOct-6-2021
check configuration changedReverted Check "{name}" rationale template supplement to a prior versionOct-6-2021
check revertedReverted Check "{name}" to a prior versionSep-27-2022
check updatedUpdated existing Check "{name}"Sep-27-2022
check publishedPublished new Check "{name}"Sep-27-2022
check configuration options changedCheck Configuration options were changedOct-20-2022
updated check device trust settingsUpdated device trust settings for '{name}' from: {old\_settings} to: {new\_settings}Nov-7-2022
updated check device trust settingsUpdated run targets for '{name}' from: {old\_targets} to: {new\_targets}Aug-25-2023
Check marked as out of scopeExempted all future issues for "{check}" for device: "{name}".Feb-9-2023

Devices

NameDescriptionCollected Since
device display name changedChanged device name from '{original}' to '{new}'Nov-20-2022
canceled device removalCancelled pending deletion for '{device}'Apr-16-2023

Device registrations

NameDescriptionCollected Since
device registration approvedApproved pending device registration for "{email}" and device "{device\_name}". Reason: "{reason}"Jan-22-2023
device registration deniedDenied pending device registration for "{email}" and device "{device\_name}". Reason: "{reason}"Jan-22-2023
device registration reopenedReopened previously {prev\_status} device registration for "{email}" and device "{device\_name}".Jan-22-2023
device registration removedRemoved device registration for "{device\_name}" that was registered to {email}Mar-20-2023
tofu device registration re-enabledTOFU device registration re-enabled for '{name}'Jun-6-2023
device registration configuration changedChanged Default Authentication Mode changed who can authenticate from {old} to {new}Aug-10-2025
device registration configuration changedChanged 'Allows {platform} device registration' from {old} to {new}Jun-6-2023
device registration configuration changedChanged 'Allows {platform} device registration' from {old} to {new}May-22-2023
device registration configuration changedSet 'Required {platform} checks' to {check\_names}May-22-2023
device registration auth\_mode changedUpdated device registration for "{device} changed auth mode from "{prev\_auth\_mode}" to "{new\_auth\_mode} and changed allowed groups from {prev\_groups} to {new_groups}"Aug-16-2023

Exemption requests

NameDescriptionCollected Since
exemption request approvedApproved exemption request for "{email}" for check: "{check}". Reason: "{reason}"Jan-22-2023
exemption request deniedDenied exemption request for "{email}" for check: "{check}". Reason: "{reason}"Jan-22-2023
exemption request reopenedReopened previously {prev\_status} exemption for "{check}".Jan-22-2023
exemption request withdrawn{email} withdrew exemption request for check: "{check}"Jan-22-2023

People

NameDescriptionCollected Since
factor enrollment resetReset factor enrollment for '{username}'Aug-7-2023
factor enrollment verifiedVerified factor enrollment for '{username}'Aug-7-2023
A person record was mergedMerged the person, {old}, with {new}Jul-12-2023
A person record was unmergedRestored the person, {name}, to it's original stateJul-12-2023

Managed web app

NameDescriptionCollected Since
managed app createdCreated managed app "{name}"Oct-6-2024
managed app deletedDeleted managed app "{name}" with #{count} peopleOct-6-2024
managed app updatedUpdated managed app "{name}" from: {old\_settings} to: {new\_settings}Oct-6-2024
managed app sign on settings updatedSign on settings were updated for "{name}" from: {old\_settings} to: {new\_settings}Oct-6-2024
managed app direct assigned people membership changedUpdated managed app "#{name}" directly assigned people membership from {old} to {new}Oct-6-2024
managed app person groups membership changedUpdated managed app "#{name}" directly assigned person groups membership from {old} to {new}Oct-6-2024

Groups

NameDescriptionCollected Since
device group memberships removedMass-Removed members from device group: "{name}". Device ID(s) removed: {ids}Aug-30-2023
device group memberships removedMass-Removed members from device group: "{name}". Device ID(s) removed: {ids}Aug-30-2023
device group createdCreated device group "{name}"Aug-30-2023
device group deletedDeleted device group "{name}" with {count} membersAug-30-2023
device group deletedDeleted device group "{name}" with {count} membersAug-30-2023

Log pipeline

NameDescriptionCollected Since
logging pipeline enabledEnabled the logging pipelineJan-1-2020
logging pipeline disabledDisabled the logging pipelineJan-1-2020
device property logger addedAdded device property logger '{name}'Jan-1-2020
device property logger removedRemoved device property logger '{name}'Jan-1-2020
enabled log pipeline destinationEnabled the log pipeline destination '{name}'Jan-1-2020
disabled log pipeline destinationDisabled the log pipeline destination '{name}'Jan-1-2020
deleted log pipeline destinationDeleted the log pipeline destination '{name}'Jan-1-2020
updated osquery decoratorUpdated the osquery decorator '{name}'Jan-1-2020
added osquery decoratorAdded an osquery decorator '{name}'Jan-1-2020
enabled osquery decoratorEnabled osquery decorator '{name}'Jan-1-2020
deleted osquery decoratorDeleted osquery decorator '{name}'Jan-1-2020
updated osquery fim categoryUpdated the osquery FIM category '{name}'Jan-1-2020
created osquery fim categoryCreated osquery FIM category '{name}'Jan-1-2020
enabled osquery fim categoryEnabled osquery FIM category '{name}'Jan-1-2020
disabled osquery fim categoryDisabled osquery FIM category '{name}'Jan-1-2020
deleted osquery fim categoryDeleted the osquery FIM category '{name}'Jan-1-2020
updated osquery optionsUpdated osquery optionsJan-1-2020
reset osquery optionsReset all osquery options to their default valueJan-1-2020
created discovery queryCreated discovery query '{name}'Jan-1-2020
updated discovery queryUpdated the osquery discovery query '{name}'Jan-1-2020
deleted discovery queryDeleted discovery query '{name}'Jan-1-2020
created osquery pack queryCreated osquery pack query '{name}'Jan-1-2020
updated osquery pack queryUpdated the osquery query '{name}'Jan-1-2020
updated osquery pack queryDeleted osquery pack query '{name}'Jan-1-2020
created osquery packCreated osquery pack '{name}'Jan-1-2020
updated osquery packUpdated the osquery pack '{name}'Jan-1-2020
enabled osquery packEnabled osquery pack '{name}'Jan-1-2020
disabled osquery packDisabled osquery pack '{name}'Jan-1-2020
deleted osquery packDeleted the osquery pack '{name}'Jan-1-2020
updated log pipeline destinationUpdated the {type} log destination '{name}'Jan-1-2020
created log pipeline destinationCreated a {type} log pipeline destination named '{name}'Jan-1-2020

Live queries

NameDescriptionCollected Since
live query created and runCreated and ran Live Query Campaign ID {id} that targets {counts} that uses table(s): {tables}Nov-18-2019
live query updated and runUpdated and ran Live Query Campaign ID {id} that targets {counts} that uses table(s): {tables}Nov-18-2019
live query deletedDeleted Live Query Campaign ID {id} : {name}Nov-18-2019
live query single result csv exportedCSV Downloaded For Device {name} - Live Query Campaign ID {id}Nov-18-2019
live query unpublishedUnpublished Live Query Campaign ID {id}Nov-18-2019
live query csv exportedCSV Downloaded For Live Query Campaign ID {id}Nov-20-2020
live query publishedPublished Live Query Campaign ID {id}Nov-20-2020

Okta webhooks

NameDescriptionCollected Since
saml\_idp\_factor\_removedOkta event hook received for 'saml\_idp\_factor\_removed'Oct-18-2023
saml\_idp\_factor\_setupOkta event hook received for 'saml\_idp\_factor\_setup'Oct-18-2023
saml\_webhook\_verificationOkta event hooks verifiedOct-18-2023

Billing

NameDescriptionCollected Since
billing email updatedUpdated billing email to '{email}' from '{original\_email}'Jul-30-2021

End user portal

NameDescriptionCollected Since
privacy center configuration changedChanged 'Privacy Center Access Restriction Settings' from '{old}' to '{new}'Sep-1-2021
privacy center configuration changedChanged Privacy Center Custom Resource Section visibility from {old} to {new}Sep-1-2021
privacy center configuration changedChanged Privacy Center Custom Resource Section textSep-1-2021
privacy center configuration changedReverted Privacy Center Custom Resource Section to a prior versionSep-1-2021

Automatic device removal

NameDescriptionCollected Since
duplicate device foundDuplicate device foundJuly 17-2025
device deletion requestedtriggered device deletion for inactive device named '{name}'Jun-9-2021
device removedDevice '{name}' removedDec-2-2024

Restrictions

NameDescriptionCollected Since
osquery blocklist updatedOsquery Blocklist Updated From: "{old\_tables}" To: "{new\_tables}"Oct-23-2019
feature restriction changedChanged '{feature}' from '{old}' to {new}Nov-19-2019

Admin users

NameDescriptionCollected Since
kolide team member createduser '{email}' accepted invitation to KolideOct-23-2019
kolide team member invitedInvited '{email}' to access kolideOct-23-2019
kolide team member deletedRemoved access for Kolide user '{name}'Oct-23-2019
user feature restriction changedUpdated {feature} restriction on {name} from '{old}' to '{new}'Nov-19-2019
user access changedUpdated access for user '{email}' from '{old}' to '{new}'Aug-3-2023
invitations revoked because inviter access changedRevoked invitations created by '{email}' because admin access was removed. Revoked invitations with email address(es): {emails}Aug-3-2023
user.addedAdded EPM user '#{user.name}' to KolideJuly 28-2025

SSO settings

NameDescriptionCollected Since
idp settings changedKolide IdP settings were updated from: {previous\_values} to: {new\_values}Jun-29-2023
webhook token generatedIdP Proxy webhook token generated for '{organization}'Apr-24-2023
factor sequencing enabledKolide IdP: Additional Factor Sequencing was 'disabled'Aug-10-2023
factor sequencing disabledKolide IdP: Additional Factor Sequencing was 'enabled'Aug-10-2023
updated saml configurationUpdated SAML configurationJan-21-2023

Integrations

NameDescriptionCollected Since
vanta integration createdcreated a Vanta integrationAug-12-2022
vanta integration deletedremoved Vanta integrationAug-12-2022
OAuth grant importer for a Google Workspace integration createdcreated a OAuth grant importer for a Google Workspace integration with email {email}May-12-2025
OAuth grant importer for a Google Workspace integration deletedremoved a OAuth grant importer for a Google Workspace integration with email {email}May-12-2025

End user remediation configuration

NameDescriptionCollected Since
end user remediation configuration changedmodified the organization's end user remediation configurationApr-19-2024

Extended device compliance configuration

NameDescriptionCollected Since
extended device compliance configuration changedmodified the organization's extended device compliance configurationMay-31-2025

Device management providers

NameDescriptionCollected Since
device management provider addedAdded a Device Management Provider {name}Jun-3-2024
device management provider updatedUpdated Device Management Provider: {name} from: {old\_settings} to: {new\_settings}Jun-3-2024
device management provider deletedRemoved Device Management Provider: {name}Jun-3-2024

Developers

NameDescriptionCollected Since
api key createdCreated an API keyNov-18-2019
api key secret viewedRevealed full API Key token {name}Nov-18-2019
api key deletedRemoved an API keyNov-18-2019
api key secret rotatedRotated API keyNov-24-2021
updated api keyAPI Key {name} from: {previous\_permissions} to: {new\_permissions}Dec-2-2021
webhook createdCreated webhook with url '{url}'Dec-31-2019
webhook createdCreated webhook with url '{url}'Dec-31-2019
webhook deletedDeleted webhook with url '{url}'Dec-31-2019
webhook enabledEnabled webhook with url '{url}'Dec-31-2019
webhook disabledDisabled webhook with url '{url}'Dec-31-2019
webhook signing secret viewedRevealed full webhook signing secret {url}Jan-27-2022
webhook url changedUpdated webhook url from '{old}' to '{new}'Oct-25-2023
webhook event subscriptions changedUpdated event subscriptions for webhook '{url}' from '{previous\_subscriptions}' to '{new\_subscriptions}'Oct-25-2023
webhook signing secret rolledRolled signing secret for webhook with url '{url}'Nov-12-2021


Published: