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 "Workspace" resource in Nestr, a role-based and self-organized collaboration platform. Specifically, the Get operation retrieves detailed information about a single workspace by its name or ID. This is useful when you want to fetch metadata or configuration details of a specific workspace within your Nestr environment.

Common scenarios include:

  • Fetching workspace details to display or use in subsequent workflow steps.
  • Validating workspace existence before performing further operations.
  • Integrating workspace data into reports or dashboards.

Example: You might use this node to get the details of a particular workspace before creating projects or assigning roles within it.

Properties

Name Meaning
Workspace Name or ID Select the workspace to work with. Choose from a dropdown list of available workspaces or specify an ID using an expression.
Additional Fields Optional extra parameters to refine the request (not used in the Get operation for Workspace).

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

Output

The output is a JSON object representing the workspace's details as returned by the Nestr API. This typically includes fields such as workspace ID, name, description, labels, parent relationships, and other metadata describing the workspace.

The node outputs this data as a JSON array with one item per execution input, where each item contains the workspace information under the json key.

No binary data is produced by this operation.

Dependencies

  • Requires an active connection to the Nestr API via OAuth2 authentication.
  • The node depends on the n8n credential setup for authenticating requests to Nestr.
  • The node uses internal helper functions to make HTTP requests to the Nestr API endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing workspace ID/name: Ensure the workspace identifier is correct and accessible by the authenticated user.
    • Authentication errors: Verify that the OAuth2 credentials are valid and have sufficient permissions.
    • Network or API downtime: Check connectivity and Nestr service status.

  • Error messages:

    • "Workspace not found": The specified workspace ID does not exist or is inaccessible.
    • "Unauthorized" or "Authentication failed": The API credentials are invalid or expired.

To resolve these, confirm the workspace ID, refresh or reconfigure credentials, and ensure network access to the Nestr API.

Links and References

Discussion