Nestr icon

Nestr

Manage projects, roles, circles, and workspaces in Nestr - Role-based and self-organized collaboration
Join our community

Actions29

Overview

This node allows you to manage roles within the Nestr collaboration platform, specifically enabling deletion of a role. It is useful in scenarios where you need to programmatically remove obsolete or incorrect roles from your workspace to maintain clean and accurate access control.

For example, if a project team member leaves and their associated role is no longer needed, this node can delete that role automatically as part of a workflow cleanup process.

Properties

Name Meaning
Workspace Name or ID Select the workspace to work with. You can choose from a list of available workspaces or specify an ID using an expression.
Additional Fields Optional extra parameters for the role deletion request:
- Labels Comma-separated list of labels (string)
- Parent ID Parent item ID (string)

Output

The output JSON contains the response from the Nestr API after attempting to delete the specified role. Typically, this will be an object indicating success or failure of the deletion operation. The exact structure depends on the API's response but generally includes confirmation of deletion or error details.

No binary data is output by this node.

Dependencies

  • Requires an OAuth2 API credential for authenticating with the Nestr API.
  • Needs network access to the Nestr API endpoints.
  • The node uses a method to load available workspaces dynamically for selection.

Troubleshooting

  • Common Issues:

    • Providing an invalid or non-existent workspace ID or role ID will cause the deletion to fail.
    • Insufficient permissions in the API credentials may result in authorization errors.
    • Network connectivity issues can prevent communication with the Nestr API.

  • Error Messages:

    • Errors returned from the API will be passed through. For example, "Role not found" indicates the specified role ID does not exist.
    • Authentication errors suggest problems with the provided API credentials.

  • Resolutions:

    • Verify the workspace and role IDs are correct and exist.
    • Ensure the API credentials have sufficient permissions to delete roles.
    • Check network connectivity and retry if transient errors occur.

Links and References

Discussion