# Keep Notes API

**Canonical:** https://apis.io/apis/keep-md/keep-md-notes-api/  
**Provider:** Keep — https://apis.io/providers/keep-md/  
**Base URL:** https://keep.md  
**Documentation:** https://keep.md/docs/api

Keep Notes API is one of 11 APIs that [Keep](https://apis.io/providers/keep-md/) 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 Notes. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

The Notes API from Keep — 13 operation(s) for notes.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/notes` | List Notes |
| POST | `/api/notes` | Create a Note |
| GET | `/api/notes/search` | Search Notes by text |
| GET | `/api/notes/export` | Download all Notes as a Markdown ZIP |
| GET | `/api/notes/{id}` | Get a Note as JSON or Markdown |
| PATCH | `/api/notes/{id}` | Update a Note with revision conflict protection |
| GET | `/api/notes/{id}/read` | Read a Note overview, line range, or search window |
| POST | `/api/notes/{id}/append` | Append Markdown to a Note |
| POST | `/api/notes/{id}/archive` | Archive a Note |
| POST | `/api/notes/{id}/restore` | Restore a Note |
| GET | `/api/notes/{id}/history` | List Note revisions |
| POST | `/api/notes/{id}/revisions/{revision}/restore` | Restore an older revision as a new revision |
| POST | `/api/notes/{id}/item-links` | Attach an Item or Highlight to a Note |
| DELETE | `/api/notes/{id}/item-links/{linkId}` | Remove an Item attachment from a Note |
| GET | `/api/notes/{id}/context` | Get a Note with bounded attached Item context |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/keep-md/openapi/keep-md-notes-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/keep-md/json-schema/keep-md-note-write-request-schema.json

## Other Keep APIs (10)

- [Keep Account API](https://apis.io/apis/keep-md/keep-md-account-api/)
- [Keep Clients and tokens API](https://apis.io/apis/keep-md/keep-md-clients-and-tokens-api/)
- [Keep Exports API](https://apis.io/apis/keep-md/keep-md-exports-api/)
- [Keep Highlights API](https://apis.io/apis/keep-md/keep-md-highlights-api/)
- [Keep Items API](https://apis.io/apis/keep-md/keep-md-items-api/)
- [Keep Projects API](https://apis.io/apis/keep-md/keep-md-projects-api/)
- [Keep Search API](https://apis.io/apis/keep-md/keep-md-search-api/)
- [Keep Sources API](https://apis.io/apis/keep-md/keep-md-sources-api/)
- [Keep Tags and collections API](https://apis.io/apis/keep-md/keep-md-tags-and-collections-api/)
- [Keep Webhooks API](https://apis.io/apis/keep-md/keep-md-webhooks-api/)

## Tags

Notes

---

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