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 related entities. Specifically, the Workspace - Get Many operation allows users to retrieve multiple workspaces from their Nestr account. This is useful for scenarios where you want to list all available workspaces or filter them based on certain criteria.

Practical examples include:

  • Fetching all workspaces to display in a dashboard.
  • Retrieving a limited number of workspaces for reporting or synchronization purposes.
  • Filtering workspaces by labels or parent relationships to organize data hierarchically.

Properties

Name Meaning
Workspace Name or ID Select the workspace to work with. Choose from a dropdown list loaded dynamically or specify an ID using an expression.
Additional Fields Optional fields to filter or refine the query:
  Labels Comma-separated list of labels to filter workspaces.
  Parent ID Parent item ID to filter workspaces that belong under a specific parent.
Return All Boolean flag indicating whether to return all matching results or limit the number of results.
Limit Maximum number of results to return if "Return All" is false. Minimum value is 1, default is 50.

Output

The node outputs JSON data representing one or more workspace objects retrieved from the Nestr API. Each workspace object typically contains details such as workspace ID, name, labels, and other metadata as provided by the API.

If multiple workspaces are returned, the output is an array of these workspace objects.

The node does not output binary data.

Dependencies

  • Requires an API authentication credential configured in n8n to connect to the Nestr API.
  • The node uses OAuth2-based authentication (or similar) to authorize requests.
  • The node depends on the Nestr API endpoints for workspaces (/api/workspaces).

Troubleshooting

  • Common issues:

    • Authentication errors due to missing or invalid API credentials.
    • Network connectivity problems preventing access to the Nestr API.
    • Request limits exceeded if too many workspaces are requested without pagination.

  • Error messages:

    • Errors returned from the API will be surfaced, e.g., "Unauthorized" if credentials are invalid.
    • If the node fails to load workspace options, it may return an empty list; ensure the API key has proper permissions.

  • Resolutions:

    • Verify that the API key or OAuth2 credentials are correctly set up and have sufficient permissions.
    • Use the "Return All" option carefully to avoid large data loads; use "Limit" to restrict results.
    • Check network connectivity and API endpoint availability.

Links and References

Discussion