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 Many operation, it retrieves multiple task records from the Dalil AI system. Users can fetch all tasks or limit the number of returned results, apply sorting, filtering, and control the depth of related nested objects included in the response.
This operation is beneficial when you want to bulk retrieve task data for reporting, synchronization, or automation workflows. For example, you might use it to get all pending tasks assigned to a specific user or to fetch tasks due within a certain date range.
Properties
| Name | Meaning |
|---|---|
| Return All | Boolean flag indicating whether to return all matching task records or only up to a specified limit. |
| Limit | Maximum number of task records to return if "Return All" is false. Must be at least 1. |
| Options | Collection of additional options to customize the query: |
| - Order By | Sort the results by one or more fields. Format: "field1,field2[Direction]". Directions include AscNullsFirst, AscNullsLast, DescNullsFirst, DescNullsLast. Example: "createdAt,title[DescNullsLast]". |
| - Filter | Filter results using field conditions. Format: "field[comparator]:value". Supported comparators: eq, neq, in, gt, gte, lt, lte, startsWith, like, ilike, is (for NULL/NOT_NULL). Example: "status[eq]:TODO". |
| - Depth | Level of nested related objects to include in the response. Options are: 0 (tasks only), 1 (tasks + direct relations), 2 (tasks + relations + their relations). Can be selected from a list or specified via expression. |
Output
The output consists of an array of JSON objects, each representing a task record retrieved from the Dalil AI API. Each object contains the full details of a task, including fields such as title, status, due date, assignee, visibility level, group ID, body content (in markdown and blocknote formats), creation source, and any other metadata provided by the API.
If the "Return All" option is enabled, all matching tasks are returned; otherwise, the output includes up to the specified limit.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Dalil AI API.
- The node requires an API key credential configured in n8n to authenticate requests to the Dalil AI service.
- No additional environment variables are needed beyond the API authentication setup.
Troubleshooting
Common Issues:
- Invalid filter or orderBy syntax may cause API errors. Ensure filters follow the documented format and comparators.
- Requesting too many records without pagination or limits may lead to timeouts or rate limiting.
- Specifying an invalid depth value or malformed expressions for depth may result in incomplete or failed responses.
Error Messages:
- Errors related to unexpected API response structure indicate possible changes in the Dalil AI API or connectivity issues.
- Parsing errors on custom properties (not directly relevant here but common in other operations) suggest malformed input data.
- Authentication errors occur if the API key credential is missing or invalid.
Resolutions:
- Validate filter and orderBy strings carefully.
- Use the "Limit" property to restrict the number of results if not returning all.
- Confirm API credentials are correctly set up and have necessary permissions.
- Check network connectivity and API status if unexpected errors persist.
Links and References
- Dalil AI API Documentation (hypothetical link, replace with actual if available)
- n8n Expressions Documentation
- n8n Node Development Guide
Note: This summary focuses exclusively on the Task resource's Get Many operation as requested.