Documentation Index
Fetch the complete documentation index at: https://docs.cleve.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Cleve REST API lets you read and write notes and folders programmatically.
Base URL: https://app.cleve.ai/api/v1
Authentication
All requests require a personal API key passed as a Bearer token:
Authorization: Bearer <your-api-key>
Getting an API Key
- Open Cleve and go to Settings → Developer
- Click Manage next to API keys
- Create a new key in your Clerk user profile
API keys are personal and scoped to your account. Keep them secret — anyone with your key can read and modify your notes.
Notes
List Notes
Query parameters
| Parameter | Type | Description |
|---|
folderId | string | Filter to a specific folder |
pinnedOnly | boolean | Return only pinned notes |
curl -H "Authorization: Bearer <your-api-key>" \
"https://app.cleve.ai/api/v1/notes"
Create a Note
Body (JSON)
| Field | Type | Description |
|---|
title | string | Note title |
content | string | Note body (markdown) |
folderId | string | Folder to place the note in |
isPinned | boolean | Whether to pin the note |
curl -X POST \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{"title": "Meeting notes", "content": "## Agenda\n\n- Item 1"}' \
"https://app.cleve.ai/api/v1/notes"
Get a Note
GET /api/v1/notes/:noteId
curl -H "Authorization: Bearer <your-api-key>" \
"https://app.cleve.ai/api/v1/notes/abc123"
Update a Note
PATCH /api/v1/notes/:noteId
| Field | Type | Description |
|---|
title | string | New title |
content | string | New body (markdown) |
isPinned | boolean | Pin or unpin |
isPublic | boolean | Enable or disable link sharing |
folderId | string | null | Move to folder, or null to unfile |
curl -X PATCH \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{"isPinned": true}' \
"https://app.cleve.ai/api/v1/notes/abc123"
Delete a Note
DELETE /api/v1/notes/:noteId
curl -X DELETE \
-H "Authorization: Bearer <your-api-key>" \
"https://app.cleve.ai/api/v1/notes/abc123"
List Recent Notes
Returns the most recently updated notes.
Query parameters
| Parameter | Type | Default | Max |
|---|
limit | number | 10 | 50 |
Search Notes
Full-text search across your notes — searches both titles and content.
Query parameters
| Parameter | Type | Required | Description |
|---|
query | string | ✅ | Search term |
limit | number | | Max results to return |
folderId | string | | Scope to a folder |
isPinned | boolean | | Filter to pinned notes only (true or false) |
curl -H "Authorization: Bearer <your-api-key>" \
"https://app.cleve.ai/api/v1/notes/search?query=product+roadmap"
curl -X POST \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{"query": "product roadmap"}' \
"https://app.cleve.ai/api/v1/notes/search"
Count Notes
Returns total and pinned note counts.
Query parameters
| Parameter | Type | Description |
|---|
folderId | string | Scope to a folder |
Folders
List Folders
Returns all folders in your workspace (flat list with parent references for hierarchy).
Example
curl -H "Authorization: Bearer <your-api-key>" \
"https://app.cleve.ai/api/v1/folders"
Create a Folder
Body (JSON)
| Field | Type | Required | Description |
|---|
name | string | ✅ | Folder name |
parentId | string | | Parent folder ID for nesting |
curl -X POST \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{"name": "Research"}' \
"https://app.cleve.ai/api/v1/folders"
Rename a Folder
PATCH /api/v1/folders/:folderId
| Field | Type | Required | Description |
|---|
name | string | ✅ | New folder name |
Delete a Folder
DELETE /api/v1/folders/:folderId
Error Responses
| Status | Meaning |
|---|
401 | Missing or invalid API key |
404 | Note or folder not found |
400 | Missing required field |
500 | Internal server error |
{ "error": "Note not found" }
MCP Server
Connect AI agents to Cleve via the Model Context Protocol.
Pricing
API access is available on all plans.
