GET
/api/v1/users/{user}:getStatsGet user statistics
Retrieves statistics for a specific user, including memo counts, tag counts, memo timestamps, and pinned memos. Use filter to select readable non-comment memos using a CEL expression compatible with ListMemos.
userstringrequired
The identifier of the user whose statistics to retrieve.
filterstringoptional
A CEL expression selecting readable non-comment memos to include. Supports the same fields as ListMemos, including `space`.
200Returns user statistics, including memo type statistics, tag counts, memo creation and update timestamps, pinned memos, and total memo count. For the authenticated user's own statistics, the response also includes total persisted attachment storage bytes, independently of the memo filter.
namestringoptional
The resource name of the user statistics singleton.
Format: users/{user}/stats
memoTypeStatsobjectoptional
The stats of memo types.
tagCountobjectoptional
The count of tags.
memoCreatedTimestampsarray<string>optional
The creation timestamps of the user's memos.
memoUpdatedTimestampsarray<string>optional
The latest update timestamps of the user's memos (one per memo,
mirrors memo_created_timestamps). Used by the activity heatmap when
the client's view is set to update_time basis.
pinnedMemosarray<string>optional
The pinned memos of the user.
totalMemoCountintegeroptional
Total memo count.
attachmentStorageBytesstringoptional
Total persisted attachment size in bytes, including unlinked uploads and
attachments in all spaces. Excludes temporary uploads and derived files.
Returned only by GetUserStats for the authenticated user's own stats,
independently of the request's memo filter.
defaultReturned when the request fails. The response contains a status code, a developer-facing message, and optional error details.
codeintegeroptional
The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
messagestringoptional
A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
detailsarray<object>optional
A list of messages that carry the error details. There is a common set of message types for APIs to use.
Error handling
The user path parameter identifies the user whose statistics to retrieve. If supplied, filter must be a CEL expression selecting readable non-comment memos, using the same supported fields as ListMemos.