# Karakeep API

**Canonical:** https://apis.io/apis/karakeep/karakeep-api/  
**Provider:** Karakeep — https://apis.io/providers/karakeep/  
**Documentation:** https://docs.karakeep.com/api/get-tag

Karakeep API is one of 2 APIs that [Karakeep](https://apis.io/providers/karakeep/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Karakeep API as documented publicly: 28 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| PUT | `/admin/users/{userid}` | Update a user's role, bookmark quota, storage quota, or browser crawling setting. |
| POST | `/assets` | Upload a new asset |
| GET | `/backups` | Get all backups |
| GET | `/bookmarks` | Get all bookmarks |
| POST | `/bookmarks` | Create a new bookmark |
| DELETE | `/bookmarks/{bookmarkid}` | Permanently delete a bookmark and all its associated data (tags, highlights, assets). |
| GET | `/bookmarks/{bookmarkid}` | Retrieve a single bookmark by its ID, including its tags, content, and assets. |
| PATCH | `/bookmarks/{bookmarkid}` | Partially update a bookmark. |
| GET | `/bookmarks/{bookmarkid}/lists` | Retrieve all lists that contain the specified bookmark. |
| POST | `/bookmarks/{bookmarkid}/summarize` | Trigger AI summarization for a bookmark. |
| GET | `/highlights` | Get all highlights |
| POST | `/highlights` | Create a new highlight |
| DELETE | `/highlights/{highlightid}` | Delete a highlight by its ID. |
| GET | `/highlights/{highlightid}` | Retrieve a single highlight by its ID. |
| PATCH | `/highlights/{highlightid}` | Partially update a highlight. Supports changing the color or note. |
| GET | `/lists` | Get all lists |
| POST | `/lists` | Create a new list |
| DELETE | `/lists/{listid}` | Delete a list. |
| GET | `/lists/{listid}` | Retrieve a single list by its ID. |
| PATCH | `/lists/{listid}` | Partially update a list. Only the fields provided in the request body will be updated. |
| GET | `/lists/{listid}/bookmarks` | Get bookmarks in a list |
| GET | `/tags` | Retrieve a paginated list of all tags. |
| POST | `/tags` | Create a new tag. |
| DELETE | `/tags/{tagid}` | Delete a tag. |
| GET | `/tags/{tagid}` | Get a single tag |
| PATCH | `/tags/{tagid}` | Rename a tag. The new name will be normalized and trimmed. |
| GET | `/tags/{tagid}/bookmarks` | Get bookmarks with a tag |
| GET | `/users/me` | Get current user info |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/karakeep/openapi/_ae-authored/karakeep-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/karakeep/json-schema/karakeep-patch-bookmarks-bookmarkid-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/karakeep/json-schema/karakeep-put-admin-users-userid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/karakeep/json-schema/karakeep-post-bookmarks-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/karakeep/json-schema/karakeep-post-highlights-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/karakeep/json-schema/karakeep-post-lists-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/karakeep/json-schema/karakeep-post-bookmarks-bookmarkid-summarize-response-schema.json

## Other Karakeep APIs (1)

- [Karakeep API](https://apis.io/apis/karakeep/karakeep-api-2/)

---

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