Overview
This node integrates with the iTwin Projects API to manage project entities within the iTwin platform. Specifically, the Update Project operation allows users to modify existing project details by specifying the project ID and the fields to update.
Common scenarios for this node include:
- Updating project metadata such as display name, status, or geographic location after initial creation.
- Changing project configuration details like time zone or data center location to reflect organizational changes.
- Adjusting project identifiers or types to maintain consistency across systems.
Practical example: A user wants to mark a project as "Inactive" after completion and update its display name to reflect a new naming convention. This node can perform that update seamlessly via the API.
Properties
| Name | Meaning |
|---|---|
| Project ID | The unique identifier of the project to update (required). |
| Update Fields | Collection of fields to update on the project. Options include: |
| - Data Center Location | The data center location associated with the project. |
| - Display Name | The human-readable name for the project. |
| - Geographical Location | The geographic location of the project. |
| - Project Number | A unique identifier number for the project. |
| - Status | The current status of the project. Possible values: Active, Inactive, Trial. |
| - Time Zone | The time zone setting for the project. |
| - Type | The type/category of the project. |
Output
The node outputs JSON objects representing the updated project(s) returned from the iTwin Projects API. Each output item contains a json field with the project's properties reflecting the latest state after the update.
No binary data is produced by this node.
Example output structure snippet:
{
"json": {
"id": "project-id",
"displayName": "Updated Project Name",
"number": "12345",
"status": "Active",
"geographicLocation": "USA",
"timeZone": "PST",
"dataCenterLocation": "us-west-1",
"type": "Infrastructure"
}
}
Dependencies
- Requires an API authentication token credential configured in n8n to access the iTwin Projects API.
- The node depends on the external iTwin Projects REST API endpoint.
- Proper network connectivity and permissions to call PATCH requests on the
/itwins/{projectId}endpoint are necessary.
Troubleshooting
Common issues:
- Invalid or missing Project ID will cause the API request to fail.
- Attempting to update fields with invalid values (e.g., unsupported status) may result in API errors.
- Network or authentication failures will prevent successful updates.
Error messages and resolutions:
"Project not found": Verify the Project ID is correct and exists."Unauthorized"or"Authentication failed": Check that the API key or OAuth token is valid and has required scopes."Invalid field value": Ensure all update fields conform to expected formats and allowed values.- If the node throws an error but you want to continue processing other items, enable "Continue On Fail" in the node settings.