Skip to main content

Events

An event is an access-related action that occurs within an organization and its resources. A door being unlocked, access being shared to a user, a scheduled unlock starting, a door forced open and other actions will be recorded as events.

The event recording is called Event Log and it will save the member responsible for the event, the event that occurred, and the date and time of it.

This Event Log is easily accessible from the admin dashboard, which gives the administrators an audit trail with a highly granular level of detail to allow for tracing security-related events back to their source.

Events can be seen in real-time, filtered, and exported. Filters can be done by time, user, access groups, or specific access point. If a door or access point has been forced open, and the system installation includes contact sensors, admins will receive a notification to their mobiles.

In some cases, events can trigger additional actions, for example, fetching snapshots from a camera connected to the door. Through integrations, events can also be forwarded to external 3rd party services.

Event exports#

In the admin dashboard, the events page will show the last 100 events for each place. The advanced filters can be used to narrow down those results. The option Event Exports allows you to obtain a longer history of events. This will download a .csv file with the last 10,000 events. Once the .csv file has been downloaded, the document can be filtered to search for a member email address, lock, etc.

Event types#

For a full list of all the types of events that can be created by the Kisi Platform, see the Events Metadata Endpoint. You can use this curl call to get the list from the API:

curl --location --request GET 'https://api.kisi.io/events/meta' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: KISI-LOGIN {authentication_token}' \
--data-raw ''

Each event will have some available actions. The events and actions that the previous call will show you are the following:

  • "AlertPolicy"
    • "create"
    • "destroy"
    • "update"
  • "AlertPolicySubscription"
    • "create"
    • "destroy"
    • "update"
  • "Beacon"
    • "update"
  • "Camera"
    • "destroy"
    • "import"
    • "update"
  • "Card"
    • "activate"
    • "activate_with_token"
    • "assign"
    • "assign_member"
    • "deactivate"
    • "deactivate_with_token"
    • "deassign"
    • "deassign_member"
    • "disenroll"
    • "enroll"
  • "CardReader"
    • "update"
  • "ContactSensor"
    • "closed"
    • "opened"
    • "update"
  • "Credential"
    • "create"
    • "destroy"
    • "update"
  • "Elevator"
    • "create"
    • "destroy"
    • "permit"
  • "ElevatorStop"
    • "create"
    • "destroy"
    • "scheduled_permit_ended"
    • "scheduled_permit_started"
    • "update"
  • "EventExport"
    • "create"
    • "download"
    • "finished"
  • "Gateway"
    • "assign"
    • "deassign"
    • "disenroll"
    • "enroll"
    • "update"
  • "Group"
    • "create"
    • "destroy"
    • "update"
  • "GroupElevatorStop"
    • "create"
    • "destroy"
  • "GroupLock"
    • "create"
    • "destroy"
  • "Integration"
    • "create"
    • "destroy"
    • "disable_due_to_error"
    • "warn_due_to_error"
    • "update"
  • "Lock"
    • "cancel_lockdown"
    • "closed"
    • "create"
    • "destroy"
    • "forced_open"
    • "held_open"
    • "lock_down"
    • "locked"
    • "opened"
    • "scheduled_unlock_ended"
    • "scheduled_unlock_started"
    • "unlock"
    • "update"
  • "Login"
    • "create"
    • "destroy"
    • "destroy_current"
    • "offline_certificate"
    • "promote"
    • "promote_current"
    • "resolve"
    • "sign_in"
    • "sign_out"
    • "update_current"
  • "Member"
    • "assign_backup_card"
    • "assign_card"
    • "create"
    • "deassign_backup_card"
    • "deassign_card"
    • "destroy"
    • "disable_backup_card"
    • "disable_card"
    • "enable_backup_card"
    • "enable_card"
    • "update"
  • "MemberExport"
    • "create"
    • "download"
    • "finished"
  • "Organization"
    • "update"
  • "Place"
    • "accept_transfer"
    • "cancel_transfer"
    • "create"
    • "destroy"
    • "reject_transfer"
    • "request_transfer"
    • "update"
  • "Relay"
    • "update"
  • "RequestToExit"
    • "update"
    • "triggered"
  • "Share"
    • "create"
    • "destroy"
    • "update"
  • "Subscription"
    • "cancel"
    • "update"
  • "User"
    • "activate_2fa"
    • "create"
    • "create_backup_codes"
    • "create_confirmation"
    • "create_password"
    • "create_with_token"
    • "deactivate_2fa"
    • "destroy_current"
    • "destroy_registration"
    • "show_confirmation"
    • "update_current"
    • "update_password"
    • "update_registration"
  • "CsvUserImport"
    • "create"
  • "WirelessLock"
    • "battery_warning"
    • "closed"
    • "disenroll"
    • "enroll"
    • "locked"
    • "opened"
    • "tampered"
    • "unlocked"
    • "update"
  • "Zone"
    • "create"
    • "update"
    • "destroy"
    • "policy_activate"
    • "policy_override"
    • "policy_transition"
    • "policy_violate"
    • "reset"