getTimeBuckets

getTimeBuckets

Query Parameters
albumId uuid Filter assets belonging to a specific album
isFavorite boolean Filter by favorite status (true for favorites only, false for non-favorites only)
isTrashed boolean Filter by trash status (true for trashed assets only, false for non-trashed only)
key string
order string Possible values: [asc, desc] Sort order for assets within time buckets (ASC for oldest first, DESC for newest first)
personId uuid Filter assets containing a specific person (face recognition)
tagId uuid Filter assets with a specific tag
userId uuid Filter assets by specific user ID
visibility string Possible values: [archive, timeline, hidden, locked] Filter by asset visibility status (ARCHIVE, TIMELINE, HIDDEN, LOCKED)
withPartners boolean Include assets shared by partners
withStacked boolean Include stacked assets in the response. When true, only primary assets from stacks are returned.

Responses
200 Schema — OPTIONAL object[] count integer Number of assets in this time bucket timeBucket string Time bucket identifier in YYYY-MM-DD format representing the start of the time period