Actions37
- Groups Actions
- Members Actions
- Roles Actions
- Permissions Actions
- Jobs Actions
- Shares Actions
- Actions Actions
- Users Actions
Overview
This node operation, "Revoke iTwin Share," is designed to revoke or cancel an existing share on an iTwin platform. It is useful in scenarios where access to a shared iTwin resource needs to be withdrawn, such as when a project collaborator no longer requires access or when a share was created by mistake. For example, if a user has shared an iTwin model with a colleague but later decides to restrict that access, this operation can be used to revoke the share by specifying the relevant IDs.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the iTwin resource from which the share will be revoked. |
| Share ID | The unique identifier of the specific share instance that should be revoked. |
Output
The output of this operation is a JSON object indicating the result of the revoke action. Typically, it will contain confirmation details or status information about the revocation process. 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 authentication token credential for the iTwin platform.
- Depends on the iTwin Users & Access Control API.
- The node uses an internal interpreter module to execute the operation against the iTwin API.
- Proper configuration of the OAuth2 API credentials for iTwin is necessary within n8n.
Troubleshooting
Common Issues:
- Invalid or missing IDs: Ensure both the "ID" and "Share ID" are correctly provided and correspond to existing resources and shares.
- Authentication errors: Verify that the API key or OAuth2 credentials are valid and have sufficient permissions.
- Network or API downtime: Check connectivity and iTwin service status.
Error Messages:
"Unknown operation: revoke-itwin-share": This indicates the operation name might be misspelled or not supported; verify the operation parameter.- Errors related to invalid parameters will typically mention missing or incorrect IDs.
- If the node throws an error and "continue on fail" is enabled, the output JSON will contain an
errorfield with the message.
Links and References
- iTwin Developer Documentation
- Refer to the official iTwin Users & Access Control API documentation for detailed API behavior and requirements.