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 roles within a workspace. Specifically, the Role - Get operation retrieves detailed information about a single role in a specified workspace. This is useful for workflows that need to fetch role details for reporting, validation, or further processing.

Practical examples include:

  • Fetching role details to verify permissions before performing an action.
  • Retrieving role metadata to display in dashboards or notifications.
  • Integrating role data into other systems for synchronization or auditing.

Properties

Name Meaning
Workspace Name or ID Select the workspace to work with. Choose from the list of available workspaces or specify an ID using an expression.
Additional Fields Optional fields to filter or extend the request:
• Labels: Comma-separated list of labels (string)
• Parent ID: Parent item ID (string)

Note: For the Get operation on Role resource, only "Workspace Name or ID" and optionally "Additional Fields" are relevant.

Output

The output is a JSON object representing the requested role's details as returned by the Nestr API. It typically includes properties such as role ID, name, description, associated workspace, labels, parent relationships, and other metadata.

The node outputs this data as a JSON array with one element per input item. There is no binary data output for this operation.

Dependencies

  • Requires an active connection to the Nestr API via OAuth2 authentication.
  • The node depends on the nestrOAuth2Api credential configured in n8n.
  • The workspace must exist and be accessible with the provided credentials.
  • The node uses internal helper functions to make HTTP requests to Nestr endpoints.

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 read role information.
    • Network or API errors: Check connectivity and Nestr service status.

  • Error messages:

    • "404 Not Found": The specified role or workspace does not exist.
    • "401 Unauthorized" or "403 Forbidden": Authentication failed or insufficient permissions.
    • "Invalid workspace ID": The workspace parameter was not correctly set or resolved.

To resolve these, verify credentials, workspace IDs, and user permissions in Nestr.

Links and References

Discussion