Cloodo Project icon

Cloodo Project

Get data from Cloodo Worksuite API

Actions26

Overview

The node integrates with the Cloodo Worksuite API to retrieve multiple tasks based on various filtering criteria. It is designed to fetch a list of tasks, supporting pagination and additional filters such as search terms, status, assignee, and date ranges. This node is useful in scenarios where users want to automate task management workflows, generate reports, or synchronize task data from Cloodo into other systems.

Practical examples include:

  • Fetching all tasks assigned to a specific user within a project.
  • Retrieving tasks filtered by their status column (e.g., "In Progress", "Completed").
  • Getting tasks created or updated within a certain date range for reporting purposes.
  • Paginating through large sets of tasks to process them in batches.

Properties

Name Meaning
Page The page number of results to retrieve (pagination). Defaults to 1.
Additional Fields A collection of optional filters and limits to refine the task query:
- Limit Number of tasks to return per page. Options: 10, 25, 50.
- Search Text string to search for in tasks.
- Status ID Filter tasks by their status column ID (board column).
- Assigned To ID Filter tasks assigned to a specific user ID.
- From Date Start date filter to get tasks from this date onward (format expected by API).
- To Date End date filter to get tasks up to this date (format expected by API).

Output

The node outputs JSON data representing an array of task objects retrieved from the Cloodo API. Each task object contains details such as task identifiers, titles, statuses, assignees, dates, and other metadata as provided by the API.

If binary data were supported, it would typically represent file attachments or related media associated with tasks; however, this node focuses on JSON task data only.

Dependencies

  • Requires an active connection to the Cloodo Worksuite API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for API requests is https://erp-amz.cloodo.com/v4.
  • Proper network access to the API endpoint must be ensured.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect date formats in "From Date" or "To Date" fields may result in API errors or empty responses.
    • Using invalid IDs for status or assignee filters can lead to no matching tasks found.
    • Pagination parameters out of range might return empty results.

  • Error Messages:

    • Authentication errors usually indicate issues with the API key/token setup.
    • Validation errors from the API may point to malformed query parameters.
    • Network timeouts or unreachable host errors suggest connectivity problems.

  • Resolutions:

    • Verify and update API credentials in n8n settings.
    • Ensure date strings conform to the expected format (ISO 8601 recommended).
    • Double-check IDs used for filtering exist in the Cloodo system.
    • Test connectivity to the API endpoint outside n8n to rule out network issues.

Links and References

Discussion