List entity change events (v2)

Retrieves a list of entity change events for syncing.

Events are lightweight records indicating that entities have changed. Each event contains the entity type, entity ID, and event type (e.g., “asset_created”, “album_deleted”). Clients should fetch full entity data from the appropriate endpoints if needed.

Pagination: Use the after_cursor parameter with the cursor value from the last event to fetch the next page. The has_more field indicates if more events exist.

Recommended sync pattern:

1. Capture current time as sync_end
2. Fetch events with created_at_lt=sync_end
3. For subsequent pages, use after_cursor={last.cursor}&created_at_lt=sync_end
4. Continue until has_more=false
5. For each event, fetch the entity data from the appropriate endpoint if needed
6. Store sync_end as checkpoint for next sync

Handling deletions: When event_type ends with “_deleted” or “_removed”, the entity no longer exists. Remove it from your local cache/database. Some deletion events include a payload field with additional context (e.g., album_asset_removed includes album_id and asset_id since the junction record is deleted).

Event types:

• asset_created, asset_updated, asset_deleted
• album_created, album_updated, album_deleted
• person_created, person_updated, person_deleted
• face_created, face_updated, face_deleted
• album_asset_added, album_asset_removed
• exif_created, exif_updated