Cloodo Project icon

Cloodo Project

Get data from Cloodo Worksuite API

Actions26

Overview

This node integrates with the Cloodo Worksuite API to retrieve multiple milestone records. It is designed to fetch a paginated list of milestones, optionally filtered and sorted by various criteria such as status, date range, person in charge, and search terms. This functionality is useful for project managers or team members who want to monitor progress by viewing milestones in bulk, analyze timelines, or generate reports on project phases.

Practical examples include:

  • Retrieving all incomplete milestones assigned to a specific team member.
  • Fetching milestones within a certain date range to review upcoming deadlines.
  • Sorting milestones by creation date or priority to prioritize work.

Properties

Name Meaning
Page The page number of results to retrieve (pagination).
Additional Fields A collection of optional filters and settings:
- Limit Number of milestones to return per page. Options: 10, 25, 50.
- Search Text string to search milestones by name or description.
- Sort By Field name to sort the milestones by (e.g., date, priority).
- Person in Charge Filter milestones assigned to a specific user by their ID.
- Sort Order Order of sorting: Ascending or Descending.
- Status Filter milestones by completion status. Options: Complete, Incomplete.
- From Date Start date filter to get milestones from this date onward.
- To Date End date filter to get milestones up to this date.
- Add Cost To Project Budget Option to add milestone cost to the overall project budget. Options: Yes, No.

Output

The node outputs JSON data containing an array of milestone objects matching the query parameters. Each milestone object typically includes details such as milestone ID, name, status, assigned person, dates, and possibly cost information if applicable.

If binary data were supported (not indicated here), it would represent attachments or files related to milestones, but this node focuses on JSON data retrieval.

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.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect pagination parameters may result in empty responses.
    • Filtering by invalid field values (e.g., non-existent user IDs) returns no data.
    • Date format errors in "From Date" or "To Date" fields can cause request failures.

  • Error Messages:

    • Authentication errors usually indicate invalid or expired API tokens; reconfigure credentials.
    • Validation errors on query parameters suggest checking input formats and allowed values.
    • Network or timeout errors imply connectivity issues with the Cloodo API endpoint.

Links and References

Discussion