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

ActionWhat it does
Add labelPut a label on a note, such as #todo or #status = waiting.
Add note to journalCreate a note under a day in your journal, today's unless you choose another, such as a daily summary or something to remember.
Add relationPoint a note at another note with a named relation, such as ~project or ~template.
Append to noteAdd to the end of a note, keeping what it already says, such as a new line in a log or a running list.
Clone notePlace a note under a second parent as well, the way Trilium's Clone does: it's one note, shown in both places.
Create attachmentAttach a file, or some text, to a note.
Create backupBack up the whole Trilium database to a file on its server, such as every night or before a big change.
Create noteCreate a note under another note, with its content, or from a file.
Create revisionSave 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 attachmentDelete an attachment from its note.
Delete attributeTake a label or relation off a note, by its ID.
Delete noteDelete a note, with the notes under it.
Download attachmentGet an attachment's file, saved in Lodol for a later step, with what it says when it's text.
Download note fileGet the file of a file or image note, such as a PDF kept in Trilium, saved in Lodol for a later step.
Export noteExport 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 labelFind the notes that carry a label, such as every note labelled #todo, most recently changed first.
Get attachmentGet an attachment's name, format and size.
Get day noteGet the journal's note for a day, such as today's. Trilium makes it if there isn't one yet.
Get inbox noteGet the note new notes belong in: the note you labelled #inbox, or otherwise the day's note in the journal.
Get month noteGet the journal's note for a month, made if there isn't one yet.
Get noteGet a note's details: its title, type, labels, relations, where it sits in the tree and when it changed.
Get note contentGet what a note says, as Trilium keeps it and as plain Markdown text for a message or an AI step.
Get server infoGet the version of Trilium the server runs and where it keeps its data, such as to check the server is up.
Get week noteGet the journal's note for a week, made if there isn't one yet.
Get year noteGet the journal's note for a year, made if there isn't one yet.
List attachmentsList the files attached to a note, with their names, formats and sizes.
List child notesList the notes directly under a note, in the order Trilium shows them, such as everything in an Inbox note.
Move noteMove a note under another parent, such as out of an Inbox note into a project's note.
Refresh note orderTell every open Trilium window the new order of a note's child notes, after their positions were changed.
Remove labelTake a label off a note by its name, such as #todo once the work is done.
Remove placementTake a note out from under one parent.
Replace note contentReplace everything a note says with new content.
Search notesSearch your notes the way Trilium's own search box does: words, a label such as #todo, or both, such as #book tolkien.
Update attachmentRename an attachment, change its format or position, or replace its file or text.
Update attributeChange a label's value, or where a label or relation sits in the note's list.
Update noteRename a note, or change its type or format.
Update placementChange 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

NotenotetextRequired
The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
LabelnametextRequired
The label's name, such as todo.
Valuevaluetext
A value for the label, such as waiting. Leave blank for a label with none.
Inheritableinheritabletrue/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

TitletitletextRequired
What to call the note.
Contentcontenttext
What the note says.
Content iscontent_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.
Datedatedate
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

NotenotetextRequired
The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
RelationnametextRequired
The relation's name, such as project.
Target notetargettextRequired
The note it points to: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Inheritableinheritabletrue/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

NotenotetextRequired
The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
ContentcontenttextRequired
What to add at the end of the note.
Content iscontent_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

NotenotetextRequired
The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Parent noteparenttextRequired
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.
Prefixprefixtext
Words shown before the note's title in this place only, such as Draft.
Positionpositionnumber
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

NotenotetextRequired
The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Filefiletext
The file to attach: upload one, pick one from an earlier step, or paste a link.
Text contentcontenttext
Text to attach instead of a file.
Nametitletext
What to call the attachment, such as invoice.pdf. Leave blank to use the file's name.
Formatmimetext
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

Namenametext
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

TitletitletextRequired
What to call the note.
Parent noteparenttext
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.
Contentcontenttext
What the note says.
Content iscontent_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.
Typenote_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.
Formatmimetext
The content's format (its MIME type), such as application/json for a code note. Leave blank to let Trilium Notes choose.
Filefiletext
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.
Positionpositionnumber
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.
Prefixprefixtext
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

NotenotetextRequired
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 IDattachmenttextRequired
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 IDattributetextRequired
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

NotenotetextRequired
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 IDattachmenttextRequired
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

NotenotetextRequired
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

NotenotetextRequired
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.
Formatexport_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

LabellabeltextRequired
The label's name, such as todo.
Valuevaluetext
Only notes whose label has this value, such as waiting for #status = waiting. Leave blank for any value.
Under noteancestortext
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 notesinclude_archivedtrue/false
Also find notes labelled #archived, which Trilium's search leaves out.Default: false.
Limitlimitnumber
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 IDattachmenttextRequired
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

Datedatedate
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

Datedatedate
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

Datedatedate
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

NotenotetextRequired
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

NotenotetextRequired
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

Datedatedate
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

Datedatedate
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

NotenotetextRequired
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

NotenotetextRequired
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

NotenotetextRequired
The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
New parent noteparenttextRequired
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 notefrom_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 noteparenttextRequired
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

NotenotetextRequired
The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
LabelnametextRequired
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 IDbranchtextRequired
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

NotenotetextRequired
The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
ContentcontenttextRequired
What the note should say now.
Content iscontent_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

SearchquerytextRequired
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 noteancestortext
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 onlychildren_onlytrue/false
With 'Under note', only notes directly under it, not deeper.Default: false.
Fast searchfast_searchtrue/false
Look only at titles and labels, not at what the notes say. Much quicker in a large Trilium.Default: false.
Include archived notesinclude_archivedtrue/false
Also find notes labelled #archived, which Trilium's search leaves out.Default: false.
Sort byorder_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 directionorder_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.
Limitlimitnumber
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 IDattachmenttextRequired
The ID of the attachment, as 'Create attachment' or 'List attachments' returns it.
Nametitletext
A new name, such as invoice-paid.pdf.
Formatmimetext
A new format (MIME type), such as application/pdf.
Positionpositionnumber
Where it sits among the note's attachments (10, 20, 30…).From 0 to 100000000.
Filefiletext
A file to replace the attachment's with: upload one, pick one from an earlier step, or paste a link.
Text contentcontenttext
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 IDattributetextRequired
The ID of the label or relation, as 'Add label', 'Add relation' or 'Get note' returns it.
Valuevaluetext
A new value for the label.
Positionpositionnumber
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

NotenotetextRequired
The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
Titletitletext
A new title for the note.
Typenote_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.
Formatmimetext
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 IDbranchtextRequired
The ID of the placement, as 'Create note', 'Clone note' or 'Get note' (its branch_ids) returns it.
Prefixprefixtext
Words shown before the note's title in this place only, such as Draft.
Positionpositionnumber
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": ""
}

On this page