Nextcloud DeckInstall

Overview

This node integrates with Nextcloud Deck, a project management tool that organizes tasks into boards, stacks, and cards. Specifically, the "Anhang Löschen" (Delete Attachment) operation under the "Anhang" (Attachment) resource allows users to delete an attachment from a card within a board stack.

Typical use cases include automating cleanup of outdated or irrelevant attachments on task cards, managing storage by removing unnecessary files, or integrating with workflows that require dynamic attachment management based on external triggers.

For example, when a task is marked as completed in another system, this node can be used to automatically remove related attachments from the corresponding Nextcloud Deck card.

Properties

Details:

• Board: Identifies the board containing the stack and card.
• Stack: Identifies the stack inside the board where the card resides.
• Karte (Card): Specifies the card from which the attachment will be deleted.
• Anhang ID (Attachment ID): The unique identifier of the attachment to be removed.

Each of the first three properties supports two modes for specifying the resource: selecting from a list (with search capability) or entering the ID manually (validated as a number).

Output

The node outputs JSON data representing the result of the deletion operation. Typically, this will confirm successful deletion or provide error details if the operation failed.

Since this operation deletes an attachment, no binary data output is expected.

Example output JSON might look like:

{
  "success": true,
  "message": "Attachment deleted successfully"
}

or in case of failure:

{
  "error": "Attachment not found or already deleted"
}

Dependencies

• Requires an API key credential for authenticating with the Nextcloud Deck API.
• The node depends on Nextcloud Deck's REST API endpoints for boards, stacks, cards, and attachments.
• Proper permissions on the Nextcloud instance are necessary to delete attachments.
• Network access to the Nextcloud server hosting the Deck app is required.

Troubleshooting

• Common Issues:

  • Invalid or missing IDs for board, stack, card, or attachment will cause errors.
  • Insufficient permissions may prevent deletion.
  • Network connectivity issues to the Nextcloud server.
  • Attachment already deleted or does not exist.

• Error Messages:

  • "Unbekannte Ressource: ..." — indicates an unsupported resource was specified; ensure "attachment" is selected.
  • Validation errors for IDs (e.g., non-numeric input) will prompt to enter valid numeric IDs.
  • API errors returned from Nextcloud Deck will be passed through; check the message for details.

• Resolution Tips:

  • Verify all IDs are correct and correspond to existing resources.
  • Confirm API credentials have sufficient rights.
  • Test connectivity to the Nextcloud server.
  • Use the list mode to select resources to avoid manual entry errors.

Links and References

• Nextcloud Deck Official Documentation
• Nextcloud Deck API Reference
• n8n Documentation on Resource Locators