Actions28
- Attachments Actions
- Comments Actions
- Import Actions
- Static Images Actions
- Forms Actions
- Delete form definition
- Update form definition metadata
- Get form definition by ID
- Add comment to form
- Get form data comments
- Download form as file
- Export forms to Storage
- Get form data details
- Update form data
- Delete form data
- Import form definition from another iTwin
- Get iTwin form definitions
- Add attachment to form
- Get form data attachments
- Create form data
- Get iTwin form data
- Get audit trail for form data
- List Groups Actions
- Templates Actions
- Workflows Actions
Overview
This node integrates with the iTwin Forms API, allowing users to manage form data and attachments programmatically within n8n workflows. Specifically, the "Delete attachment" operation under the "Attachments" resource enables users to delete a specific attachment from a given form data instance by specifying its IDs.
Common scenarios include:
- Automating cleanup of outdated or incorrect attachments in form submissions.
- Managing storage by removing unnecessary files linked to form data.
- Integrating with other systems where attachments need to be programmatically removed based on workflow logic.
Example: Automatically deleting an attachment when a related record is deleted in another system, ensuring data consistency.
Properties
| Name | Meaning |
|---|---|
| ID | The ID of the form data instance from which to delete an attachment. |
| Attachment ID | The ID of the attachment to delete. |
Output
The node outputs JSON objects representing the result of the delete operation. The exact structure depends on the API response but generally includes confirmation of deletion or relevant status information.
If multiple items are processed, each output item corresponds to one input item’s operation result.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication credential for the iTwin Forms API (an OAuth2-based API key or token).
- The node uses an internal OpenAPI interpreter to execute operations against the iTwin Forms API.
- Proper configuration of the iTwin OAuth2 credentials in n8n is necessary for successful API calls.
Troubleshooting
- Unknown operation error: If the operation parameter is incorrect or unsupported, the node throws an error indicating an unknown operation. Ensure the operation name is exactly "delete-attachment".
- Missing required parameters: Both "ID" and "Attachment ID" must be provided; missing these will cause errors.
- API authentication failures: Invalid or expired API tokens will cause authentication errors. Refresh or reconfigure credentials as needed.
- Continue on Fail: If enabled, the node will continue processing subsequent items even if some fail, returning error details in the output JSON.
Links and References
- iTwin Developer Documentation
- Refer to the iTwin Forms API documentation for detailed information about form data and attachment management endpoints.