Actions9
- Project Actions
- Task Actions
- Message Actions
- Calendar Actions
Overview
This node interacts with the Dooray API to retrieve multiple tasks from a specified project. It is useful for scenarios where you need to list or filter tasks based on various criteria such as creation date, due date, assigned members, tags, workflow status, and more. For example, a project manager could use this node to fetch all tasks due this week or all tasks assigned to a particular team member.
Properties
| Name | Meaning |
|---|---|
| Project ID | The unique identifier of the project from which to retrieve tasks. |
| Options | A collection of optional filters and parameters to refine the task list: |
| - CC Member IDs | Filter tasks that have specific members as CC (comma-separated list of member IDs). |
| - Created At | Filter tasks by their creation date. Supports relative terms like "today", "thisweek", "prev-7d", "next-3d" or an ISO8601 date range (e.g., 2021-01-01T00:00:00+09:00~2021-01-10T00:00:00+09:00). |
| - Due At | Filter tasks by their due date using similar formats as Created At. |
| - From Email Address | Filter tasks created from a specific email address. |
| - From Member IDs | Filter tasks created by specific members (comma-separated list of member IDs). |
| - Milestone IDs | Filter tasks associated with specific milestone IDs (comma-separated). |
| - Order | Sort order of the results. Options include: • Created At (Ascending/Descending) • Due Date (Ascending/Descending) • Updated At (Ascending/Descending) |
| - Page | Pagination page number (default is 0). |
| - Parent Post ID | Filter subtasks belonging to a specific parent task. |
| - Post Number | Filter by a specific task number. |
| - Size | Number of tasks per page (default 20, max 100). |
| - Subjects | Filter tasks by title or subject text. |
| - Tag IDs | Filter tasks by tag IDs (comma-separated). |
| - To Member IDs | Filter tasks assigned to specific members (comma-separated). |
| - Updated At | Filter tasks by update date, supporting the same formats as Created At. |
| - Workflow Classes | Filter tasks by workflow status. Possible values: Backlog, Registered, Working, Closed. |
| - Workflow IDs | Filter tasks by workflow IDs defined in the project (comma-separated). |
Output
The node outputs a JSON array containing the tasks matching the specified filters. Each task object includes details such as task ID, title, description, assigned members, dates (created, due, updated), tags, workflow status, and other relevant metadata as provided by the Dooray API.
If the node supports binary data output (not indicated here), it would typically represent attachments or files related to tasks, but this operation focuses on retrieving task metadata only.
Dependencies
- Requires an active connection to the Dooray API.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- The base URL for API requests is
https://api.dooray.com. - Proper permissions on the Dooray account to read project tasks.
Troubleshooting
- Invalid Project ID: If the project ID is incorrect or inaccessible, the node will fail to retrieve tasks. Verify the project ID and user permissions.
- API Authentication Errors: Missing or invalid API credentials will cause authorization failures. Ensure the API key/token is correctly set up in n8n.
- Rate Limits: Excessive requests may trigger rate limiting by the Dooray API. Implement retries or reduce request frequency.
- Filter Format Issues: Incorrectly formatted date filters or comma-separated lists may result in empty responses or errors. Follow the documented formats strictly.
- Pagination Confusion: Remember that page numbering starts at 0; requesting a non-existent page will return no results.