Nestr icon

Nestr

Manage projects, roles, circles, and workspaces in Nestr - Role-based and self-organized collaboration
Join our community

Actions29

Overview

This node integrates with the Nestr project management platform to manage "Circles" within workspaces. Specifically, the Delete Circle operation allows users to remove a circle from a specified workspace. Circles in Nestr represent groups or teams that organize collaboration and roles.

Typical use cases include:

  • Automating cleanup of obsolete or completed circles.
  • Managing organizational structure dynamically by removing circles no longer needed.
  • Integrating with workflows that require conditional deletion of circles based on external triggers.

For example, after archiving a project, you might want to delete its associated circle automatically to keep your workspace tidy.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the circle to delete. Choose from a list or specify an ID via expression.
Additional Fields Optional extra parameters for the delete operation:
  Labels Comma-separated list of labels (not typically used for delete but available as additional info).
  Parent ID Parent item ID (optional metadata, not required for deletion).

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will be confirmation of deletion or details about the deleted circle if returned by the API.

  • The output is structured as an array of JSON objects, each corresponding to an input item processed.
  • If the deletion is successful, the output may contain status information or the deleted circle's data.
  • In case of failure, error messages are included in the output if "Continue On Fail" is enabled.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Nestr API using OAuth2 authentication.
  • The node depends on the nestrApiRequest helper function to communicate with the Nestr REST API.
  • The user must have appropriate permissions in the selected workspace to delete circles.
  • The workspace list is dynamically loaded via the getWorkspaces method, which fetches available workspaces from the API.

Troubleshooting

  • Common Issues:

    • Invalid or missing workspace ID: Ensure the workspace exists and the ID is correct.
    • Insufficient permissions: The authenticated user must have rights to delete circles in the workspace.
    • Network or API errors: Check connectivity and API availability.

  • Error Messages:

    • "error": "Circle not found": The specified circle ID does not exist or has already been deleted.
    • Authentication errors: Verify that the OAuth2 credentials are valid and have not expired.
    • Rate limiting or quota exceeded: Wait and retry later or check API usage limits.

  • To resolve errors, verify input parameters, ensure proper authentication, and consult Nestr API documentation for specific error codes.

Links and References

Discussion