Import Memos

ImportMemos uploads a Memos export file in bounded chunks and imports it into the user's memos. The first call carries the spec and returns an upload_id; later calls carry that upload_id. A finishing call with validate_only returns the plan and keeps the archive staged; a finishing call without it imports and returns the report. Uploads are bound to the authenticated user, expire after 30 minutes of inactivity, and do not survive a server restart.

Path Parameters

user*string

The user id.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Required. The user who receives the memos. Must be the caller. Format: users/{user}

spec?

Starts a new upload. The same call may also carry data and finish_write.

uploadId?string

Continues the upload identified by a previous response.

writeOffset*string

Required. Zero-based byte offset at which data is written. Must equal the committed size, except when retrying the most recently accepted chunk with identical bytes and offset, which is accepted without writing again.

data?string

Optional. Archive bytes, at most max_chunk_size long. With no data and finish_write false, the call reports progress without writing, and write_offset is ignored.

Formatbytes

finishWrite?boolean

Optional. Finish the upload after writing data. The committed size must then equal total_size. The archive is validated and, unless validate_only is set, imported. Any later call for an imported upload returns the same report.

validateOnly?boolean

Optional. On a finishing call, validate the archive and return the plan without importing. The upload stays staged so a later finishing call can import it.

conflictPolicy?string

Optional. Read on the finishing call that imports. Unspecified means SKIP.

Formatenum

Value in

"CONFLICT_POLICY_UNSPECIFIED"
"SKIP"
"REPLACE"
"DUPLICATE"

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/users/string:importMemos" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "writeOffset": "string"  }'

{  "uploadId": "string",  "committedSize": "string",  "maxChunkSize": 0,  "plan": {    "exportTime": "2019-08-24T14:15:22Z",    "exporter": "string",    "generator": "string",    "memos": 0,    "attachments": 0,    "new": 0,    "existing": 0,    "renamed": 0,    "warnings": [      {        "memo": "string",        "message": "string"      }    ]  },  "report": {    "created": 0,    "updated": 0,    "skipped": 0,    "failed": 0,    "warnings": [      {        "memo": "string",        "message": "string"      }    ],    "failures": [      {        "memo": "string",        "message": "string"      }    ]  }}

Get User Webhook Signing Secret

GetUserWebhookSigningSecret returns the signing secret for a webhook. The secret is returned only through this explicit, owner-gated call; it is never included in List/Create/Update responses.

List All User Stats

ListAllUserStats returns statistics for all users.

Import Memos

Path Parameters

Request Body

Response Body

200application/json

defaultapplication/json

`application/json`

`application/json`