Nextcloud Deck icon

Nextcloud Deck

Consume NextCloud Deck API (v.0.1.3)

Overview

This node interacts with the Nextcloud Deck API to manage cards within boards and stacks. Specifically, the 'Assign label' operation assigns a label to a specified card in a stack on a board. This is useful for organizing and categorizing cards visually by labels, enhancing task management and workflow organization. For example, a user can assign priority or status labels to cards representing tasks.

Use Case Examples

  1. Assign a 'High Priority' label to a task card in a project board to highlight its urgency.
  2. Categorize cards by assigning labels such as 'Bug', 'Feature', or 'Improvement' for better tracking.

Properties

Name Meaning
Authentication Method of authentication to use for API requests, either Access Token or OAuth2.
Board ID The unique identifier of the board containing the card.
Stack ID The unique identifier of the stack within the board where the card resides.
Card ID The unique identifier of the card to which the label will be assigned.
Label ID The unique identifier of the label to assign to the card.

Output

JSON

  • success - Indicates if the label assignment operation was successful.
  • name - Name of the card or label involved in the operation.
  • id - Identifier of the card or label involved in the operation.

Dependencies

  • Requires Nextcloud Deck API credentials, either an access token or OAuth2 authentication.

Troubleshooting

  • Common issues include invalid or expired authentication tokens, resulting in authorization errors.
  • Incorrect or missing Board ID, Stack ID, Card ID, or Label ID can cause the API request to fail with resource not found errors.
  • API errors are returned as NodeApiError with the error message from the Nextcloud Deck API.

Links

  • Nextcloud Deck - Official site for Nextcloud Deck, the project management tool this node interacts with.
  • Nextcloud API Documentation - Documentation for Nextcloud APIs, useful for understanding API endpoints and parameters.

Discussion