Mnemo REST API

Hosted API docs

Public, unmetered HTML generated from this OpenAPI document. Mnemo-owned; no third-party docs runtime.

Responses

curl

curl -sS -X GET '/api/v1/docs'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

This OpenAPI document

Public, unmetered. Agents should generate against this spec.

Responses

curl

curl -sS -X GET '/api/v1/openapi.json'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Formula function catalog

Public, unmetered. Locked 1.9 function set used by formula columns.

Responses

curl

curl -sS -X GET '/api/v1/formulas'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

List pages

Workspace tree visible to the token (ACL- and grant-filtered). Row pages are not listed.

Responses

curl

curl -sS -X GET '/api/v1/pages' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Create page

Optional bodyMarkdown (max 100,000 characters). Optional parentId (null = root). Page links: [[Title|pageId]], or a bare [[Title]], which links the page the token can read with that exact title (any case; the most recently updated wins; no match stays plain text). Callouts open with :::callout info or :::callout type=info and close with :::; kinds are info, success or tip, warning, danger, alert or error, and note, or a colour id (blue, green, yellow, red, purple).

Request body

Responses

curl

curl -sS -X POST '/api/v1/pages' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

List workspace templates

The workspace's saved templates. A document template starts a page (POST /pages), a whiteboard template a board (POST /whiteboards), a database template a database (POST /databases). Saving a template stays in the app.

Responses

curl

curl -sS -X GET '/api/v1/templates' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Get page

Parameters

Responses

curl

curl -sS -X GET '/api/v1/pages/{pageId}' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Update page title/icon

Cover is not writable on this endpoint.

Parameters

Request body

Responses

curl

curl -sS -X PATCH '/api/v1/pages/{pageId}' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Archive page

Parameters

Responses

curl

curl -sS -X DELETE '/api/v1/pages/{pageId}' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Append markdown

content or alias text. Max 100,000 characters. Document pages only. Page links: [[Title|pageId]], or a bare [[Title]], which links the page the token can read with that exact title (any case; the most recently updated wins; no match stays plain text). Callouts open with :::callout info or :::callout type=info and close with :::; kinds are info, success or tip, warning, danger, alert or error, and note, or a colour id (blue, green, yellow, red, purple).

Parameters

Request body

Responses

curl

curl -sS -X POST '/api/v1/pages/{pageId}/content' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Replace markdown

content or alias text. Max 100,000 characters. Document pages only. Page links: [[Title|pageId]], or a bare [[Title]], which links the page the token can read with that exact title (any case; the most recently updated wins; no match stays plain text). Callouts open with :::callout info or :::callout type=info and close with :::; kinds are info, success or tip, warning, danger, alert or error, and note, or a colour id (blue, green, yellow, red, purple).

Parameters

Request body

Responses

curl

curl -sS -X PUT '/api/v1/pages/{pageId}/content' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Pages that need review

Verified pages (2.3). Pages the token can see that are due, changed since verified, or never verified with an interval set. Overdue first.

Responses

curl

curl -sS -X GET '/api/v1/pages/review' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Verification state

Who last vouched for the page, when, the review interval, and the derived freshness.

Parameters

Responses

curl

curl -sS -X GET '/api/v1/pages/{pageId}/verification' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Verify page

Vouch for the page as the token's user (write scope, member role, page grant). Records the snapshot current at this moment. Optional note and interval.

Parameters

Request body

Responses

curl

curl -sS -X POST '/api/v1/pages/{pageId}/verification' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Set review interval

Set or clear the re-verify cadence without verifying.

Parameters

Request body

Responses

curl

curl -sS -X PATCH '/api/v1/pages/{pageId}/verification' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Stop verifying

Clear the stamp and the interval. The page reads as untracked again; past stamps stay in the log.

Parameters

Responses

curl

curl -sS -X DELETE '/api/v1/pages/{pageId}/verification' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Document outline

Headings of a document in order, with levels and stable ids (read scope). Reads the stored document, so an edit a few seconds old may be missing. 400 for databases and whiteboards.

Parameters

Responses

curl

curl -sS -X GET '/api/v1/pages/{pageId}/outline' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

One section of a document

A heading and what follows it, up to the next heading of the same or a higher level, as Markdown (read scope). Take headingId from the page outline. This is the read a section embed makes. Reads the stored document, so an edit a few seconds old may be missing. 404 when the heading is no longer on the page.

Parameters

Responses

curl

curl -sS -X GET '/api/v1/pages/{pageId}/sections/{headingId}' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

List workspace tags

The tag catalog (read scope). Assigning a tag is a separate call.

Responses

curl

curl -sS -X GET '/api/v1/tags' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

List tags on a page

Parameters

Responses

curl

curl -sS -X GET '/api/v1/pages/{pageId}/tags' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Add tags to a page

Adds the named tags and leaves the rest. Write scope, member role, page grant.

Parameters

Request body

Responses

curl

curl -sS -X POST '/api/v1/pages/{pageId}/tags' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Replace tags on a page

Replaces the page's tags with this list. Tags not in the list are removed.

Parameters

Request body

Responses

curl

curl -sS -X PUT '/api/v1/pages/{pageId}/tags' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Remove tags from a page

Removes the named tags and leaves the rest.

Parameters

Request body

Responses

curl

curl -sS -X POST '/api/v1/pages/{pageId}/tags/remove' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Duplicate a page

Copies the page next to the original as Copy of <title>: body, icon, cover, tags and access, and for a database its columns, views and rows. Read grant on the page and write grant on its parent; a limited token cannot copy a top-level page.

Parameters

Responses

curl

curl -sS -X POST '/api/v1/pages/{pageId}/duplicate' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Restore a page from the trash

Write scope and a write grant on the parent the page returns under; a top-level page needs a grant naming it. Restores one page: a page whose parent is still in the trash returns 400, and pages trashed with it stay there. Deleting forever stays in the app.

Parameters

Responses

curl

curl -sS -X POST '/api/v1/pages/{pageId}/restore' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

List the trash

Trashed pages this token could restore, newest first, up to 200. Database rows are not listed.

Responses

curl

curl -sS -X GET '/api/v1/trash' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Move or reorder a page

Write scope and a write grant on the page and on the destination. A limited token cannot move a page to the workspace root. Same-parent reorder does not write an activity row.

Parameters

Request body

Responses

curl

curl -sS -X POST '/api/v1/pages/{pageId}/move' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Run up to 20 operations

One quota charge. Each item returns its own success or error. A failure does not roll back earlier items. Nested batch is rejected. ops: add_page_tags, remove_page_tags, set_page_tags, move_page, resolve_comment, unresolve_comment, delete_comment, update_page, restore_page, create_comment, add_whiteboard_shape, update_whiteboard_shape, delete_whiteboard_shape, create_database_view, update_database_view, delete_database_view, move_runbook_step, remove_runbook_step, verify_page.

Request body

Responses

curl

curl -sS -X POST '/api/v1/batch' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

What changed in the workspace

The change history, newest first (read scope): pages created, renamed, moved, trashed, restored, verified or unverified, bodies edited, and database rows added, each with when and by whom. Only pages the token's owner can open and the token is granted. Body edits are one entry per editor per quiet spell, not per keystroke. To poll, ask again with since set to the newest at you hold. Pass nextCursor back as cursor for the next page; a page can be empty and still carry a nextCursor, so follow the cursor until it is null.

Parameters

Responses

curl

curl -sS -X GET '/api/v1/activity' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Subscribe to page activity

Server-sent events for a Bearer token. Each event is { pageId, kind, at } only. The same grant and page access as list activity apply. Titles and row bodies are not on this stream.

Responses

curl

curl -sS -X GET '/api/v1/live' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Page link neighbors

Incoming and outgoing page links from one page, depth at most 2. Archived pages and pages the token cannot open are omitted.

Parameters

Responses

curl

curl -sS -X GET '/api/v1/graph' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Search pages and database rows

Returns { results, rows, files }. results are pages (limit 20 with q, 12 without). rows are cell-value hits (empty when q is blank, limit 12). files are uploaded PDF, Word and text files whose name or text matches (limit 10), each with its page and a snippet; empty when q is blank or types / tags is set. types is comma-separated document|database|whiteboard (unknown values ignored). tags is comma-separated workspace tag ids (OR).

Parameters

Responses

curl

curl -sS -X GET '/api/v1/search' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

List a page's files

Read scope + page grant. text is ready, pending (not read yet), empty, unreadable, or not_text (images, spreadsheets, zips).

Parameters

Responses

curl

curl -sS -X GET '/api/v1/pages/{pageId}/attachments' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Read a file's text

The text inside an uploaded PDF, Word (.docx) or text file, in windows. Read scope + grant on the file's page. A file not read yet is read on this call. Up to 200,000 characters per file are kept; scanned PDFs have none.

Parameters

Responses

curl

curl -sS -X GET '/api/v1/attachments/{attachmentId}/text' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

List databases

Responses

curl

curl -sS -X GET '/api/v1/databases' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Create database

Request body

Responses

curl

curl -sS -X POST '/api/v1/databases' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

List database rows

databaseId may be the database id, the host page id, or a unique title. Results are always paged: limit defaults to 80 and is capped at 200. When nextCursor is not null, request again with cursor set to it (and the same filter, sortPropId and sortDir) for the next page; totalCount is the filtered total.

Parameters

Responses

curl

curl -sS -X GET '/api/v1/databases/{databaseId}/rows' \
  -H 'Authorization: Bearer $MNEMO_TOKEN'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Create database row

Parameters

Request body

Responses

curl

curl -sS -X POST '/api/v1/databases/{databaseId}/rows' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Update database row

Parameters

Request body

Responses

curl

curl -sS -X PATCH '/api/v1/databases/{databaseId}/rows/{rowId}' \
  -H 'Authorization: Bearer $MNEMO_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response will appear here. Requests stay on this origin. The token is not sent anywhere else.

Delete database row

Parameters

Responses