vaults

Wrapper around vault file sync. action=list|pull|push to work against the primary vault. list/pull are paginated — narrow with `path`/`since` and follow `next_cursor` instead of pulling the whole vault. To fetch specific files, pull with `paths` (up to 100 exact paths, one call). For push: WAF-bypass via `content_b64` or `content: '__B64__:...'` prefix (mirrors sync_push).

Wrapper around vault file sync. action=list|pull|push to work against the primary vault. list/pull are paginated — narrow with path/since and follow next_cursor instead of pulling the whole vault. To fetch specific files, pull with paths (up to 100 exact paths, one call). For push: WAF-bypass via content_b64 or content: '__B64__:...' prefix (mirrors sync_push).

post/api/mcp/tools/vault_sync

Request

  • Base URL: https://api.ainote.dev
  • URL: https://api.ainote.dev/api/mcp/tools/vault_sync
  • Auth: API key in header Authorization

Request body

action'list' | 'pull' | 'push'

Sync action. Default list.

pathstring

push: target file path. list/pull: a directory (everything under it, e.g. 'global') or an exact file path (e.g. 'global/MEMORY.md'); a trailing slash is ignored.

pathsstring[]

pull only: up to 100 exact file paths fetched in ONE call. The response lists absent paths in missing. Cannot be combined with path/since/cursor.

contentstring

Required for push (or content_b64). Prefix with 'B64:' for WAF bypass.

content_b64string

Optional: base64-encoded content (use INSTEAD of content) for WAF-bypass on large bodies. Server decodes before storing.

sincestring

ISO 8601 timestamp for incremental list/pull (files updated strictly after it). Deletions are not reported — compare a full list against your local copy to find them.

limitinteger

Max entries per page. list: default 200, max 1000. pull: default 25, max 100.

cursorstring

Pass next_cursor from the previous response to fetch the next page.

Response

Tool executed successfully

Changes

No recorded changes to this operation across all 1 revision of this API.