Workspace icon

Workspace

Get and change data from Workspace API

Overview

This node interacts with a Workspace API to manage Kanban cards among other resources. Specifically, the "Delete Kanban Card by ID" operation allows users to remove a Kanban card from their workspace by specifying its unique identifier. This is useful in scenarios where tasks or items represented as Kanban cards are no longer relevant or need to be cleaned up automatically.

Practical examples include:

  • Automating task cleanup after completion or cancellation.
  • Integrating with other systems to synchronize task deletions.
  • Managing project workflows by programmatically removing obsolete Kanban cards.

Properties

Name Meaning
Kanban Card ID Unique identifier of the Kanban card to delete. This must be provided to specify which card to remove.

Output

The output JSON typically contains the response from the Workspace API confirming the deletion of the Kanban card. This may include status information or details about the deleted card depending on the API's response structure.

If the node supports binary data output (not evident here), it would represent any file or media associated with the Kanban card, but this operation primarily deals with JSON responses.

Dependencies

  • Requires an active connection to the Workspace API.
  • Needs an API key credential and tenant identification configured in n8n credentials for authentication.
  • The base URL for the Workspace API must be set in the node credentials.
  • HTTP headers include Accept: application/json, Content-Type: application/json, and authentication headers.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Kanban Card ID will likely result in an error from the API indicating the card was not found.
    • Missing or incorrect API credentials will cause authentication failures.
    • Network connectivity problems can prevent the node from reaching the Workspace API.
  • Error messages:

    • "Unauthorized" or "Authentication failed": Check that the API key and tenant credentials are correctly configured.
    • "Kanban card not found": Verify the Kanban Card ID is correct and exists.
    • "Request timeout" or network errors: Ensure stable internet connection and correct API endpoint URL.

Links and References

  • Refer to the Workspace API documentation for detailed information on Kanban card management endpoints.
  • Consult n8n documentation on setting up API credentials and handling HTTP request nodes for further customization.

Discussion