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 the Nestr project management system, specifically supporting the operation to Get Labels of a workspace. It retrieves the labels associated with a specified workspace, which can be useful for categorizing or filtering projects and tasks within that workspace.

Common scenarios where this node is beneficial include:

  • Fetching all labels used in a workspace to dynamically populate dropdowns or filters in workflows.
  • Integrating workspace metadata into automation processes, such as tagging or organizing projects based on labels.
  • Synchronizing label data between Nestr and other tools.

For example, you might use this node to get all labels from a workspace before creating or updating projects, ensuring consistent labeling across your workflow.

Properties

Name Meaning
Workspace Name or ID Select the workspace to work with. Choose from the list of available workspaces or specify an ID via expression.
Additional Fields Optional fields to refine the request (not applicable for Get Labels operation).

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

Output

The output JSON contains the list of labels associated with the specified workspace. Each label is typically represented as a string or an object depending on the API response structure.

Example output structure (simplified):

[
  "label1",
  "label2",
  "label3"
]

If the node supports binary data output, it is not applicable here since this operation deals with textual label data only.

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.
  • The node uses internal helper functions to make HTTP requests to Nestr's REST API endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing workspace ID: Ensure the workspace ID or name is correctly selected or provided.
    • 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. Double-check the workspace selection.
    • "Unauthorized" or "Authentication failed": The OAuth2 token may have expired or is invalid. Re-authenticate the credential.
    • "Rate limit exceeded": Too many requests sent in a short time. Implement delays or reduce request frequency.

Links and References

Discussion