Nestr
Manage projects, roles, circles, and workspaces in Nestr - Role-based and self-organized collaboration
Actions29
Overview
This node integrates with the Nestr platform to manage roles within a workspace. Specifically, the "Role" resource with the "Create" operation allows users to create new roles in a specified workspace. This is useful for organizations that use Nestr to organize collaboration and project management by defining roles with specific labels or hierarchical relationships.
Practical examples include:
- Creating a new role in a workspace to assign responsibilities.
- Adding labels to roles for categorization.
- Defining parent-child relationships between roles to reflect organizational structure.
Properties
| Name | Meaning |
|---|---|
| Workspace Name or ID | Select the workspace where the role will be created. Choose from a list or specify an ID via expression. |
| Additional Fields | Optional extra fields for the role: |
| - Labels | Comma-separated list of labels to categorize the role. |
| - Parent ID | The ID of a parent role, establishing a hierarchy or inheritance relationship. |
Output
The node outputs JSON data representing the newly created role object as returned by the Nestr API. This typically includes details such as the role's unique ID, associated workspace, labels, parent role (if any), and other metadata.
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
nestrOAuth2Apicredential configured in n8n. - The workspace list is dynamically loaded via the API to populate the workspace selection dropdown.
Troubleshooting
Common Issues:
- Invalid or missing workspace ID: Ensure the workspace exists and the ID is correct.
- Insufficient permissions: The API key or OAuth token must have rights to create roles in the target workspace.
- Incorrect label formatting: Labels should be comma-separated strings without extra spaces.
Error Messages:
- API errors related to authorization or invalid parameters will be returned from the Nestr API. Check credentials and input values.
- Network or connectivity issues may cause request failures; verify network access to the Nestr API endpoint.
Links and References
- Nestr Help Documentation
- n8n Expressions Documentation (for specifying dynamic workspace IDs)