Dalil AI icon

Dalil AI

Consume Dalil AI API

Actions40

Overview

This node integrates with the Dalil AI API to manage tasks within a workspace. Specifically, the Task - Update operation allows users to modify existing tasks by specifying the task's unique identifier and the fields to update. This is useful for workflows that need to programmatically adjust task details such as title, status, assignee, due date, or content.

Common scenarios include:

  • Automatically updating task statuses based on external triggers.
  • Changing task assignees when workload shifts.
  • Modifying task deadlines dynamically.
  • Editing task descriptions or titles in bulk.

For example, you could use this node to update a task’s status to "Done" once a related process completes, or assign a task to a different team member based on availability.

Properties

Name Meaning
Task ID The UUID string identifying the specific task to update. This is required to specify which task will be modified.
Update Fields A collection of fields to update on the task. These include:
• Assignee Name or ID — UUID of the workspace member assigned to the task.
• Body — Task content in plain text or markdown (automatically formatted).
• Due Date — When the task is due (ISO 8601 format).
• Status Name or ID — Task status; options are "TODO" (To do), "IN_PROGRESS" (In progress), "DONE" (Done).
• Title — Title of the task (e.g., "Complete project proposal").
Depth Name or ID Level of nested related objects to include in the response:
0 = task only,
1 = task plus direct relations,
2 = task plus relations and their relations. Can be selected from predefined options or specified via expression.

Output

The node outputs JSON data representing the updated task object returned by the Dalil AI API. The structure includes all task properties after the update, potentially including nested related objects depending on the Depth parameter.

If the node supports binary data output (not indicated here), it would typically represent attachments or files related to the task, but this operation focuses on JSON task data only.

Dependencies

  • Requires an active connection to the Dalil AI API.
  • Needs an API key credential configured in n8n for authentication.
  • Uses internal helper functions to format markdown content into rich text blocks.
  • Relies on the Dalil AI API endpoints for tasks (/rest/tasks/{taskId}) with PATCH HTTP method.

Troubleshooting

  • Invalid Task ID: If the provided Task ID does not exist or is malformed, the API will return an error. Verify the UUID string is correct.
  • Invalid Field Values: Providing unsupported values for fields like status or assignee may cause errors. Use the dropdown options or valid UUIDs.
  • Permission Errors: Ensure the API key has sufficient permissions to update tasks.
  • Malformed Markdown: If the body field contains invalid markdown, formatting might fail silently or cause unexpected results.
  • API Rate Limits: Frequent updates may hit rate limits imposed by the Dalil AI API.

To resolve errors:

  • Double-check input parameters for correctness.
  • Use expressions carefully to ensure they evaluate to valid values.
  • Review API credentials and permissions.
  • Consult API documentation for field constraints.

Links and References

Discussion