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 workspaces and their related entities. Specifically, for the Workspace resource and the Get Users operation, it retrieves the list of users associated with a selected workspace. This is useful in scenarios where you want to automate workflows involving team members within a workspace, such as sending notifications, generating reports on user activity, or syncing user data with other systems.

Practical example:
You have a project management workflow where you need to notify all users in a specific workspace about an upcoming deadline. Using this node, you can fetch all workspace users dynamically and then send them personalized messages or emails.

Properties

Name Meaning
Workspace Name or ID Select the workspace to work with. You can choose from a dropdown 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 (not used in Get Users operation but available in additional fields).
  Parent ID Parent item ID (not used in Get Users operation but available in additional fields).

Note: For the Get Users operation, only the "Workspace Name or ID" property is required and relevant.

Output

The output is a JSON array where each item represents a user in the specified workspace. Each user object contains details as returned by the Nestr API's /api/workspaces/{workspaceId}/users endpoint. Typical fields may include user identifiers, names, roles, email addresses, and other metadata related to the user's membership in the workspace.

The node does not output binary data 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 to authenticate requests.
  • The workspace list for selection is dynamically loaded using the node’s internal method that calls the Nestr API to fetch available workspaces.

Troubleshooting

  • Common issues:

    • Invalid workspace ID or name: If the workspace identifier is incorrect or the workspace does not exist, the API will return an error.
    • Authentication errors: Missing or expired OAuth2 credentials will cause authentication failures.
    • API rate limits or network issues: Temporary connectivity problems or API throttling may cause request failures.

  • Error messages and resolutions:

    • "Workspace not found": Verify the workspace ID or select a valid workspace from the dropdown.
    • "Unauthorized" or "Authentication failed": Re-authenticate the OAuth2 credentials or check if the token has expired.
    • "Request failed" or timeout errors: Check network connectivity and retry after some time.

Links and References

Discussion