Cloodo Project icon

Cloodo Project

Get data from Cloodo Worksuite API

Overview

The node integrates with the Cloodo Worksuite API to manage project-related data. Specifically, the "Update" operation on the "Project" resource allows users to modify existing project details such as status, deadline, client association, category, assigned members, and custom fields.

This node is beneficial in scenarios where project management workflows require automated updates to project information based on external triggers or data changes. For example, when a project's deadline shifts or its status changes due to progress updates, this node can programmatically update those details in Cloodo Worksuite without manual intervention.

Practical examples:

  • Automatically marking a project as "Finished" once all tasks are completed.
  • Updating the project deadline based on client feedback received through another system.
  • Assigning a new team member to a project dynamically from an HR system.

Properties

Name Meaning
ID The unique identifier of the project to update.
Additional Fields A collection of optional fields to update on the project:
- Custom Fields Data JSON string representing custom field values to set, e.g., {"custom-field-name_256": ""}.
- Status The current status of the project. Options: In Progress, Finished, Canceled, On Hold, Not Started.
- Deadline The project's deadline date and time.
- Client ID JSON value representing the client associated with the project.
- Category ID String identifier for the category the project belongs to.
- Member ID String identifier for a user/member assigned to the project.

Output

The node outputs JSON data representing the updated project object as returned by the Cloodo Worksuite API. This typically includes the project's updated fields reflecting the changes made during the update operation.

There is no indication that the node outputs binary data.

Dependencies

  • Requires an API key credential for authenticating requests to the Cloodo Worksuite API.
  • The base URL for API requests is https://erp-amz.cloodo.com/v4.
  • The node expects JSON content-type headers and accepts JSON responses.

Troubleshooting

  • Invalid or missing project ID: Ensure the "ID" property is correctly set to the target project's identifier; otherwise, the API will fail to locate the project.
  • Malformed JSON in custom fields or client ID: The node expects valid JSON strings for fields like "Custom Fields Data" and "Client ID". Invalid JSON will cause parsing errors.
  • Unauthorized errors: Verify that the API key credential is valid and has sufficient permissions to update projects.
  • Invalid status value: Only the predefined status options are accepted; using unsupported values may result in errors.
  • Date format issues: The "Deadline" must be a valid date-time string; incorrect formats might cause request failures.

Links and References

  • Cloodo Worksuite API Documentation (assumed base URL, check official docs for detailed API reference)
  • JSON formatting guidelines for custom fields and IDs should follow standard JSON syntax.

Discussion