# Trilium Notes

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

App · 37 actions. Web page: https://docs.lodol.com/docs/integrations/trilium

## Actions

### 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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Label (`name`, text, required): The label's name, such as todo.
- Value (`value`, text): A value for the label, such as waiting. Leave blank for a label with none.
- Inheritable (`inheritable`, true/false): Whether the notes under this note get it too. Default: `false`.

**Outputs**

- `created` (true/false): Whether it was added now: false when the note already had the same one
- `id` (text): The ID of the label or relation, which 'Update attribute' and 'Delete attribute' take
- `inheritable` (true/false): Whether the note's child notes get it too
- `name` (text): Its name, without the # or ~
- `note_id` (text): The ID of the note it's on
- `position` (number): Its position among the note's attributes
- `type` (text): label or relation
- `value` (text): A label's value, or the ID of the note a relation points to

**Example output**

```json
{
  "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 (`title`, text, required): What to call the note.
- Content (`content`, text): What the note says.
- Content is (`content_format`, text): 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 (`date`, date): The day to file it under. Leave blank for today.

**Outputs**

- `branch_id` (text): The ID of its placement under the day's note
- `branch_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `date` (text): The day it was filed under (YYYY-MM-DD)
- `day_note_id` (text): The ID of that day's note, which the new note sits under
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `relations` (list): Its relations to other notes
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Relation (`name`, text, required): The relation's name, such as project.
- Target note (`target`, text, required): 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 (`inheritable`, true/false): Whether the notes under this note get it too. Default: `false`.

**Outputs**

- `created` (true/false): Whether it was added now: false when the note already had the same one
- `id` (text): The ID of the label or relation, which 'Update attribute' and 'Delete attribute' take
- `inheritable` (true/false): Whether the note's child notes get it too
- `name` (text): Its name, without the # or ~
- `note_id` (text): The ID of the note it's on
- `position` (number): Its position among the note's attributes
- `type` (text): label or relation
- `value` (text): A label's value, or the ID of the note a relation points to

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Content (`content`, text, required): What to add at the end of the note.
- Content is (`content_format`, text): 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_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `relations` (list): Its relations to other notes
- `size` (number): How many characters the note's content has now
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Parent note (`parent`, text, required): 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 (`prefix`, text): Words shown before the note's title in this place only, such as Draft.
- Position (`position`, number): 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**

- `created` (true/false): Whether the note was placed there now: false when it was already under that parent
- `id` (text): The placement's ID, which 'Update placement' and 'Remove placement' take
- `note_id` (text): The ID of the note that's placed
- `parent_note_id` (text): The ID of the note it's placed under
- `position` (number): Its position among the parent's notes (10, 20, 30…)
- `prefix` (text): The words shown before the note's title in this place, if any

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- File (`file`, text): The file to attach: upload one, pick one from an earlier step, or paste a link.
- Text content (`content`, text): Text to attach instead of a file.
- Name (`title`, text): What to call the attachment, such as invoice.pdf. Leave blank to use the file's name.
- Format (`mime`, text): The attachment's format (its MIME type), such as application/pdf. Leave blank to work it out from the file.

**Outputs**

- `id` (text): The attachment's ID, which the other attachment steps take
- `mime` (text): Its format, such as application/pdf
- `modified_at` (text): When it last changed (UTC)
- `note_id` (text): The ID of the note it's attached to
- `position` (number): Its position among the note's attachments
- `role` (text): image for a picture, file for anything else
- `size` (number): Its size in bytes
- `title` (text): Its name, such as invoice.pdf

**Example output**

```json
{
  "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 (`name`, text): 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**

- `created` (true/false): True once the backup is written
- `file_name` (text): The backup's file, in the backup folder of Trilium's data directory
- `name` (text): The name the backup was given

**Example output**

```json
{
  "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 (`title`, text, required): What to call the note.
- Parent note (`parent`, text): 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 (`content`, text): What the note says.
- Content is (`content_format`, text): 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_type`, text): 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 (`mime`, text): The content's format (its MIME type), such as application/json for a code note. Leave blank to let Trilium Notes choose.
- File (`file`, text): 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 (`position`, number): 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 (`prefix`, text): Words shown before the note's title in this place only, such as Draft.

**Outputs**

- `branch_id` (text): The ID of its placement under the parent, which 'Update placement' takes
- `branch_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `position` (number): Its position among the parent's notes (10, 20, 30…)
- `relations` (list): Its relations to other notes
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.

**Outputs**

- `created` (true/false): True once the revision is saved
- `note_id` (text): The note's ID
- `revision_id` (text): The new revision's ID, blank on a Trilium too old to list revisions
- `title` (text): The note's title

**Example output**

```json
{
  "created": true,
  "note_id": "evnnmvHTCgIn",
  "revision_id": "dXjnGjT08Rv0",
  "title": "Meeting with Dana"
}
```

### Delete attachment

Delete an attachment from its note.

**Inputs**

- Attachment ID (`attachment`, text, required): The ID of the attachment, as 'Create attachment' or 'List attachments' returns it.

**Outputs**

- `deleted` (true/false): True once the attachment is deleted
- `id` (text): The ID of the attachment that was deleted
- `note_id` (text): The ID of the note it was attached to
- `title` (text): Its name

**Example output**

```json
{
  "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 (`attribute`, text, required): The ID of the label or relation, as 'Add label', 'Add relation' or 'Get note' returns it.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `id` (text): The ID of the label or relation that was deleted
- `name` (text): Its name
- `note_id` (text): The ID of the note it was on
- `type` (text): label or relation

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.

**Outputs**

- `deleted` (true/false): True once the note is deleted
- `id` (text): The ID of the note that was deleted
- `title` (text): Its title

**Example output**

```json
{
  "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 (`attachment`, text, required): The ID of the attachment, as 'Create attachment' or 'List attachments' returns it.

**Outputs**

- `content_type` (text): The file's format, such as application/zip
- `document_ref` (text): The file saved in Lodol, which a later step can use
- `filename` (text): The file's name
- `id` (text): The attachment's ID
- `is_text` (true/false): Whether the attachment is text
- `mime` (text): Its format, such as application/pdf
- `size_bytes` (number): The file's size in bytes
- `text` (text): What it says, when it's text; blank for a picture or other file
- `title` (text): The attachment's name
- `url` (text): Where the saved file can be opened in Lodol

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.

**Outputs**

- `content_type` (text): The file's format, such as application/zip
- `document_ref` (text): The file saved in Lodol, which a later step can use
- `filename` (text): The file's name
- `note_id` (text): The note's ID
- `size_bytes` (number): The file's size in bytes
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as file or image
- `url` (text): Where the saved file can be opened in Lodol

**Example output**

```json
{
  "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 (`note`, text, required): 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_format`, text): What the notes in the ZIP are written as. One of: `html`, `markdown`. Default: `html`.

**Outputs**

- `content_type` (text): The file's format, such as application/zip
- `document_ref` (text): The file saved in Lodol, which a later step can use
- `filename` (text): The file's name
- `format` (text): html or markdown: what the notes inside the ZIP are written as
- `note_id` (text): The ID of the note that was exported, with the notes under it
- `size_bytes` (number): The file's size in bytes
- `title` (text): The note's title
- `url` (text): Where the saved file can be opened in Lodol

**Example output**

```json
{
  "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 (`label`, text, required): The label's name, such as todo.
- Value (`value`, text): Only notes whose label has this value, such as waiting for #status = waiting. Leave blank for any value.
- Under note (`ancestor`, text): 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_archived`, true/false): Also find notes labelled #archived, which Trilium's search leaves out. Default: `false`.
- Limit (`limit`, number): The most notes to return, up to 500. Leave blank for 50. From 1 to 500.

**Outputs**

- `count` (number): How many notes were found
- `notes` (list): The notes found
- `query` (text): The search Trilium ran, as its own search box takes it

**Example output**

```json
{
  "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 (`attachment`, text, required): The ID of the attachment, as 'Create attachment' or 'List attachments' returns it.

**Outputs**

- `id` (text): The attachment's ID, which the other attachment steps take
- `mime` (text): Its format, such as application/pdf
- `modified_at` (text): When it last changed (UTC)
- `note_id` (text): The ID of the note it's attached to
- `position` (number): Its position among the note's attachments
- `role` (text): image for a picture, file for anything else
- `size` (number): Its size in bytes
- `title` (text): Its name, such as invoice.pdf

**Example output**

```json
{
  "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 (`date`, date): The day. Leave blank for today.

**Outputs**

- `branch_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `date` (text): The date the note was asked for (YYYY-MM-DD)
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `relations` (list): Its relations to other notes
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`date`, date): The day. Leave blank for today.

**Outputs**

- `branch_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `date` (text): The date the note was asked for (YYYY-MM-DD)
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `relations` (list): Its relations to other notes
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`date`, date): Any day in the month. Leave blank for this month.

**Outputs**

- `branch_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `date` (text): The date the note was asked for (YYYY-MM-DD)
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `relations` (list): Its relations to other notes
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.

**Outputs**

- `branch_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `relations` (list): Its relations to other notes
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.

**Outputs**

- `content` (text): The content as Trilium keeps it: HTML for a text note, the code of a code note
- `id` (text): The note's ID
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `size` (number): How many characters the content has
- `text` (text): The same as Markdown (plain, readable text), for a message or an AI step
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text or code

**Example output**

```json
{
  "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_date` (text): When that version was built
- `build_revision` (text): The source revision it was built from
- `data_directory` (text): The folder on the server where Trilium keeps its data
- `database_version` (number): The version of its database
- `server` (text): The address of the Trilium server
- `sync_version` (number): The version of its sync protocol
- `version` (text): The Trilium version the server runs, such as 0.107.0

**Example output**

```json
{
  "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 (`date`, date): Any day in the week. Leave blank for this week.

**Outputs**

- `branch_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `date` (text): The date the note was asked for (YYYY-MM-DD)
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `relations` (list): Its relations to other notes
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`date`, date): Any day in the year. Leave blank for this year.

**Outputs**

- `branch_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `date` (text): The date the note was asked for (YYYY-MM-DD)
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `relations` (list): Its relations to other notes
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.

**Outputs**

- `attachments` (list): The note's attachments
- `count` (number): How many there are
- `note_id` (text): The note's ID

**Example output**

```json
{
  "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 (`note`, text, required): 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**

- `count` (number): How many there are
- `notes` (list): The notes under it, in their order
- `parent_id` (text): The ID of the note they sit under

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- New parent note (`parent`, text, required): 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_parent`, text): 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_id` (text): The ID of the note it was taken from under
- `id` (text): The placement's ID, which 'Update placement' and 'Remove placement' take
- `moved` (true/false): Whether the note was moved: false when it was already under that parent
- `note_id` (text): The ID of the note that's placed
- `parent_note_id` (text): The ID of the note it's placed under
- `position` (number): Its position among the parent's notes (10, 20, 30…)
- `prefix` (text): The words shown before the note's title in this place, if any

**Example output**

```json
{
  "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 (`parent`, text, required): 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_id` (text): The ID of the note whose child notes were refreshed
- `refreshed` (true/false): True once open Trilium windows have been told the new order

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Label (`name`, text, required): The label's name, such as todo.

**Outputs**

- `attribute_ids` (list): The IDs of the labels removed
- `name` (text): The label's name
- `note_id` (text): The note's ID
- `removed` (number): How many labels with that name were taken off the note

**Example output**

```json
{
  "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 (`branch`, text, required): The ID of the placement, as 'Create note', 'Clone note' or 'Get note' (its branch_ids) returns it.

**Outputs**

- `deleted` (true/false): True once the placement is removed
- `id` (text): The ID of the placement that was removed
- `note_deleted` (true/false): Whether the note itself was deleted, because this was its only place
- `note_id` (text): The ID of the note
- `parent_note_id` (text): The ID of the note it was under

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Content (`content`, text, required): What the note should say now.
- Content is (`content_format`, text): 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_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `relations` (list): Its relations to other notes
- `size` (number): How many characters the note's content has now
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`query`, text, required): 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 (`ancestor`, text): 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_only`, true/false): With 'Under note', only notes directly under it, not deeper. Default: `false`.
- Fast search (`fast_search`, true/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_archived`, true/false): Also find notes labelled #archived, which Trilium's search leaves out. Default: `false`.
- Sort by (`order_by`, text): 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_direction`, text): 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 (`limit`, number): The most notes to return, up to 500. Leave blank for 50. From 1 to 500.

**Outputs**

- `count` (number): How many notes were found
- `notes` (list): The notes found
- `query` (text): The search Trilium ran, as its own search box takes it

**Example output**

```json
{
  "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 (`attachment`, text, required): The ID of the attachment, as 'Create attachment' or 'List attachments' returns it.
- Name (`title`, text): A new name, such as invoice-paid.pdf.
- Format (`mime`, text): A new format (MIME type), such as application/pdf.
- Position (`position`, number): Where it sits among the note's attachments (10, 20, 30…). From 0 to 100000000.
- File (`file`, text): A file to replace the attachment's with: upload one, pick one from an earlier step, or paste a link.
- Text content (`content`, text): Text to replace the attachment's with, instead of a file.

**Outputs**

- `id` (text): The attachment's ID, which the other attachment steps take
- `mime` (text): Its format, such as application/pdf
- `modified_at` (text): When it last changed (UTC)
- `note_id` (text): The ID of the note it's attached to
- `position` (number): Its position among the note's attachments
- `role` (text): image for a picture, file for anything else
- `size` (number): Its size in bytes
- `title` (text): Its name, such as invoice.pdf

**Example output**

```json
{
  "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 (`attribute`, text, required): The ID of the label or relation, as 'Add label', 'Add relation' or 'Get note' returns it.
- Value (`value`, text): A new value for the label.
- Position (`position`, number): Where it sits among the note's labels and relations (10, 20, 30…). From 0 to 100000000.

**Outputs**

- `id` (text): The ID of the label or relation, which 'Update attribute' and 'Delete attribute' take
- `inheritable` (true/false): Whether the note's child notes get it too
- `name` (text): Its name, without the # or ~
- `note_id` (text): The ID of the note it's on
- `position` (number): Its position among the note's attributes
- `type` (text): label or relation
- `value` (text): A label's value, or the ID of the note a relation points to

**Example output**

```json
{
  "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 (`note`, text, required): The note: its ID (from another Trilium Notes step), a link to it copied from your browser, or its exact title.
- Title (`title`, text): A new title for the note.
- Type (`note_type`, text): 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 (`mime`, text): The content's format (its MIME type), such as application/json for a code note. Leave blank to let Trilium Notes choose.

**Outputs**

- `branch_ids` (list): The IDs of its placements in the tree (one for each parent), which 'Update placement' and 'Remove placement' take
- `child_count` (number): How many notes are under it
- `child_ids` (list): The IDs of the notes under it, in their order
- `created_at` (text): When it was created (UTC)
- `id` (text): The note's ID, which other Trilium Notes steps take
- `is_archived` (true/false): Whether it carries the #archived label
- `is_protected` (true/false): Whether it's a protected (encrypted) note, which can't be read or changed from outside Trilium
- `label_names` (list): The names of its labels
- `labels` (list): Its labels
- `link` (text): Where the note opens in Trilium
- `mime` (text): The format of its content, such as text/html
- `modified_at` (text): When its title or content last changed (UTC)
- `parent_ids` (list): The IDs of the notes it sits under
- `relations` (list): Its relations to other notes
- `title` (text): The note's title
- `type` (text): What kind of note it is, such as text, code, book, file or image

**Example output**

```json
{
  "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 (`branch`, text, required): The ID of the placement, as 'Create note', 'Clone note' or 'Get note' (its branch_ids) returns it.
- Prefix (`prefix`, text): Words shown before the note's title in this place only, such as Draft.
- Position (`position`, number): 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**

- `id` (text): The placement's ID, which 'Update placement' and 'Remove placement' take
- `note_id` (text): The ID of the note that's placed
- `parent_note_id` (text): The ID of the note it's placed under
- `position` (number): Its position among the parent's notes (10, 20, 30…)
- `prefix` (text): The words shown before the note's title in this place, if any

**Example output**

```json
{
  "id": "w7aPu2ZLnQ0d_evnnmvHTCgIn",
  "note_id": "evnnmvHTCgIn",
  "parent_note_id": "w7aPu2ZLnQ0d",
  "position": 20,
  "prefix": ""
}
```
