Cloodo Project icon

Cloodo Project

Get data from Cloodo Worksuite API

Actions26

Overview

The node "Cloodo Project" integrates with the Cloodo Worksuite API to retrieve and manipulate project-related data. Specifically, for the Project resource and the Milestones operation, it fetches milestone information associated with projects. This is useful in scenarios where users want to track project progress, deadlines, or deliverables by accessing milestone details programmatically within their workflows.

Practical examples include:

  • Automatically retrieving all milestones of a specific project to display in a dashboard.
  • Fetching milestone data filtered by date ranges or pagination to process or report on project timelines.
  • Integrating milestone status updates into other systems like notifications or time tracking tools.

Properties

Name Meaning
ID The unique identifier of the project or related entity to fetch milestones for.
Page The page number for paginated results when retrieving multiple milestones. Defaults to 1.
Additional Fields A collection of optional parameters to refine the request:
- Limit Number of items per page to return. Options: 10, 25, 50.
- From Date Filter milestones starting from this date (format as string).
- To Date Filter milestones up to this date (format as string).

These properties allow users to specify which project's milestones to retrieve and control pagination and date filtering to manage large datasets efficiently.

Output

The node outputs JSON data representing the milestones retrieved from the Cloodo Worksuite API. Each item in the output typically contains milestone details such as milestone ID, name, description, start and end dates, status, and any other metadata provided by the API.

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

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 configuration of the API credential in n8n is necessary to authorize requests.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Providing an incorrect or non-existent project ID may result in empty responses or errors.
    • Pagination parameters out of range might lead to no data being returned.
    • Date filters must be correctly formatted strings; otherwise, the API may reject the request.

  • Error Messages:

    • Authentication errors usually indicate invalid API keys; verify and update credentials.
    • "Not Found" errors suggest the specified project or milestone ID does not exist.
    • Rate limiting or server errors from the API should be handled by retrying after some delay.

Links and References

Discussion