Actions26
- Repositories Actions
- Resource Actions
- Resources Actions
- Favorites Actions
- Exports Actions
- Image Actions
- Account Actions
- Graphics Actions
- Recents Actions
Overview
This node interacts with the iTwin Projects API to retrieve information about iTwin projects. Specifically, the "Get iTwin" operation fetches details of a single iTwin project by its unique ID. This node is useful in automation workflows where you need to integrate or synchronize project data from the iTwin platform, such as fetching project metadata for reporting, validation, or further processing.
Practical examples include:
- Automatically retrieving project details when a new project ID is received from another system.
- Enriching datasets with iTwin project information before passing it downstream.
- Triggering conditional logic based on specific project attributes fetched via this node.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the iTwin project to retrieve. This is a required string input specifying which iTwin project's details to fetch. |
Output
The node outputs JSON data representing the iTwin project details corresponding to the provided ID. The structure of the output JSON depends on the iTwin Projects API response but generally includes project metadata such as name, description, status, and other relevant attributes.
If multiple items are returned (though for "Get iTwin" typically one item), each will be output as a separate JSON object in the array.
No binary data output is indicated.
Dependencies
- Requires an API authentication token credential configured in n8n to access the iTwin Projects API.
- Depends on the external iTwin Projects API service being available and accessible.
- Uses an internal interpreter module (
ProjectsOpenApiInterpreter) to map operations and execute API calls.
Troubleshooting
Common issues:
- Providing an invalid or non-existent iTwin ID will likely result in an error or empty response.
- Missing or incorrect API credentials will cause authentication failures.
- Network connectivity issues can prevent successful API calls.
Error messages:
"Unknown operation: get-itwin"indicates the operation parameter was not recognized; ensure the operation name matches exactly.- Errors related to API authentication failure suggest checking the configured API key or OAuth2 token.
- If the node throws errors about missing parameters, verify that the required "ID" property is set.
To resolve these, confirm the correctness of the input ID, validate API credentials, and ensure network access to the iTwin API endpoint.
Links and References
- iTwin Developer Documentation
- Refer to the official iTwin Projects API docs for detailed response schema and additional operations.