Actions54
- Resource Actions
- Userpermissions Actions
- Baselinefile Actions
- Locks Actions
- Briefcases Actions
- Checkpoint Actions
- Thumbnail Actions
- Extendeddata Actions
- Changesets Actions
- Changesetgroups Actions
- Permissions Actions
- Recents Actions
- Namedversions Actions
- Shares Actions
- Rolepermissions Actions
- Users Actions
- Favorites Actions
- Fork Actions
- Clone Actions
- Create Actions
Overview
This node interacts with the iTwin Platform's iModels API, specifically to manage shares of iModels. The "Revoke iModel Share" operation allows users to revoke access previously granted to a shared iModel. This is useful in scenarios where you want to restrict or remove permissions from collaborators or external parties who had access to an iModel.
Practical examples include:
- Revoking a share link after a project phase is completed.
- Removing access for a user who no longer requires it.
- Managing and auditing iModel sharing permissions programmatically.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the iModel whose share is to be revoked. |
| Share ID | The unique identifier of the specific share to revoke. |
Output
The node outputs JSON data representing the result of the revoke operation. Typically, this will confirm whether the revocation was successful or provide details about the revoked share. The output structure is:
{
"result": <operation result object>
}
If the operation returns multiple results (unlikely for revoke), each will be output as separate JSON objects.
No binary data output is involved in this operation.
Dependencies
- Requires an API authentication token credential configured in n8n to authenticate with the iTwin Platform.
- Depends on the iTwin Platform's iModels API being accessible.
- The node uses an internal OpenAPI interpreter module to execute the API calls.
Troubleshooting
Common issues:
- Invalid or missing iModel ID or Share ID parameters will cause errors.
- Authentication failures if the API key or OAuth token is not properly configured.
- Network connectivity issues to the iTwin Platform API endpoint.
Error messages:
"Unknown operation: revoke-imodel-share": Indicates the operation name is incorrect or unsupported.- API errors returned from the platform will be surfaced; ensure IDs are correct and the authenticated user has permission to revoke shares.
Resolutions:
- Double-check that both the iModel ID and Share ID are correctly provided.
- Verify that the API credentials are valid and have sufficient permissions.
- Enable "Continue On Fail" in the node settings to handle errors gracefully during batch executions.