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 projects within workspaces. Specifically, the Get Project operation retrieves detailed information about a single project by its ID within a specified workspace.

Typical use cases include:

  • Fetching project details for display or further processing in an automation workflow.
  • Integrating project data from Nestr into other tools or dashboards.
  • Validating project existence or status before performing updates or deletions.

For example, you might use this node to get a project's metadata (title, description, labels, parent relationships) to synchronize it with another project management system or to trigger notifications based on project attributes.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the project. Choose from a dropdown list or specify an ID via expression.
Project ID The unique identifier of the project to retrieve.
Additional Fields Optional extra parameters:
• Labels: Comma-separated list of labels associated with the project.
• Parent ID: Identifier of the parent item if applicable.

Output

The output is a JSON object representing the project details as returned by the Nestr API. This typically includes fields such as:

  • id: Project unique identifier.
  • title: The project title.
  • description: Description text of the project.
  • workspaceId: The workspace to which the project belongs.
  • labels: An array of labels/tags assigned to the project.
  • ancestors: Array of parent IDs if the project has hierarchical relationships.
  • Other metadata fields as provided by the API.

The node outputs this data as a JSON array with one element per input item processed.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Nestr API using OAuth2 authentication credentials configured in n8n.
  • The node uses the /api/nests/{projectId} endpoint to fetch project data.
  • The workspace must exist and be accessible with the provided credentials.

Troubleshooting

  • Invalid Project ID: If the project ID does not exist or is incorrect, the API will return an error. Verify the project ID is correct and belongs to the selected workspace.
  • Authentication Errors: Ensure that the OAuth2 credentials are valid and have sufficient permissions to access the workspace and project.
  • Workspace Access Issues: If the workspace ID is invalid or the user lacks access rights, the request will fail. Confirm workspace selection and permissions.
  • Network or API Downtime: Temporary connectivity issues or Nestr API outages can cause failures. Retry after some time or check Nestr status.

Common error messages usually contain HTTP status codes and descriptive messages from the API, e.g., "404 Not Found" for missing projects or "401 Unauthorized" for auth problems.

Links and References

Discussion