MemoService

ListMemos lists the memos the caller can read, excluding comments. Anonymous callers can list only when the instance allows public access.

Request

  • The document declares no server URL.
  • Auth
    none declared

Query parameters

pageSizeinteger

Optional. The maximum number of memos to return. The service may return fewer. Defaults to 50; values above 1000 are coerced to 1000.

pageTokenstring

Optional. A page token from a previous call. Provide it to retrieve the next page.

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 | SPACE), space (string resource name, or null when the memo has no space; supports == and comparisons against null, e.g. space != null), tags (list<string>; match with "work" in tags, not tag == "work"), has_task_list / has_link / has_code / has_incomplete_tasks (bool), has_location (bool; true when the memo has a location attached), has_attachments (bool; true when a file is attached to the memo), has_image (bool; true when the content contains a Markdown image or an image file is attached). 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" space == "spaces/team" or space == null tags.exists(t, t == "urgent") content.contains("roadmap") && created_ts > now - duration("168h")

orderBystring

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

showDeletedboolean

Optional. Whether to include deleted memos. Currently ignored by the server.

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

Optional. The state of the memos to list. Defaults to NORMAL. Set to ARCHIVED to list the caller's own archived memos.

Response

OK

nextPageTokenstring

A token to retrieve the next page. Empty when there are no more pages.

Changes