Notes
The notes endpoints of the Lifous API.
A * marks a required field. Path fields go in the address, query fields after a ?, body fields in JSON.
/api/v1/notesYour notes
Your folders and notes — titles and the first 200 characters, never a locked note’s words.
MCP tool: list_notes
/api/v1/notes/{id}One note, as Markdown
A note you can open, rendered to Markdown. Locked notes are not readable through the API.
| Field | In | Type | Meaning |
|---|---|---|---|
| id * | path | uuid | The id. |
MCP tool: read_note
/api/v1/notesWrite a note
A new note from Markdown — headings, lists, links, checklists. Up to 10,000 characters. Plan limits apply.
| Field | In | Type | Meaning |
|---|---|---|---|
| markdown * | body | string | The note’s body. |
| title | body | string | Taken from the first heading when omitted. |
| folderId | body | uuid | A folder of yours; the top level when omitted. |
{ "title": "Meeting notes", "markdown": "## Decisions\n- Ship on Friday\n- [ ] Tell the team" }MCP tool: create_note
/api/v1/notes/{id}Rename a note
Gives a note of yours a new title. The body is unchanged. Locked notes, and notes shared with you, cannot be renamed through the API.
| Field | In | Type | Meaning |
|---|---|---|---|
| id * | path | uuid | The id. |
| title * | body | string | The new title, 1–120 characters. |
{ "title": "Meeting notes, 27 October" }MCP tool: rename_note
/api/v1/notes/{id}Delete a note
Moves a note of yours to Recently Deleted, where it can be restored in the app for 30 days; its public link stops working at once. Locked notes, and notes shared with you, cannot be deleted through the API.
| Field | In | Type | Meaning |
|---|---|---|---|
| id * | path | uuid | The id. |
MCP tool: delete_note