# Keep Items API

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

Keep Items 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 2 JSON Schema definitions. Tagged areas include Item. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

The Items API from Keep — 13 operation(s) for items.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/items` | List saved Items |
| GET | `/api/items/search` | Search saved Items |
| GET | `/api/items/{id}` | Get one Item with available content, highlights, and Note links |
| POST | `/api/items/{id}` | Update Item metadata, collections, archive state, or processed state |
| GET | `/api/items/{id}/content` | Get rendered Item Markdown |
| GET | `/api/items/{id}/read` | Read an Item overview, search window, line range, or full document |
| GET | `/api/items/{id}/media` | List one bounded page of ordered Item media references |
| GET | `/api/items/{id}/media/{mediaId}` | Get one directly uploaded Item image |
| POST | `/api/ingest` | Save and extract one URL |
| POST | `/api/items/archive` | Archive Items |
| POST | `/api/items/delete` | Permanently delete Items |
| GET | `/api/feed` | List unprocessed Items with available content |
| POST | `/api/items/mark-processed` | Mark Items as processed |
| GET | `/api/items/changes` | List cursor-based Item changes for delta sync |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/keep-md/openapi/keep-md-items-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/keep-md/json-schema/keep-md-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/keep-md/json-schema/keep-md-item-change-event-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 Notes API](https://apis.io/apis/keep-md/keep-md-notes-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

Item

---

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