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 Nestr, a role-based and self-organized collaboration platform for managing projects, roles, circles, nests, and workspaces. Specifically, the Nest - Delete operation allows users to delete a nest entity within Nestr.

Use cases include:

  • Automating cleanup of obsolete or completed nests in your collaboration environment.
  • Integrating nest deletion into workflows that manage project lifecycles.
  • Removing nests programmatically based on external triggers or conditions.

Example: Automatically delete a nest when a related project is archived or closed.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the nest to delete. Choose from a list or specify an ID via expression.
Additional Fields Optional extra parameters:
  Labels Comma-separated list of labels (not typically used in delete but available as additional context).
  Parent ID Parent item ID (not typically used in delete but available as additional context).

Note: For the Nest resource's Delete operation, only the workspace selection and nest identifier are relevant. The provided properties JSON does not explicitly show a nest ID field, but the code uses a parameter named projectId for deletion under the "project" resource. For the Nest resource, the deletion likely requires a similar ID parameter (not shown in the snippet), but since you requested only Nest-Delete, the key property would be the nest ID to delete.

Output

The output is a JSON array representing the response from the Nestr API after deleting the specified nest. Typically, this will contain confirmation of deletion or details of the deleted nest.

No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential configured for Nestr to authenticate API requests.
  • Uses the Nestr REST API endpoints to perform operations.
  • The node depends on internal helper functions to make HTTP requests (nestrApiRequest).

Troubleshooting

  • Common issues:

    • Invalid or missing nest ID: The API will fail if the nest identifier is incorrect or not provided.
    • Insufficient permissions: The OAuth2 token must have rights to delete nests in the specified workspace.
    • Network or API errors: Connectivity issues or API downtime can cause failures.

  • Error messages:

    • Errors returned from the API will be passed through. Typical messages might indicate "Not Found" if the nest does not exist or "Unauthorized" if credentials lack permission.
    • To resolve, verify the nest ID, ensure correct workspace selection, and confirm API credentials have proper scopes.

Links and References

Discussion