Nestr icon

Nestr

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

Actions29

Overview

This node interacts with the "Circle" resource in the Nestr project management system, specifically performing the Get operation. It retrieves detailed information about a specific circle within a selected workspace. Circles in Nestr represent groups or teams that organize work collaboratively.

Typical use cases include:

  • Fetching details of a particular circle to display or process its attributes.
  • Integrating circle data into workflows for reporting or automation.
  • Using circle metadata to manage team structures programmatically.

For example, you might use this node to get the current state and properties of a circle before updating it or to synchronize circle information with another system.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the circle. You can choose from a list of available workspaces or specify an ID using an expression.
Additional Fields Optional extra parameters to filter or specify additional criteria:
  Labels Comma-separated list of labels to filter or tag the circle.
  Parent ID The ID of a parent item, if applicable, to scope or relate the circle hierarchically.

Output

The node outputs JSON data representing the requested circle's details as returned by the Nestr API. This typically includes properties such as the circle's ID, name, description, associated workspace, labels, parent relationships, and other metadata relevant to the circle entity.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to the Nestr API via OAuth2 authentication (an API key credential).
  • The node depends on the Nestr API endpoints to fetch workspace and circle data.
  • The workspace list is dynamically loaded using an internal method that queries available workspaces from the API.

Troubleshooting

  • Common issues:

    • Invalid or missing workspace ID: Ensure the workspace is correctly selected or specified.
    • Circle not found: Verify the circle exists within the chosen workspace.
    • Authentication errors: Confirm that the OAuth2 credentials are valid and have sufficient permissions.
    • Network or API downtime: Check connectivity and Nestr service status.

  • Error messages:

    • "error": "Not Found" — The specified circle or workspace does not exist. Double-check IDs.
    • "error": "Unauthorized" — Authentication failed. Re-authenticate or update credentials.
    • Timeout or network errors — Retry after verifying network stability.

Links and References

Discussion