Trilium Notes
App · 37 actions
Work with the notes in your own Trilium Notes: search them, create notes and add to them, file things under today in your journal, label and move notes, attach files, export a note tree and back up the database. Start a workflow when a note is created or changed, or when a label such as #todo is added to one.
Actions
| Action | What it does |
|---|---|
| Add label | Put a label on a note, such as #todo or #status = waiting. |
| Add note to journal | Create a note under a day in your journal, today's unless you choose another, such as a daily summary or something to remember. |
| Add relation | Point a note at another note with a named relation, such as ~project or ~template. |
| Append to note | Add to the end of a note, keeping what it already says, such as a new line in a log or a running list. |
| Clone note | Place a note under a second parent as well, the way Trilium's Clone does: it's one note, shown in both places. |
| Create attachment | Attach a file, or some text, to a note. |
| Create backup | Back up the whole Trilium database to a file on its server, such as every night or before a big change. |
| Create note | Create a note under another note, with its content, or from a file. |
| Create revision | Save a note as it is now to its revision history, such as before a workflow rewrites it, so the old version can be restored in Trilium. |
| Delete attachment | Delete an attachment from its note. |
| Delete attribute | Take a label or relation off a note, by its ID. |
| Delete note | Delete a note, with the notes under it. |
| Download attachment | Get an attachment's file, saved in Lodol for a later step, with what it says when it's text. |
| Download note file | Get the file of a file or image note, such as a PDF kept in Trilium, saved in Lodol for a later step. |
| Export note | Export a note with all the notes under it as a ZIP of HTML or Markdown files, saved in Lodol, such as to email it or keep a copy elsewhere. |
| Find notes by label | Find the notes that carry a label, such as every note labelled #todo, most recently changed first. |
| Get attachment | Get an attachment's name, format and size. |
| Get day note | Get the journal's note for a day, such as today's. Trilium makes it if there isn't one yet. |
| Get inbox note | Get the note new notes belong in: the note you labelled #inbox, or otherwise the day's note in the journal. |
| Get month note | Get the journal's note for a month, made if there isn't one yet. |
| Get note | Get a note's details: its title, type, labels, relations, where it sits in the tree and when it changed. |
| Get note content | Get what a note says, as Trilium keeps it and as plain Markdown text for a message or an AI step. |
| Get server info | Get the version of Trilium the server runs and where it keeps its data, such as to check the server is up. |
| Get week note | Get the journal's note for a week, made if there isn't one yet. |
| Get year note | Get the journal's note for a year, made if there isn't one yet. |
| List attachments | List the files attached to a note, with their names, formats and sizes. |
| List child notes | List the notes directly under a note, in the order Trilium shows them, such as everything in an Inbox note. |
| Move note | Move a note under another parent, such as out of an Inbox note into a project's note. |
| Refresh note order | Tell every open Trilium window the new order of a note's child notes, after their positions were changed. |
| Remove label | Take a label off a note by its name, such as #todo once the work is done. |
| Remove placement | Take a note out from under one parent. |
| Replace note content | Replace everything a note says with new content. |
| Search notes | Search your notes the way Trilium's own search box does: words, a label such as #todo, or both, such as #book tolkien. |
| Update attachment | Rename an attachment, change its format or position, or replace its file or text. |
| Update attribute | Change a label's value, or where a label or relation sits in the note's list. |
| Update note | Rename a note, or change its type or format. |
| Update placement | Change the prefix shown before a note's title in one place, or its position among the parent's notes. |
Add label
Put a label on a note, such as #todo or #status = waiting. A note that already has it, with that value, is left as it is.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Label
nametextRequired - The label's name, such as todo.
- Value
valuetext - A value for the label, such as waiting. Leave blank for a label with none.
- Inheritable
inheritabletrue/false - Whether the notes under this note get it too.Default:
false.
Outputs
createdtrue/false- Whether it was added now: false when the note already had the same one
idtext- The ID of the label or relation, which 'Update attribute' and 'Delete attribute' take
inheritabletrue/false- Whether the note's child notes get it too
nametext- Its name, without the # or ~
note_idtext- The ID of the note it's on
positionnumber- Its position among the note's attributes
typetext- label or relation
valuetext- A label's value, or the ID of the note a relation points to
Example output
{
"created": true,
"id": "mbNWHvBZKtyp",
"inheritable": false,
"name": "status",
"note_id": "evnnmvHTCgIn",
"position": 10,
"type": "label",
"value": "waiting"
}Add note to journal
Create a note under a day in your journal, today's unless you choose another, such as a daily summary or something to remember.
Inputs
- Title
titletextRequired - What to call the note.
- Content
contenttext - What the note says.
- Content is
content_formattext - How the content is written. Markdown or plain text is turned into the formatted text Trilium keeps; choose HTML when the content is already HTML.One of:
markdown(Markdown or plain text),html. Default:markdown. - Date
datedate - The day to file it under. Leave blank for today.
Outputs
branch_idtext- The ID of its placement under the day's note
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
datetext- The day it was filed under (YYYY-MM-DD)
day_note_idtext- The ID of that day's note, which the new note sits under
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
relationslist- Its relations to other notes
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_id": "2E9fmMK8tmRj_evnnmvHTCgIn",
"branch_ids": [
"2E9fmMK8tmRj_evnnmvHTCgIn"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"date": "2026-11-12",
"day_note_id": "2E9fmMK8tmRj",
"id": "evnnmvHTCgIn",
"is_archived": false,
"is_protected": false,
"label_names": [
"todo"
],
"labels": [
{
"id": "mbNWHvBZKtyp",
"inheritable": false,
"inherited": false,
"name": "todo",
"value": ""
}
],
"link": "https://notes.example.com/#root/evnnmvHTCgIn",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"2E9fmMK8tmRj"
],
"relations": [
{
"id": "Tgx0rVJ4cLwq",
"inheritable": false,
"inherited": false,
"name": "project",
"target_note_id": "w7aPu2ZLnQ0d"
}
],
"title": "Meeting with Dana",
"type": "text"
}Add relation
Point a note at another note with a named relation, such as ~project or ~template.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Relation
nametextRequired - The relation's name, such as project.
- Target note
targettextRequired - The note it points to: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Inheritable
inheritabletrue/false - Whether the notes under this note get it too.Default:
false.
Outputs
createdtrue/false- Whether it was added now: false when the note already had the same one
idtext- The ID of the label or relation, which 'Update attribute' and 'Delete attribute' take
inheritabletrue/false- Whether the note's child notes get it too
nametext- Its name, without the # or ~
note_idtext- The ID of the note it's on
positionnumber- Its position among the note's attributes
typetext- label or relation
valuetext- A label's value, or the ID of the note a relation points to
Example output
{
"created": true,
"id": "Tgx0rVJ4cLwq",
"inheritable": false,
"name": "project",
"note_id": "evnnmvHTCgIn",
"position": 20,
"type": "relation",
"value": "w7aPu2ZLnQ0d"
}Append to note
Add to the end of a note, keeping what it already says, such as a new line in a log or a running list.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Content
contenttextRequired - What to add at the end of the note.
- Content is
content_formattext - How the content is written. Markdown or plain text is turned into the formatted text Trilium keeps; choose HTML when the content is already HTML.One of:
markdown(Markdown or plain text),html. Default:markdown.
Outputs
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
relationslist- Its relations to other notes
sizenumber- How many characters the note's content has now
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_ids": [
"h4OWLAlmuq2E_evnnmvHTCgIn"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"id": "evnnmvHTCgIn",
"is_archived": false,
"is_protected": false,
"label_names": [
"todo"
],
"labels": [
{
"id": "mbNWHvBZKtyp",
"inheritable": false,
"inherited": false,
"name": "todo",
"value": ""
}
],
"link": "https://notes.example.com/#root/evnnmvHTCgIn",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"h4OWLAlmuq2E"
],
"relations": [
{
"id": "Tgx0rVJ4cLwq",
"inheritable": false,
"inherited": false,
"name": "project",
"target_note_id": "w7aPu2ZLnQ0d"
}
],
"size": 68,
"title": "Meeting with Dana",
"type": "text"
}Clone note
Place a note under a second parent as well, the way Trilium's Clone does: it's one note, shown in both places.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Parent note
parenttextRequired - The note to place it under: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Prefix
prefixtext - Words shown before the note's title in this place only, such as Draft.
- Position
positionnumber - Where it sits among the parent's notes. Trilium places notes at 10, 20, 30…, so 5 is first and 15 second. Leave blank for last.From 0 to 100000000.
Outputs
createdtrue/false- Whether the note was placed there now: false when it was already under that parent
idtext- The placement's ID, which 'Update placement' and 'Remove placement' take
note_idtext- The ID of the note that's placed
parent_note_idtext- The ID of the note it's placed under
positionnumber- Its position among the parent's notes (10, 20, 30…)
prefixtext- The words shown before the note's title in this place, if any
Example output
{
"created": true,
"id": "w7aPu2ZLnQ0d_evnnmvHTCgIn",
"note_id": "evnnmvHTCgIn",
"parent_note_id": "w7aPu2ZLnQ0d",
"position": 20,
"prefix": ""
}Create attachment
Attach a file, or some text, to a note.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- File
filetext - The file to attach: upload one, pick one from an earlier step, or paste a link.
- Text content
contenttext - Text to attach instead of a file.
- Name
titletext - What to call the attachment, such as invoice.pdf. Leave blank to use the file's name.
- Format
mimetext - The attachment's format (its MIME type), such as application/pdf. Leave blank to work it out from the file.
Outputs
idtext- The attachment's ID, which the other attachment steps take
mimetext- Its format, such as application/pdf
modified_attext- When it last changed (UTC)
note_idtext- The ID of the note it's attached to
positionnumber- Its position among the note's attachments
roletext- image for a picture, file for anything else
sizenumber- Its size in bytes
titletext- Its name, such as invoice.pdf
Example output
{
"id": "HOj738essQaL",
"mime": "application/pdf",
"modified_at": "2026-11-12T09:41:37.930Z",
"note_id": "evnnmvHTCgIn",
"position": 10,
"role": "file",
"size": 48213,
"title": "invoice.pdf"
}Create backup
Back up the whole Trilium database to a file on its server, such as every night or before a big change.
Inputs
- Name
nametext - A name for the backup, in letters, numbers and underscores, such as weekly. The file is called backup-<name>.db, and a backup with the same name is replaced. Leave blank for lodol.
Outputs
createdtrue/false- True once the backup is written
file_nametext- The backup's file, in the backup folder of Trilium's data directory
nametext- The name the backup was given
Example output
{
"created": true,
"file_name": "backup-lodol.db",
"name": "lodol"
}Create note
Create a note under another note, with its content, or from a file.
Inputs
- Title
titletextRequired - What to call the note.
- Parent note
parenttext - The note to put it under: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title. Leave blank for the top of the tree.
- Content
contenttext - What the note says.
- Content is
content_formattext - How the content is written. Markdown or plain text is turned into the formatted text Trilium keeps; choose HTML when the content is already HTML.One of:
markdown(Markdown or plain text),html. Default:markdown. - Type
note_typetext - What kind of note to make. Text is an ordinary formatted note; Code keeps what it's given as typed; Collection holds other notes. File and Image need a file.One of:
text,code,book(Collection),mermaid(Mermaid diagram),file,image. Default:text. - Format
mimetext - The content's format (its MIME type), such as application/json for a code note. Leave blank to let Trilium Notes choose.
- File
filetext - A file to keep as the note, instead of content: upload one, pick one from an earlier step, or paste a link. Makes a File note, or an Image note for a picture.
- Position
positionnumber - Where it sits among the parent's notes. Trilium places notes at 10, 20, 30…, so 5 is first and 15 second. Leave blank for last.From 0 to 100000000.
- Prefix
prefixtext - Words shown before the note's title in this place only, such as Draft.
Outputs
branch_idtext- The ID of its placement under the parent, which 'Update placement' takes
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
positionnumber- Its position among the parent's notes (10, 20, 30…)
relationslist- Its relations to other notes
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_id": "h4OWLAlmuq2E_evnnmvHTCgIn",
"branch_ids": [
"h4OWLAlmuq2E_evnnmvHTCgIn"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"id": "evnnmvHTCgIn",
"is_archived": false,
"is_protected": false,
"label_names": [
"todo"
],
"labels": [
{
"id": "mbNWHvBZKtyp",
"inheritable": false,
"inherited": false,
"name": "todo",
"value": ""
}
],
"link": "https://notes.example.com/#root/evnnmvHTCgIn",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"h4OWLAlmuq2E"
],
"position": 10,
"relations": [
{
"id": "Tgx0rVJ4cLwq",
"inheritable": false,
"inherited": false,
"name": "project",
"target_note_id": "w7aPu2ZLnQ0d"
}
],
"title": "Meeting with Dana",
"type": "text"
}Create revision
Save a note as it is now to its revision history, such as before a workflow rewrites it, so the old version can be restored in Trilium.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Outputs
createdtrue/false- True once the revision is saved
note_idtext- The note's ID
revision_idtext- The new revision's ID, blank on a Trilium too old to list revisions
titletext- The note's title
Example output
{
"created": true,
"note_id": "evnnmvHTCgIn",
"revision_id": "dXjnGjT08Rv0",
"title": "Meeting with Dana"
}Delete attachment
Delete an attachment from its note.
Inputs
- Attachment ID
attachmenttextRequired - The ID of the attachment, as 'Create attachment' or 'List attachments' returns it.
Outputs
deletedtrue/false- True once the attachment is deleted
idtext- The ID of the attachment that was deleted
note_idtext- The ID of the note it was attached to
titletext- Its name
Example output
{
"deleted": true,
"id": "HOj738essQaL",
"note_id": "evnnmvHTCgIn",
"title": "invoice.pdf"
}Delete attribute
Take a label or relation off a note, by its ID.
Inputs
- Label or relation ID
attributetextRequired - The ID of the label or relation, as 'Add label', 'Add relation' or 'Get note' returns it.
Outputs
deletedtrue/false- True once it is deleted
idtext- The ID of the label or relation that was deleted
nametext- Its name
note_idtext- The ID of the note it was on
typetext- label or relation
Example output
{
"deleted": true,
"id": "mbNWHvBZKtyp",
"name": "status",
"note_id": "evnnmvHTCgIn",
"type": "label"
}Delete note
Delete a note, with the notes under it. Trilium keeps deleted notes for a while, where they can be restored from its recent changes.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Outputs
deletedtrue/false- True once the note is deleted
idtext- The ID of the note that was deleted
titletext- Its title
Example output
{
"deleted": true,
"id": "evnnmvHTCgIn",
"title": "Meeting with Dana"
}Download attachment
Get an attachment's file, saved in Lodol for a later step, with what it says when it's text.
Inputs
- Attachment ID
attachmenttextRequired - The ID of the attachment, as 'Create attachment' or 'List attachments' returns it.
Outputs
content_typetext- The file's format, such as application/zip
document_reftext- The file saved in Lodol, which a later step can use
filenametext- The file's name
idtext- The attachment's ID
is_texttrue/false- Whether the attachment is text
mimetext- Its format, such as application/pdf
size_bytesnumber- The file's size in bytes
texttext- What it says, when it's text; blank for a picture or other file
titletext- The attachment's name
urltext- Where the saved file can be opened in Lodol
Example output
{
"content_type": "application/pdf",
"document_ref": "doc_5f1e2d3c4b5a69788796a5b4",
"filename": "invoice.pdf",
"id": "HOj738essQaL",
"is_text": false,
"mime": "application/pdf",
"size_bytes": 48213,
"text": "",
"title": "invoice.pdf",
"url": "/actions/core/serve-document/doc_5f1e2d3c4b5a69788796a5b4"
}Download note file
Get the file of a file or image note, such as a PDF kept in Trilium, saved in Lodol for a later step.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Outputs
content_typetext- The file's format, such as application/zip
document_reftext- The file saved in Lodol, which a later step can use
filenametext- The file's name
note_idtext- The note's ID
size_bytesnumber- The file's size in bytes
titletext- The note's title
typetext- What kind of note it is, such as file or image
urltext- Where the saved file can be opened in Lodol
Example output
{
"content_type": "application/pdf",
"document_ref": "doc_5f1e2d3c4b5a69788796a5b4",
"filename": "Scan 12 November.pdf",
"note_id": "pbfySLhLe8Bq",
"size_bytes": 48213,
"title": "Scan 12 November",
"type": "file",
"url": "/actions/core/serve-document/doc_5f1e2d3c4b5a69788796a5b4"
}Export note
Export a note with all the notes under it as a ZIP of HTML or Markdown files, saved in Lodol, such as to email it or keep a copy elsewhere.
Inputs
- Note
notetextRequired - The note to export: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title. Use root for everything.
- Format
export_formattext - What the notes in the ZIP are written as.One of:
html,markdown. Default:html.
Outputs
content_typetext- The file's format, such as application/zip
document_reftext- The file saved in Lodol, which a later step can use
filenametext- The file's name
formattext- html or markdown: what the notes inside the ZIP are written as
note_idtext- The ID of the note that was exported, with the notes under it
size_bytesnumber- The file's size in bytes
titletext- The note's title
urltext- Where the saved file can be opened in Lodol
Example output
{
"content_type": "application/zip",
"document_ref": "doc_5f1e2d3c4b5a69788796a5b4",
"filename": "Meeting with Dana.zip",
"format": "markdown",
"note_id": "evnnmvHTCgIn",
"size_bytes": 2048,
"title": "Meeting with Dana",
"url": "/actions/core/serve-document/doc_5f1e2d3c4b5a69788796a5b4"
}Find notes by label
Find the notes that carry a label, such as every note labelled #todo, most recently changed first.
Inputs
- Label
labeltextRequired - The label's name, such as todo.
- Value
valuetext - Only notes whose label has this value, such as waiting for #status = waiting. Leave blank for any value.
- Under note
ancestortext - Only notes somewhere under this note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title. Leave blank for all notes.
- Include archived notes
include_archivedtrue/false - Also find notes labelled #archived, which Trilium's search leaves out.Default:
false. - Limit
limitnumber - The most notes to return, up to 500. Leave blank for 50.From 1 to 500.
Outputs
countnumber- How many notes were found
noteslist- The notes found
querytext- The search Trilium ran, as its own search box takes it
Example output
{
"count": 1,
"notes": [
{
"branch_ids": [
"h4OWLAlmuq2E_evnnmvHTCgIn"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"id": "evnnmvHTCgIn",
"is_archived": false,
"is_protected": false,
"label_names": [
"todo"
],
"labels": [
{
"id": "mbNWHvBZKtyp",
"inheritable": false,
"inherited": false,
"name": "todo",
"value": ""
}
],
"link": "https://notes.example.com/#root/evnnmvHTCgIn",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"h4OWLAlmuq2E"
],
"relations": [
{
"id": "Tgx0rVJ4cLwq",
"inheritable": false,
"inherited": false,
"name": "project",
"target_note_id": "w7aPu2ZLnQ0d"
}
],
"title": "Meeting with Dana",
"type": "text"
}
],
"query": "#todo"
}Get attachment
Get an attachment's name, format and size.
Inputs
- Attachment ID
attachmenttextRequired - The ID of the attachment, as 'Create attachment' or 'List attachments' returns it.
Outputs
idtext- The attachment's ID, which the other attachment steps take
mimetext- Its format, such as application/pdf
modified_attext- When it last changed (UTC)
note_idtext- The ID of the note it's attached to
positionnumber- Its position among the note's attachments
roletext- image for a picture, file for anything else
sizenumber- Its size in bytes
titletext- Its name, such as invoice.pdf
Example output
{
"id": "HOj738essQaL",
"mime": "application/pdf",
"modified_at": "2026-11-12T09:41:37.930Z",
"note_id": "evnnmvHTCgIn",
"position": 10,
"role": "file",
"size": 48213,
"title": "invoice.pdf"
}Get day note
Get the journal's note for a day, such as today's. Trilium makes it if there isn't one yet.
Inputs
- Date
datedate - The day. Leave blank for today.
Outputs
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
datetext- The date the note was asked for (YYYY-MM-DD)
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
relationslist- Its relations to other notes
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_ids": [
"MPnSh3fL31jh_2E9fmMK8tmRj"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"date": "2026-11-12",
"id": "2E9fmMK8tmRj",
"is_archived": false,
"is_protected": false,
"label_names": [
"dateNote"
],
"labels": [
{
"id": "EIe1SE8dgxZ7",
"inheritable": false,
"inherited": false,
"name": "dateNote",
"value": "2026-11-12"
}
],
"link": "https://notes.example.com/#root/2E9fmMK8tmRj",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"MPnSh3fL31jh"
],
"relations": [],
"title": "12 - Thursday",
"type": "text"
}Get inbox note
Get the note new notes belong in: the note you labelled #inbox, or otherwise the day's note in the journal.
Inputs
- Date
datedate - The day. Leave blank for today.
Outputs
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
datetext- The date the note was asked for (YYYY-MM-DD)
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
relationslist- Its relations to other notes
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_ids": [
"MPnSh3fL31jh_2E9fmMK8tmRj"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"date": "2026-11-12",
"id": "2E9fmMK8tmRj",
"is_archived": false,
"is_protected": false,
"label_names": [],
"labels": [],
"link": "https://notes.example.com/#root/2E9fmMK8tmRj",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"MPnSh3fL31jh"
],
"relations": [],
"title": "Inbox",
"type": "text"
}Get month note
Get the journal's note for a month, made if there isn't one yet.
Inputs
- Date
datedate - Any day in the month. Leave blank for this month.
Outputs
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
datetext- The date the note was asked for (YYYY-MM-DD)
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
relationslist- Its relations to other notes
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_ids": [
"MPnSh3fL31jh_2E9fmMK8tmRj"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"date": "2026-11-12",
"id": "2E9fmMK8tmRj",
"is_archived": false,
"is_protected": false,
"label_names": [],
"labels": [],
"link": "https://notes.example.com/#root/2E9fmMK8tmRj",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"MPnSh3fL31jh"
],
"relations": [],
"title": "11 - November",
"type": "text"
}Get note
Get a note's details: its title, type, labels, relations, where it sits in the tree and when it changed.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Outputs
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
relationslist- Its relations to other notes
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_ids": [
"h4OWLAlmuq2E_evnnmvHTCgIn"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"id": "evnnmvHTCgIn",
"is_archived": false,
"is_protected": false,
"label_names": [
"todo"
],
"labels": [
{
"id": "mbNWHvBZKtyp",
"inheritable": false,
"inherited": false,
"name": "todo",
"value": ""
}
],
"link": "https://notes.example.com/#root/evnnmvHTCgIn",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"h4OWLAlmuq2E"
],
"relations": [
{
"id": "Tgx0rVJ4cLwq",
"inheritable": false,
"inherited": false,
"name": "project",
"target_note_id": "w7aPu2ZLnQ0d"
}
],
"title": "Meeting with Dana",
"type": "text"
}Get note content
Get what a note says, as Trilium keeps it and as plain Markdown text for a message or an AI step.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Outputs
contenttext- The content as Trilium keeps it: HTML for a text note, the code of a code note
idtext- The note's ID
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
sizenumber- How many characters the content has
texttext- The same as Markdown (plain, readable text), for a message or an AI step
titletext- The note's title
typetext- What kind of note it is, such as text or code
Example output
{
"content": "<p>Agreed to ship the <strong>spring</strong> catalogue in March.</p>",
"id": "evnnmvHTCgIn",
"link": "https://notes.example.com/#root/evnnmvHTCgIn",
"mime": "text/html",
"size": 68,
"text": "Agreed to ship the **spring** catalogue in March.",
"title": "Meeting with Dana",
"type": "text"
}Get server info
Get the version of Trilium the server runs and where it keeps its data, such as to check the server is up.
Inputs
None.
Outputs
build_datetext- When that version was built
build_revisiontext- The source revision it was built from
data_directorytext- The folder on the server where Trilium keeps its data
database_versionnumber- The version of its database
servertext- The address of the Trilium server
sync_versionnumber- The version of its sync protocol
versiontext- The Trilium version the server runs, such as 0.107.0
Example output
{
"build_date": "2026-11-08T21:55:34Z",
"build_revision": "d83d7151f1c6d4292be88d8d34008f409b252f7f",
"data_directory": "/home/node/trilium-data",
"database_version": 242,
"server": "https://notes.example.com",
"sync_version": 41,
"version": "0.107.0"
}Get week note
Get the journal's note for a week, made if there isn't one yet. Week notes have to be turned on in Trilium's journal first.
Inputs
- Date
datedate - Any day in the week. Leave blank for this week.
Outputs
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
datetext- The date the note was asked for (YYYY-MM-DD)
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
relationslist- Its relations to other notes
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_ids": [
"MPnSh3fL31jh_2E9fmMK8tmRj"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"date": "2026-11-12",
"id": "2E9fmMK8tmRj",
"is_archived": false,
"is_protected": false,
"label_names": [],
"labels": [],
"link": "https://notes.example.com/#root/2E9fmMK8tmRj",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"MPnSh3fL31jh"
],
"relations": [],
"title": "Week 46",
"type": "text"
}Get year note
Get the journal's note for a year, made if there isn't one yet.
Inputs
- Date
datedate - Any day in the year. Leave blank for this year.
Outputs
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
datetext- The date the note was asked for (YYYY-MM-DD)
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
relationslist- Its relations to other notes
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_ids": [
"MPnSh3fL31jh_2E9fmMK8tmRj"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"date": "2026-11-12",
"id": "2E9fmMK8tmRj",
"is_archived": false,
"is_protected": false,
"label_names": [],
"labels": [],
"link": "https://notes.example.com/#root/2E9fmMK8tmRj",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"MPnSh3fL31jh"
],
"relations": [],
"title": "2026",
"type": "text"
}List attachments
List the files attached to a note, with their names, formats and sizes.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Outputs
attachmentslist- The note's attachments
countnumber- How many there are
note_idtext- The note's ID
Example output
{
"attachments": [
{
"id": "HOj738essQaL",
"mime": "application/pdf",
"modified_at": "2026-11-12T09:41:37.930Z",
"note_id": "evnnmvHTCgIn",
"position": 10,
"role": "file",
"size": 48213,
"title": "invoice.pdf"
}
],
"count": 1,
"note_id": "evnnmvHTCgIn"
}List child notes
List the notes directly under a note, in the order Trilium shows them, such as everything in an Inbox note.
Inputs
- Note
notetextRequired - The parent note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title. Use root for the top of the tree.
Outputs
countnumber- How many there are
noteslist- The notes under it, in their order
parent_idtext- The ID of the note they sit under
Example output
{
"count": 1,
"notes": [
{
"branch_ids": [
"h4OWLAlmuq2E_evnnmvHTCgIn"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"id": "evnnmvHTCgIn",
"is_archived": false,
"is_protected": false,
"label_names": [
"todo"
],
"labels": [
{
"id": "mbNWHvBZKtyp",
"inheritable": false,
"inherited": false,
"name": "todo",
"value": ""
}
],
"link": "https://notes.example.com/#root/evnnmvHTCgIn",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"h4OWLAlmuq2E"
],
"relations": [
{
"id": "Tgx0rVJ4cLwq",
"inheritable": false,
"inherited": false,
"name": "project",
"target_note_id": "w7aPu2ZLnQ0d"
}
],
"title": "Meeting with Dana",
"type": "text"
}
],
"parent_id": "h4OWLAlmuq2E"
}Move note
Move a note under another parent, such as out of an Inbox note into a project's note.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- New parent note
parenttextRequired - The note to move it under: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- From parent note
from_parenttext - For a note that sits in several places, the parent to move it out from under. Leave blank for a note in one place.
Outputs
from_parent_idtext- The ID of the note it was taken from under
idtext- The placement's ID, which 'Update placement' and 'Remove placement' take
movedtrue/false- Whether the note was moved: false when it was already under that parent
note_idtext- The ID of the note that's placed
parent_note_idtext- The ID of the note it's placed under
positionnumber- Its position among the parent's notes (10, 20, 30…)
prefixtext- The words shown before the note's title in this place, if any
Example output
{
"from_parent_id": "h4OWLAlmuq2E",
"id": "w7aPu2ZLnQ0d_evnnmvHTCgIn",
"moved": true,
"note_id": "evnnmvHTCgIn",
"parent_note_id": "w7aPu2ZLnQ0d",
"position": 20,
"prefix": ""
}Refresh note order
Tell every open Trilium window the new order of a note's child notes, after their positions were changed. 'Move note' and 'Update placement' do this themselves.
Inputs
- Parent note
parenttextRequired - The note whose child notes were reordered: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Outputs
parent_idtext- The ID of the note whose child notes were refreshed
refreshedtrue/false- True once open Trilium windows have been told the new order
Example output
{
"parent_id": "w7aPu2ZLnQ0d",
"refreshed": true
}Remove label
Take a label off a note by its name, such as #todo once the work is done. A label the note inherits from a parent stays.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Label
nametextRequired - The label's name, such as todo.
Outputs
attribute_idslist- The IDs of the labels removed
nametext- The label's name
note_idtext- The note's ID
removednumber- How many labels with that name were taken off the note
Example output
{
"attribute_ids": [
"mbNWHvBZKtyp"
],
"name": "todo",
"note_id": "evnnmvHTCgIn",
"removed": 1
}Remove placement
Take a note out from under one parent. The note stays wherever else it is placed; removing its only placement deletes the note.
Inputs
- Placement ID
branchtextRequired - The ID of the placement, as 'Create note', 'Clone note' or 'Get note' (its branch_ids) returns it.
Outputs
deletedtrue/false- True once the placement is removed
idtext- The ID of the placement that was removed
note_deletedtrue/false- Whether the note itself was deleted, because this was its only place
note_idtext- The ID of the note
parent_note_idtext- The ID of the note it was under
Example output
{
"deleted": true,
"id": "w7aPu2ZLnQ0d_evnnmvHTCgIn",
"note_deleted": false,
"note_id": "evnnmvHTCgIn",
"parent_note_id": "w7aPu2ZLnQ0d"
}Replace note content
Replace everything a note says with new content.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Content
contenttextRequired - What the note should say now.
- Content is
content_formattext - How the content is written. Markdown or plain text is turned into the formatted text Trilium keeps; choose HTML when the content is already HTML.One of:
markdown(Markdown or plain text),html. Default:markdown.
Outputs
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
relationslist- Its relations to other notes
sizenumber- How many characters the note's content has now
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_ids": [
"h4OWLAlmuq2E_evnnmvHTCgIn"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"id": "evnnmvHTCgIn",
"is_archived": false,
"is_protected": false,
"label_names": [
"todo"
],
"labels": [
{
"id": "mbNWHvBZKtyp",
"inheritable": false,
"inherited": false,
"name": "todo",
"value": ""
}
],
"link": "https://notes.example.com/#root/evnnmvHTCgIn",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"h4OWLAlmuq2E"
],
"relations": [
{
"id": "Tgx0rVJ4cLwq",
"inheritable": false,
"inherited": false,
"name": "project",
"target_note_id": "w7aPu2ZLnQ0d"
}
],
"size": 68,
"title": "Meeting with Dana",
"type": "text"
}Search notes
Search your notes the way Trilium's own search box does: words, a label such as #todo, or both, such as #book tolkien.
Inputs
- Search
querytextRequired - What to look for: words (towers tolkien), an exact phrase in double quotes ("Two Towers"), a label (#todo), a label with a value (#status = waiting), or a mix (#book tolkien).
- Under note
ancestortext - Only notes somewhere under this note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title. Leave blank for all notes.
- Direct children only
children_onlytrue/false - With 'Under note', only notes directly under it, not deeper.Default:
false. - Fast search
fast_searchtrue/false - Look only at titles and labels, not at what the notes say. Much quicker in a large Trilium.Default:
false. - Include archived notes
include_archivedtrue/false - Also find notes labelled #archived, which Trilium's search leaves out.Default:
false. - Sort by
order_bytext - What to sort the notes by. Defaults to the best match first.One of:
relevance(Best match),title,created(Date created),modified(Date modified). Default:relevance. - Sort direction
order_directiontext - Which way to sort, when sorting by title or a date.One of:
asc(Ascending (A to Z, oldest first)),desc(Descending (Z to A, newest first)). Default:asc. - Limit
limitnumber - The most notes to return, up to 500. Leave blank for 50.From 1 to 500.
Outputs
countnumber- How many notes were found
noteslist- The notes found
querytext- The search Trilium ran, as its own search box takes it
Example output
{
"count": 1,
"notes": [
{
"branch_ids": [
"h4OWLAlmuq2E_evnnmvHTCgIn"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"id": "evnnmvHTCgIn",
"is_archived": false,
"is_protected": false,
"label_names": [
"todo"
],
"labels": [
{
"id": "mbNWHvBZKtyp",
"inheritable": false,
"inherited": false,
"name": "todo",
"value": ""
}
],
"link": "https://notes.example.com/#root/evnnmvHTCgIn",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"h4OWLAlmuq2E"
],
"relations": [
{
"id": "Tgx0rVJ4cLwq",
"inheritable": false,
"inherited": false,
"name": "project",
"target_note_id": "w7aPu2ZLnQ0d"
}
],
"title": "Meeting with Dana",
"type": "text"
}
],
"query": "#todo"
}Update attachment
Rename an attachment, change its format or position, or replace its file or text.
Inputs
- Attachment ID
attachmenttextRequired - The ID of the attachment, as 'Create attachment' or 'List attachments' returns it.
- Name
titletext - A new name, such as invoice-paid.pdf.
- Format
mimetext - A new format (MIME type), such as application/pdf.
- Position
positionnumber - Where it sits among the note's attachments (10, 20, 30…).From 0 to 100000000.
- File
filetext - A file to replace the attachment's with: upload one, pick one from an earlier step, or paste a link.
- Text content
contenttext - Text to replace the attachment's with, instead of a file.
Outputs
idtext- The attachment's ID, which the other attachment steps take
mimetext- Its format, such as application/pdf
modified_attext- When it last changed (UTC)
note_idtext- The ID of the note it's attached to
positionnumber- Its position among the note's attachments
roletext- image for a picture, file for anything else
sizenumber- Its size in bytes
titletext- Its name, such as invoice.pdf
Example output
{
"id": "HOj738essQaL",
"mime": "application/pdf",
"modified_at": "2026-11-12T09:41:37.930Z",
"note_id": "evnnmvHTCgIn",
"position": 10,
"role": "file",
"size": 48213,
"title": "invoice.pdf"
}Update attribute
Change a label's value, or where a label or relation sits in the note's list. A relation's target can't be changed: delete it and add another.
Inputs
- Label or relation ID
attributetextRequired - The ID of the label or relation, as 'Add label', 'Add relation' or 'Get note' returns it.
- Value
valuetext - A new value for the label.
- Position
positionnumber - Where it sits among the note's labels and relations (10, 20, 30…).From 0 to 100000000.
Outputs
idtext- The ID of the label or relation, which 'Update attribute' and 'Delete attribute' take
inheritabletrue/false- Whether the note's child notes get it too
nametext- Its name, without the # or ~
note_idtext- The ID of the note it's on
positionnumber- Its position among the note's attributes
typetext- label or relation
valuetext- A label's value, or the ID of the note a relation points to
Example output
{
"id": "mbNWHvBZKtyp",
"inheritable": false,
"name": "status",
"note_id": "evnnmvHTCgIn",
"position": 10,
"type": "label",
"value": "waiting"
}Update note
Rename a note, or change its type or format. Its content stays as it is.
Inputs
- Note
notetextRequired - The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Title
titletext - A new title for the note.
- Type
note_typetext - A new type for the note. Text is an ordinary formatted note; Code keeps what it's given as typed; Collection holds other notes. Leave blank to keep its type.One of:
text,code,book(Collection),mermaid(Mermaid diagram),file,image. - Format
mimetext - The content's format (its MIME type), such as application/json for a code note. Leave blank to let Trilium Notes choose.
Outputs
branch_idslist- The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
child_countnumber- How many notes are under it
child_idslist- The IDs of the notes under it, in their order
created_attext- When it was created (UTC)
idtext- The note's ID, which other Trilium Notes steps take
is_archivedtrue/false- Whether it carries the #archived label
is_protectedtrue/false- Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
label_nameslist- The names of its labels
labelslist- Its labels
linktext- Where the note opens in Trilium
mimetext- The format of its content, such as text/html
modified_attext- When its title or content last changed (UTC)
parent_idslist- The IDs of the notes it sits under
relationslist- Its relations to other notes
titletext- The note's title
typetext- What kind of note it is, such as text, code, book, file or image
Example output
{
"branch_ids": [
"h4OWLAlmuq2E_evnnmvHTCgIn"
],
"child_count": 0,
"child_ids": [],
"created_at": "2026-11-12T09:15:02.118Z",
"id": "evnnmvHTCgIn",
"is_archived": false,
"is_protected": false,
"label_names": [
"todo"
],
"labels": [
{
"id": "mbNWHvBZKtyp",
"inheritable": false,
"inherited": false,
"name": "todo",
"value": ""
}
],
"link": "https://notes.example.com/#root/evnnmvHTCgIn",
"mime": "text/html",
"modified_at": "2026-11-12T09:41:37.930Z",
"parent_ids": [
"h4OWLAlmuq2E"
],
"relations": [
{
"id": "Tgx0rVJ4cLwq",
"inheritable": false,
"inherited": false,
"name": "project",
"target_note_id": "w7aPu2ZLnQ0d"
}
],
"title": "Meeting with Dana",
"type": "text"
}Update placement
Change the prefix shown before a note's title in one place, or its position among the parent's notes.
Inputs
- Placement ID
branchtextRequired - The ID of the placement, as 'Create note', 'Clone note' or 'Get note' (its branch_ids) returns it.
- Prefix
prefixtext - Words shown before the note's title in this place only, such as Draft.
- Position
positionnumber - Where it sits among the parent's notes. Trilium places notes at 10, 20, 30…, so 5 is first and 15 second. Leave blank for last.From 0 to 100000000.
Outputs
idtext- The placement's ID, which 'Update placement' and 'Remove placement' take
note_idtext- The ID of the note that's placed
parent_note_idtext- The ID of the note it's placed under
positionnumber- Its position among the parent's notes (10, 20, 30…)
prefixtext- The words shown before the note's title in this place, if any
Example output
{
"id": "w7aPu2ZLnQ0d_evnnmvHTCgIn",
"note_id": "evnnmvHTCgIn",
"parent_note_id": "w7aPu2ZLnQ0d",
"position": 20,
"prefix": ""
}