Lifous

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.

GET/api/v1/notes

Your notes

Your folders and notes — titles and the first 200 characters, never a locked note’s words.

MCP tool: list_notes

GET/api/v1/notes/{id}

One note, as Markdown

A note you can open, rendered to Markdown. Locked notes are not readable through the API.

FieldInTypeMeaning
id *pathuuidThe id.

MCP tool: read_note

POST/api/v1/notes

Write a note

A new note from Markdown — headings, lists, links, checklists. Up to 10,000 characters. Plan limits apply.

FieldInTypeMeaning
markdown *bodystringThe note’s body.
titlebodystringTaken from the first heading when omitted.
folderIdbodyuuidA folder of yours; the top level when omitted.
Body
{ "title": "Meeting notes", "markdown": "## Decisions\n- Ship on Friday\n- [ ] Tell the team" }

MCP tool: create_note

PATCH/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.

FieldInTypeMeaning
id *pathuuidThe id.
title *bodystringThe new title, 1–120 characters.
Body
{ "title": "Meeting notes, 27 October" }

MCP tool: rename_note

DELETE/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.

FieldInTypeMeaning
id *pathuuidThe id.

MCP tool: delete_note