Actions40
- Company Actions
- Note Actions
- Note Relation Actions
- Opportunity Actions
- Person Actions
- Pipeline Actions
- Task Actions
- Task Relation Actions
Overview
This node integrates with the Dalil AI API to manage various CRM-related resources, including tasks. Specifically, for the Task resource and the Get operation, it retrieves detailed information about a single task identified by its unique Task ID. The node supports specifying the depth of related nested objects to include in the response, allowing users to fetch just the task or also its related entities up to two levels deep.
This functionality is useful in scenarios where you want to programmatically access task details from Dalil AI within an automation workflow, such as:
- Fetching task details to update other systems or trigger notifications.
- Retrieving task information along with related data (e.g., assignees, linked opportunities) for reporting or analysis.
- Integrating task data into dashboards or custom applications.
Example: You have a task UUID and want to get all its direct relations (depth 1) to display comprehensive task info in your app.
Properties
Name | Meaning |
---|---|
Task ID | The UUID string uniquely identifying the task to retrieve. |
Depth Name or ID | Level of nested related objects to include in the response: - 0: Task only - 1: Task + direct relations - 2: Task + relations + their relations |
Output
The output JSON contains the full details of the requested task as returned by the Dalil AI API. This includes all standard task fields such as title, status, due date, assignee, visibility, and optionally nested related objects depending on the specified depth.
No binary data output is produced by this operation.
Example output structure (simplified):
{
"id": "task-uuid",
"title": "Follow up with client",
"status": "IN_PROGRESS",
"dueAt": "2024-07-01T12:00:00Z",
"assigneeId": "user-uuid",
"visibilityLevel": 1,
"groupId": "group-uuid",
"bodyV2": {
"markdown": "Task description here",
"blocknote": { /* formatted blocknote content */ }
},
"relatedObjects": {
/* nested related objects depending on depth */
}
}
Dependencies
- Requires an active connection to the Dalil AI API.
- Needs an API key credential configured in n8n for authentication.
- The node uses internal helper functions to format text and process field metadata but no external libraries beyond those bundled.
Troubleshooting
- Invalid Task ID: If the provided Task ID is not a valid UUID or does not exist, the API will return an error. Verify the Task ID correctness.
- Permission Errors: Insufficient API permissions or invalid API key may cause authorization errors. Ensure the API key has rights to read tasks.
- Depth Parameter Issues: Providing an unsupported depth value may result in unexpected responses or errors. Use only 0, 1, or 2 as allowed.
- API Response Structure Changes: If the Dalil AI API changes its response format, the node might fail to parse results correctly. Check for updates or contact support.
- Network Issues: Connectivity problems can cause request failures. Confirm network access to the Dalil AI API endpoint.
Links and References
- Dalil AI API Documentation (hypothetical link)
- n8n Expressions Documentation - for using expressions in parameters like Depth
- UUID Format Reference
If you need summaries for other operations or resources, please provide their names.