# ainote Sync API

**Canonical:** https://apis.io/apis/ainote-dev/ainote-dev-sync-api/  
**Provider:** ainote — https://apis.io/providers/ainote-dev/  
**Base URL:** https://api.ainote.dev  
**Documentation:** https://docs.ainote.dev/reference/

ainote Sync API is one of 7 APIs that [ainote](https://apis.io/providers/ainote-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Sync. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

The sync API from ainote — 10 operation(s) for sync.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/mcp/tools/sync_push` | Push a markdown file into the primary vault. |
| POST | `/api/mcp/tools/sync_push_batch` | Push MANY files into the primary vault in ONE call. |
| POST | `/api/mcp/tools/sync_pull` | Legacy alias for pulling files from the primary vault. |
| POST | `/api/mcp/tools/sync_list` | Legacy alias for listing files in the primary vault. |
| POST | `/api/mcp/tools/sync_changes` | Read changes from the primary vault in sequence order, including deletions. |
| POST | `/api/mcp/tools/sync_delete` | Delete a file from the primary vault. |
| POST | `/api/mcp/tools/sync_merge` | Compute a stateless 3-way merge for a vault file. |
| POST | `/api/mcp/tools/sync_diff` | Return the unified diff (and raw remote text) of a vault file. |
| POST | `/api/mcp/tools/sync_pending_conflicts` | List unresolved vault_conflicts rows for the authenticated user's primary vault. |
| POST | `/api/mcp/tools/sync_audit_layer5` | Record the result of a client-side Layer 5 codex review (sync.py merge gate) as… |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/ainote-dev/openapi/ainote-dev-sync-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ainote-dev/json-schema/ainote-dev-tool-success-response-schema.json

## Other ainote APIs (6)

- [ainote Dev Docs API](https://apis.io/apis/ainote-dev/ainote-dev-dev-docs-api/)
- [ainote Handoffs API](https://apis.io/apis/ainote-dev/ainote-dev-handoffs-api/)
- [ainote Misc API](https://apis.io/apis/ainote-dev/ainote-dev-misc-api/)
- [ainote Onboarding API](https://apis.io/apis/ainote-dev/ainote-dev-onboarding-api/)
- [ainote Tasks API](https://apis.io/apis/ainote-dev/ainote-dev-tasks-api/)
- [ainote Vaults API](https://apis.io/apis/ainote-dev/ainote-dev-vaults-api/)

## Tags

Sync

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ainote-dev/ainote-dev-sync-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ainote-dev/.