Dalil AI icon

Dalil AI

Consume Dalil AI API

Overview

This node integrates with the Dalil AI API to manage "Note" resources, specifically supporting the update operation for notes. It allows users to modify existing notes by specifying the note's unique identifier and updating fields such as the title and body content. The node supports rich text formatting by converting markdown input into a structured format suitable for display.

Typical use cases include:

  • Updating meeting notes or project updates stored in Dalil AI.
  • Modifying note content dynamically based on workflow triggers.
  • Automating note edits in response to external events or data changes.

For example, you could automate updating a note titled "Project Update" with new status information or meeting summaries formatted in markdown.

Properties

Name Meaning
Note ID UUID string identifying the specific note to update (required).
Update Fields Collection of fields to update:
- Title: New title of the note (e.g., "Meeting Notes").
- Body: Content of the note in plain text or markdown; automatically converted to rich text format.
Depth Name or ID Level of nested related objects to include in the response:
- 0: Note only.
- 1: Note plus directly related objects.
- 2: Note, its relations, and their relations.
Can be selected from options or specified via expression.

Output

The node outputs JSON data representing the updated note object returned by the Dalil AI API. This includes all updated fields and any related nested objects depending on the specified depth level.

The output structure typically contains:

  • The note's unique identifier.
  • Updated title and body content (in rich text format).
  • Metadata such as visibility, group association, position, and createdBy source if provided.
  • Related objects if depth > 0 is specified.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to the Dalil AI API.
  • Needs an API authentication token configured in n8n credentials for Dalil AI.
  • Utilizes internal helper functions for formatting markdown to rich text and processing field values.
  • The node depends on the Dalil AI REST endpoints for notes (/rest/notes/{noteId}).

Troubleshooting

  • Invalid Note ID: If the provided Note ID is not a valid UUID or does not exist, the API will return an error. Verify the Note ID correctness.
  • Empty Update Fields: If no fields are provided to update, the request may fail or have no effect. Ensure at least one field (title or body) is set.
  • Markdown Formatting Issues: Body content is converted from markdown to a rich text blocknote format. Invalid markdown might cause unexpected formatting.
  • API Authentication Errors: Ensure the API key credential is correctly configured and has permissions to update notes.
  • Depth Parameter Misuse: Providing an invalid depth value or malformed expression can cause errors. Use the provided options or valid expressions.

If the node throws errors about custom property processing, it indicates issues parsing or handling additional fields beyond the standard ones.

Links and References


This summary focuses exclusively on the "Note" resource and the "Update" operation as requested.

Discussion