Event log

Every time something is created, updated, or deleted, we generate an event.

These events can be used to restore items to a previous state, or simply for auditing purposes.

Viewing events

We can view events for a specific object using the following endpoints:

Fetch events for a list

Get a paginated list of events for a specific list.

Fetch events for an item

Get a paginated list of events for a specific item.

Fetch events for an index

Get a paginated list of events for a specific index.

Event object

{id: "a7048a78-9f20-47d9-89ef-57e42909ec4b"
createdAt: "2026-09-23T21:07:58.512Z"
updatedAt: "2026-09-23T21:07:58.512Z"
user: {id: "cb8d447f-086f-4b08-95ca-b81b03b8ea2f"
createdAt: "2026-09-23T21:07:58.512Z"
updatedAt: "2026-09-23T21:07:58.512Z"
lastActiveAt: "2026-09-23T21:07:58.512Z"
activated: true
displayName: "Sample User"
description: "Sample user description"
}
modelId: "c9ff4e9e-bc5b-485f-a1aa-016066ae61c1"
stream: "list"
type: "list-created"
version: null
snapshot: {
}
attachments: {
}
}

idstringUnique identifier for the event.
createdAtstringDate and time the event was created in ISO 8601 format.
updatedAtstring
Date and time the event was last updated in ISO 8601 format.
Events are generally immutable, so this will be the same as thecreatedAt value. There might be situations where the event is updated, such as correcting a mistake or adding additional information.
userobjectThe user who created the event.
User attributes
- idstringUnique identifier for the user.
- createdAtstringDate and time the user registered in ISO 8601 format.
- updatedAtstringDate and time the user was last updated in ISO 8601 format.
- lastActiveAtstringDate and time the user was last active in ISO 8601 format.
- activatedbooleanWhether the user account is activated.
- displayNamestringThe user's display name.
- descriptionstringThe user's description.
modelIdstringThe id of the object affected by this event.
streamstring
The type of object affected by this event.
Events for an identity are only returned by its own events endpoint, and never include an identity's email address in token auth mode.
Valid values are:
- list
- item
- index
- identity
typestring
The type of this event.
Valid values are:
- list-created
- list-updated
- list-deleted
- item-created
- item-updated
- item-deleted
- item-restored
- index-created
- index-updated
- index-deleted
- index-built
- index-build-failed
- index-build-requested
- identity-created
- identity-updated
- identity-updated-self
- identity-registered
- identity-logged-in
- identity-logged-out
- identity-sessions-revoked
- identity-password-reset-requested
- identity-password-reset
- identity-email-verification-requested
- identity-email-verified
- identity-provider-linked
- identity-provider-unlinked
versionstringIf this event is for an item, this will contain the item's version at the time this event was created.
snapshotnullable object
A snapshot of the object taken before the event was created.
Snapshots can be large, so they are only returned when the request includes includeSnapshot=true.
attachmentsnullable object
Metadata attached to the event.
Generally this will contain request data (e.g. request body, parameters).
For partial updates (e.g. JSON Patch operations) this is the only record of how the object changed, as opposed to what it became.
Like snapshots, attachments are only returned when the request includes includeAttachments=true.

2026-09-17