Actions37
- Groups Actions
- Members Actions
- Roles Actions
- Permissions Actions
- Jobs Actions
- Shares Actions
- Actions Actions
- Users Actions
Overview
This node enables the deletion of a specific role within an iTwin project. It is useful for managing access control by removing roles that are no longer needed or should no longer have permissions in the iTwin environment. For example, if a team member leaves a project or changes responsibilities, their associated role can be deleted to maintain proper security and access management.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the iTwin project where the role exists. |
| Role ID | The unique identifier of the iTwin role to be deleted. |
Output
The output JSON contains the result of the delete operation. Typically, this will confirm whether the role was successfully deleted or provide relevant status information. If the operation fails and "continue on fail" is enabled, the output will include an error message describing the failure.
No binary data output is expected from this operation.
Dependencies
- Requires an API key credential for authenticating with the iTwin platform.
- The node depends on the iTwin Users & Access Control API.
- Proper configuration of the OAuth2 authentication credentials in n8n is necessary to authorize requests.
Troubleshooting
Common issues:
- Invalid or missing iTwin ID or Role ID parameters will cause the operation to fail.
- Insufficient permissions or expired API tokens may result in authorization errors.
- Network connectivity problems can prevent successful API calls.
Error messages:
"Unknown operation: delete-iTwin-role"indicates the operation name might be incorrect or not supported.- API errors related to authorization typically suggest checking the API key or OAuth token validity.
- Errors mentioning missing parameters mean required inputs like iTwin ID or Role ID were not provided.
To resolve these issues:
- Verify all required input fields are correctly filled.
- Ensure the API credentials are valid and have sufficient permissions.
- Check network connectivity and retry the operation.
Links and References
- iTwin Developer Documentation
- Refer to the iTwin Users & Access Control API documentation for detailed information on role management endpoints.