Memos

Create Memo

CreateMemo creates a memo owned by the authenticated user. The request body is a Memo; set its Markdown content and visibility (defaults to PRIVATE). Requires authentication.

POST
/api/memos

Query Parameters

memoId?string

Optional. The ID to use for the memo, which becomes the final segment of its resource name. If empty, a unique ID is generated. Format: ^a-zA-Z0-9?$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Memo is a Markdown note written by a user.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/memos" \  -H "Content-Type: application/json" \  -d '{    "content": "string",    "visibility": "VISIBILITY_UNSPECIFIED",    "state": "STATE_UNSPECIFIED"  }'
{  "name": "string",  "creator": "string",  "space": "string",  "content": "string",  "location": {    "placeholder": "string",    "latitude": 0.1,    "longitude": 0.1  },  "visibility": "VISIBILITY_UNSPECIFIED",  "state": "STATE_UNSPECIFIED",  "pinned": true,  "attachments": [    {      "name": "string",      "creator": "string",      "filename": "string",      "type": "string",      "content": "string",      "externalLink": "string",      "motionMedia": {        "family": "MOTION_MEDIA_FAMILY_UNSPECIFIED",        "role": "MOTION_MEDIA_ROLE_UNSPECIFIED",        "groupId": "string",        "presentationTimestampUs": "string",        "hasEmbeddedVideo": true      },      "mediaMetadata": {        "width": 0,        "height": 0,        "photo": {          "captureTime": {            "localDateTime": "string",            "utcOffset": "string"          },          "location": {            "latitude": 0.1,            "longitude": 0.1,            "altitudeMeters": 0.1          },          "sourceExifOrientation": 0,          "cameraMake": "string",          "cameraModel": "string",          "lensModel": "string",          "fNumber": 0.1,          "exposureTimeSeconds": 0.1,          "iso": 0,          "focalLengthMm": 0.1        },        "video": {          "durationSeconds": 0.1        }      },      "memo": "string",      "size": "string",      "createTime": "2019-08-24T14:15:22Z"    }  ],  "relations": [    {      "memo": {        "name": "string",        "snippet": "string"      },      "relatedMemo": {        "name": "string",        "snippet": "string"      },      "type": "TYPE_UNSPECIFIED"    }  ],  "reactions": [    {      "name": "string",      "creator": "string",      "reactionType": "string",      "createTime": "2019-08-24T14:15:22Z"    }  ],  "parent": "string",  "tags": [    "string"  ],  "property": {    "title": "string",    "hasLink": true,    "hasCode": true,    "hasTaskList": true,    "hasIncompleteTasks": true  },  "snippet": "string",  "createTime": "2019-08-24T14:15:22Z",  "updateTime": "2019-08-24T14:15:22Z"}

Batch Get Link Metadata

BatchGetLinkMetadata fetches the metadata of up to 10 links.

Create Memo Comment

CreateMemoComment atomically creates an independent memo plus one immutable COMMENT context relation to the named memo. The new memo keeps its own placement, visibility, authorship, and lifecycle. The named memo must be readable by the caller and not archived.