v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-037389158.9 KB
MemoService

ListMemos lists memos with pagination and filter.

get/api/v1/memos

Query parameters

pageSizeinteger

Optional. The maximum number of memos to return. The service may return fewer than this value. If unspecified, at most 50 memos will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageTokenstring

Optional. A page token, received from a previous ListMemos call. Provide this to retrieve the subsequent page.

state'STATE_UNSPECIFIED' | 'NORMAL' | 'ARCHIVED' enum

Optional. The state of the memos to list. Default to NORMAL. Set to ARCHIVED to list archived memos.

orderBystring

Optional. The order to sort results by. Default to "create_time desc". Supports comma-separated list of fields following AIP-132. Example: "pinned desc, create_time desc" or "update_time asc" Supported fields: pinned, create_time, update_time, name. Note: order_by uses create_time / update_time, while the filter expression uses created_ts / updated_ts for the same timestamps.

filterstring

Optional. A CEL expression to filter memos. Combine terms with && and ||. Available fields: content (string), creator (string, e.g. "users/1"), created_ts / updated_ts (timestamp), pinned (bool), visibility (string: PRIVATE | PROTECTED | PUBLIC), tags (list<string>; match with "work" in tags, not tag == "work"), has_task_list / has_link / has_code / has_incomplete_tasks (bool). Note: the time fields here are created_ts / updated_ts, which differ from the create_time / update_time names used by order_by. Examples: pinned == true && visibility == "PUBLIC" tags.exists(t, t == "urgent") content.contains("roadmap") && created_ts > now - duration("168h")

showDeletedboolean

Optional. If true, show deleted memos in the response.

Response

OK

nextPageTokenstring

A token that can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.