iTwin Issues icon

iTwin Issues

iTwin Issues API for issue management, form definitions, attachments, and comments

Overview

The "iTwin Issues" node integrates with the iTwin Issues API to manage issues within iTwin projects. Specifically, the "Delete issue" operation allows users to delete an existing issue by specifying its ID. This node is useful in workflows where automated cleanup or management of project issues is required, such as removing resolved or invalid issues programmatically.

Practical examples include:

  • Automatically deleting issues that have been marked as duplicates.
  • Cleaning up test or temporary issues created during development.
  • Integrating issue deletion into broader project management automation pipelines.

Properties

Name Meaning
ID The unique identifier of the issue to delete. This is a required string input specifying which issue will be removed from the iTwin project.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this would confirm successful deletion or provide error details if the operation failed. The exact structure depends on the API response but generally includes status information about the deleted issue.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the iTwin platform via an API authentication token (OAuth2).
  • The node depends on the iTwin Issues API endpoint for issue management.
  • Proper credentials must be configured in n8n to authenticate API requests.
  • Network access to https://api.bentley.com is necessary.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent issue ID will cause the delete operation to fail.
    • Missing or expired API authentication tokens will prevent successful API calls.
    • Network connectivity problems can interrupt communication with the iTwin API.
  • Error messages and resolutions:

    • "Unsupported operation" — indicates the operation parameter is incorrect or not implemented; ensure "delete-issue" is selected.
    • API errors related to authorization — verify that the OAuth2 credentials are correctly set up and valid.
    • Issue not found or cannot be deleted — confirm the issue ID exists and that the authenticated user has permission to delete it.

Links and References

Discussion