POST /api/v1/memos — untitled-api

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

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' | 'SPACE' enum required

The visibility of the memo. One of PRIVATE (creator only), PROTECTED (signed-in users), PUBLIC (anonymous-eligible), or SPACE (active space members). 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 readable context memo of this COMMENT relation, if any. This is omitted unless the caller may independently read both memos. Format: memos/{memo}

snippetstring

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

spacestring

Optional. The space in which this memo is placed. Format: spaces/{space}. Every memo, including a comment, owns its placement independently.

Response

OK