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 create a new Circle within a specified Workspace. Circles in Nestr represent collaborative groups or teams, enabling role-based and self-organized collaboration. This node is useful for automating team setup workflows, organizing projects by groups, or dynamically managing organizational structures.

Practical examples:

  • Automatically creating a new Circle when onboarding a new department.
  • Setting up Circles for different project teams based on incoming data.
  • Organizing users into Circles programmatically as part of a larger automation workflow.

Properties

Name Meaning
Workspace Name or ID Select the workspace where the Circle will be created. Choose from a list or specify an ID via expression.
Additional Fields Optional extra parameters for the Circle creation:
  Labels Comma-separated list of labels to tag the Circle.
  Parent ID The ID of a parent item to associate hierarchically with this Circle.

Output

The node outputs JSON data representing the newly created Circle object returned from the Nestr API. This typically includes details such as the Circle's unique ID, name, associated workspace, labels, and any hierarchical relationships (parent IDs).

No binary data output is produced by this node.

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 target Workspace to create 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 API credentials must have rights to create Circles in the selected Workspace.
    • Network or API errors: Check connectivity and API status.

  • Error messages:

    • Errors returned from the API are surfaced as error messages in the node output.
    • If "Continue On Fail" is enabled, errors for individual items will be included in the output JSON with an error field describing the issue.
    • To resolve errors, verify input parameters, API credentials, and network access.

Links and References

Discussion