v52

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

CreateMemo creates a memo. The request body is a Memo; set its content (Markdown) and visibility (PRIVATE | PROTECTED | PUBLIC, default PRIVATE). The memo is owned by the authenticated user; requires authentication.

post/api/v1/memos

Query parameters

memoIdstring

Optional. The memo ID to use for this memo. If empty, a unique ID will be generated. Format: ^a-zA-Z0-9?$

Request body

namestring

The resource name of the memo. Format: memos/{memo}, where memo is the user-defined UID.

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

The state of the memo.

creatorstring

The name of the creator. Format: users/{user}

createTimestring date-time

The creation timestamp. If not set on creation, the server will set it to the current time.

updateTimestring date-time

The last update timestamp. If not set on creation, the server will set it to the current time.

contentstring required

Required. The content of the memo in Markdown format.

visibility'VISIBILITY_UNSPECIFIED' | 'PRIVATE' | 'PROTECTED' | 'PUBLIC' enum required

The visibility of the memo. One of PRIVATE (creator only), PROTECTED (signed-in users), or PUBLIC (anyone). Defaults to PRIVATE on creation when unspecified.

tagsstring[]

Output only. The tags extracted from the content.

pinnedboolean

Whether the memo is pinned.

parentstring

Output only. The name of the parent memo. Format: memos/{memo}

snippetstring

Output only. The snippet of the memo content. Plain text only.

Response

OK

namestring

The resource name of the memo. Format: memos/{memo}, where memo is the user-defined UID.

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

The state of the memo.

creatorstring

The name of the creator. Format: users/{user}

createTimestring date-time

The creation timestamp. If not set on creation, the server will set it to the current time.

updateTimestring date-time

The last update timestamp. If not set on creation, the server will set it to the current time.

contentstring required

Required. The content of the memo in Markdown format.

visibility'VISIBILITY_UNSPECIFIED' | 'PRIVATE' | 'PROTECTED' | 'PUBLIC' enum required

The visibility of the memo. One of PRIVATE (creator only), PROTECTED (signed-in users), or PUBLIC (anyone). Defaults to PRIVATE on creation when unspecified.

tagsstring[]

Output only. The tags extracted from the content.

pinnedboolean

Whether the memo is pinned.

parentstring

Output only. The name of the parent memo. Format: memos/{memo}

snippetstring

Output only. The snippet of the memo content. Plain text only.