Memos unofficial
GET/api/v1/memos

List memos

Lists readable, non-comment memos, with support for pagination, filtering, and sorting. Use filter to select memos and orderBy to control their order; pageToken continues a listing from a previous response.

6 parameters
pageSizeintegeroptional
Maximum number of memos to return; the service may return fewer. Defaults to 50 when omitted and values above 1000 are coerced to 1000.
pageTokenstringoptional
Page token from a previous response to retrieve the next page.
statestringoptional
Memo state to list: STATE_UNSPECIFIED, NORMAL, or ARCHIVED. Defaults to NORMAL when omitted.
Allowed:STATE_UNSPECIFIEDNORMALARCHIVED
orderBystringoptional
Comma-separated sort fields and directions. Supports pinned, create_time, update_time, and name; defaults to `create_time desc` when omitted.
filterstringoptional
CEL expression for filtering memos. Supported fields include content, creator, created_ts, updated_ts, pinned, visibility, space, tags, and memo property flags.
showDeletedbooleanoptional
Set to true to include deleted memos in the response. Defaults to false when omitted.

2 status codes
200Returns a list of memo resources and a `nextPageToken` when another page is available.
memosarray<object>optional
The list of memos.
nextPageTokenstringoptional
A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
defaultReturned when the request fails; includes an error 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

pageSize is capped at 1000 and defaults to 50 when omitted. state must be STATE_UNSPECIFIED, NORMAL, or ARCHIVED; filter must be a CEL expression using supported memo fields, and orderBy supports pinned, create_time, update_time, and name.