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 "Project - Create" operation allows users to create new projects inside a selected workspace, optionally associating them with circles and parent items, and adding labels for categorization.

Common scenarios include:

  • Automating project creation workflows when new initiatives start.
  • Organizing projects under specific circles or parent projects for hierarchical management.
  • Tagging projects with labels for filtering and reporting purposes.

For example, a team lead could use this node to automatically create a new project in a designated workspace whenever a new client onboarding process begins, assigning it to a relevant circle and labeling it for easy tracking.

Properties

Name Meaning
Workspace Name or ID Select the workspace where the project will be created. Can choose from a list or specify an ID via expression.
Title The title of the new project.
Description A textual description providing details about the project.
Circle ID (Optional) The ID of a circle to associate the project with, linking it to a specific group or team.
Additional Fields Optional extra fields:
  Labels Comma-separated list of labels to tag the project for categorization.
  Parent ID ID of a parent item to establish a hierarchical relationship with another project or entity.

Output

The node outputs JSON data representing the newly created project object as returned by the Nestr API. This includes all standard project properties such as its ID, title, description, associated workspace, labels, ancestors (circles or parent projects), and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Nestr API authenticated via OAuth2 credentials.
  • The node depends on the availability of the Nestr API endpoints for workspaces and projects.
  • The user must have appropriate permissions in the target workspace to create projects.

Troubleshooting

  • Common issues:

    • Invalid or missing workspace ID: Ensure the workspace exists and the ID is correct.
    • Insufficient permissions: Verify that the API credentials have rights to create projects in the specified workspace.
    • Incorrect circle or parent IDs: These must exist and be valid within the workspace context.
    • Labels format errors: Labels should be comma-separated strings without special characters that might cause API rejection.

  • Error messages:

    • API errors typically return messages indicating invalid parameters or authorization failures.
    • Network or authentication errors may occur if the OAuth2 token is expired or misconfigured.

  • Resolutions:

    • Double-check all IDs and input values.
    • Refresh or reconfigure API credentials.
    • Consult Nestr API documentation for required field formats and permissions.

Links and References

Discussion