Nestr icon

Nestr

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

Actions29

Overview

The node integrates with the Nestr platform to manage "Circles," which are organizational units within workspaces. Specifically, the Update Circle operation allows users to modify existing circles by changing their labels or parent relationships within a workspace.

This node is useful in scenarios where teams need to reorganize their collaboration structure dynamically, such as updating circle hierarchies or tagging circles with new labels for better categorization and filtering.

Practical example:
A project manager wants to update a circle's labels to reflect new team roles or assign it under a different parent circle to restructure the team's organization without manually navigating the Nestr UI.

Properties

Name Meaning
Workspace Name or ID Selects the workspace containing the circle to update. Can be chosen from a list or specified via expression.
Additional Fields Optional fields to update on the circle:
  Labels Comma-separated list of labels to assign to the circle (e.g., "frontend,urgent").
  Parent ID The ID of the parent circle to nest this circle under, establishing hierarchy.

Output

  • The output JSON contains the updated circle object returned from the Nestr API after the update operation.
  • This typically includes properties like the circle's ID, labels, parent relationships, and other metadata reflecting the current state post-update.
  • No binary data output is produced by this node.

Dependencies

  • Requires an active connection to the Nestr API using OAuth2 authentication configured in n8n.
  • The node depends on the nestrApiRequest helper function to communicate with the Nestr REST endpoints.
  • The user must have appropriate permissions in the selected workspace to update circles.

Troubleshooting

  • Common issues:

    • Invalid or missing workspace ID: Ensure the workspace exists and the ID is correct.
    • Incorrect parent ID: The specified parent circle must exist within the same workspace.
    • Labels format errors: Labels should be comma-separated strings without invalid characters.
    • Insufficient permissions: The API token used must have rights to update circles.

  • Error messages:

    • "error": "Circle not found" — Verify the circle ID and workspace association.
    • "error": "Unauthorized" — Check that the OAuth2 credentials are valid and have required scopes.
    • "error": "Invalid input" — Confirm that additional fields like labels and parentId are correctly formatted.

Resolving these usually involves verifying input parameters, checking API credentials, and ensuring the target resources exist.

Links and References

Discussion