Nestr icon

Nestr

Manage projects, roles, circles, and workspaces in Nestr - Role-based and self-organized collaboration
Join our community

Actions29

Overview

The "Nestr" node integrates with the Nestr project management platform, enabling users to manage various resources such as projects, workspaces, roles, circles, posts, and nests. Specifically, for the Nest resource with the Get Many operation, this node retrieves multiple nest entities from the Nestr system.

This operation is useful when you want to fetch a list of nests within a workspace, for example, to display them in a dashboard, synchronize data with another system, or perform bulk processing on multiple nests.

Practical examples include:

  • Retrieving all nests in a specific workspace to analyze project structures.
  • Filtering nests by labels or parent IDs to organize hierarchical views.
  • Integrating nest data into reporting tools or automation workflows.

Properties

Name Meaning
Workspace Name or ID Select the workspace to work with. Choose from a dropdown list or specify an ID via expression.
Additional Fields Optional fields to filter or refine the query:
- Labels Comma-separated list of labels to filter nests by.
- Parent ID Filter nests by a specific parent item ID.
Return All Whether to return all results or limit the number of returned nests (only shown for some operations).
Limit Maximum number of nests to return if not returning all (minimum 1).

Note: For the Nest resource's Get Many operation, the properties relevant are primarily the workspace selection and optional additional fields for filtering.

Output

The node outputs an array of JSON objects representing nests retrieved from the Nestr API. Each object corresponds to a nest entity and contains its details as provided by the API.

The output structure includes typical nest attributes such as:

  • Nest ID
  • Title
  • Description
  • Associated workspace ID
  • Labels
  • Ancestors or parent relationships (if any)

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Nestr API using OAuth2 authentication.
  • The node depends on the nestrOAuth2Api credential configured in n8n to authenticate requests.
  • Network access to the Nestr API endpoints is necessary.
  • The node uses internal helper functions to paginate and retrieve all items if requested.

Troubleshooting

  • Common Issues:

    • Invalid or expired API credentials will cause authentication failures.
    • Specifying an incorrect workspace ID may result in empty responses or errors.
    • Network connectivity issues can prevent successful API calls.

  • Error Messages:

    • Authentication errors typically indicate problems with the OAuth2 token; re-authenticate or refresh credentials.
    • "Not Found" errors may occur if the workspace or nests do not exist or the user lacks permissions.
    • Rate limiting or API quota exceeded errors require waiting or adjusting usage patterns.

  • Resolutions:

    • Verify and update the API credentials in n8n.
    • Confirm workspace IDs and permissions in the Nestr platform.
    • Use the "Return All" option cautiously to avoid large data loads that might trigger rate limits.

Links and References

Discussion