Actions26
- Milestone Actions
- Project Actions
- Project Admin Actions
- Task Actions
- Time Log Actions
Overview
The "Cloodo Project" node integrates with the Cloodo Worksuite API to retrieve project-related data. Specifically, the Get Many operation under the Project resource fetches multiple projects based on various filtering and pagination options. This node is useful for scenarios where users want to list or analyze multiple projects from their Cloodo workspace, such as generating reports, syncing project data to other systems, or monitoring project statuses.
Practical examples include:
- Retrieving all active projects for a client dashboard.
- Filtering projects by status or date range to track progress.
- Searching projects by keywords or filtering by category or assigned members.
Properties
| Name | Meaning |
|---|---|
| Page | The page number of results to retrieve (pagination). Default is 1. |
| Limit | Number of projects to return per page. Options: 10, 25, 50. Default is 10. |
| Status | Filter projects by their current status. Options: In Progress, Finished, Canceled, On Hold, Not Started. Default is In Progress. |
| Search | A search string to filter projects by matching text. |
| Filter by Category ID | Filter projects belonging to a specific category by its ID. |
| Filter by Client ID | Filter projects associated with a specific client by their ID. |
| Filter by Member ID | Filter projects that include a specific member by their ID. |
| From Date | Start date to filter projects created or updated after this date (format expected by API). |
| To Date | End date to filter projects created or updated before this date (format expected by API). |
Output
The node outputs JSON data representing an array of project objects retrieved from the Cloodo API. Each project object typically contains details such as project ID, name, status, client info, category, members, dates, and other metadata as provided by the API.
If binary data were supported (not indicated here), it would represent attachments or files related to projects, but this node focuses on JSON project data only.
Dependencies
- Requires an API key credential for authenticating with the Cloodo Worksuite API.
- The base URL for API requests is
https://erp-amz.cloodo.com/v4. - Proper network access to the Cloodo API endpoint is necessary.
- No additional external dependencies beyond standard HTTP request capabilities.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication errors.
- Incorrect date formats in "From Date" or "To Date" may result in API rejections or empty results.
- Using invalid IDs for filters (category, client, member) may yield no results.
- Pagination parameters out of range might return empty pages.
Error messages:
- Authentication failures: Check that the API key credential is correctly configured and has proper permissions.
- Validation errors from the API: Verify that all filter values conform to expected formats and valid IDs.
- Network errors: Ensure connectivity to the Cloodo API endpoint and no firewall restrictions.
Links and References
- Cloodo Worksuite API Documentation (Assumed typical location; replace with actual if known)
- n8n documentation on HTTP Request Node for understanding API integrations.