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 platform to manage various collaboration resources such as projects, roles, circles, nests, and workspaces. Specifically, for the Nest - Create operation, it allows users to create a new nest entity within a specified workspace. This is useful in scenarios where teams want to organize their collaborative efforts into hierarchical structures called nests, which can represent grouped projects or organizational units.

Practical examples include:

  • Automatically creating a new nest when onboarding a new team or department.
  • Structuring projects under specific nests for better role-based access and self-organization.
  • Integrating Nestr nest creation into automated workflows that respond to external triggers like form submissions or CRM events.

Properties

Name Meaning
Workspace Name or ID Select the workspace to work with. Choose from a list of available workspaces or specify an ID using an expression.
Additional Fields Optional extra fields to customize the nest creation:
  Labels Comma-separated list of labels to tag the nest.
  Parent ID The ID of a parent item to nest this new nest under (for hierarchical organization).

Output

The node outputs JSON data representing the newly created nest object returned by the Nestr API. This typically includes details such as the nest's unique identifier, title, description, associated workspace, labels, parent relationships, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Nestr API via OAuth2 authentication.
  • The node depends on the nestrApiRequest helper function to communicate with the Nestr REST API endpoints.
  • The user must have appropriate permissions in the selected workspace to create nests.
  • 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 create nests in the workspace.
    • Incorrect label formatting: Labels should be comma-separated strings without extra spaces.
    • Parent ID does not exist or is invalid: Verify the parent nest or item ID if provided.

  • Error Messages:

    • API errors will typically return messages indicating the cause, such as "Workspace not found" or "Unauthorized".
    • Network or authentication failures may result in timeout or 401 Unauthorized errors.

  • Resolutions:

    • Double-check all input parameters, especially workspace ID and additional fields.
    • Confirm OAuth2 credentials are valid and have required scopes.
    • Use expressions carefully to ensure dynamic values resolve correctly.
    • Review Nestr API documentation for any changes in endpoint requirements.

Links and References

Discussion