Nextcloud DeckInstall

Overview

This node integrates with Nextcloud Deck, a project management tool that organizes tasks into boards, stacks, cards, comments, and attachments. Specifically, the "Stack Löschen" (Delete Stack) operation under the "Stack" resource allows users to delete a stack from a selected board.

Typical use cases include:

• Automating cleanup of completed or obsolete stacks within a board.
• Managing project workflows by programmatically removing stacks no longer needed.
• Integrating with other systems to maintain synchronized task structures.

For example, after a project phase ends, you might use this node to delete all stacks related to that phase automatically.

Properties

Details:

• Board:

  • Mode "List": Search and select from available boards.
  • Mode "ID": Enter a numeric board ID manually (validated to be digits only).

• Stack:

  • Mode "List": Search and select from stacks within the chosen board.
  • Mode "ID": Enter a numeric stack ID manually (validated to be digits only).

Both properties are required for the delete operation.

Output

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

No binary data output is involved in this operation.

Example output JSON might look like:

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

or in case of failure:

{
  "error": "Stack 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 managing boards and stacks.
• Proper network access to the Nextcloud instance hosting Deck is necessary.
• No additional external services are required.

Troubleshooting

• Common Issues:

  • Invalid board or stack IDs: Ensure IDs are numeric and correspond to existing resources.
  • Authentication failures: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Network errors: Confirm connectivity to the Nextcloud server.

• Error Messages:

  • "Unbekannte Ressource: stack": Indicates an internal misconfiguration; ensure the resource parameter is set to "stack".
  • Validation errors on IDs: Prompted if non-numeric values are entered for board or stack IDs.
  • API errors returned from Nextcloud Deck (e.g., stack not found): Check that the stack exists and belongs to the specified board.

• Resolution Tips:

  • Use the list mode to select boards and stacks to avoid manual entry errors.
  • Enable "Continue On Fail" in the node settings to handle errors gracefully during batch operations.

Links and References

• Nextcloud Deck Official Documentation
• Nextcloud Deck API Reference
• n8n Documentation on Creating Custom Nodes