Teamdeck icon

Teamdeck

Interact with Teamdeck API for project management and time tracking
Join our community

Actions15

Overview

This node integrates with the Teamdeck API to manage projects, time entries, and bookings. Specifically for the Project - Delete operation, it allows users to delete an existing project by specifying its unique project ID.

Typical use cases include:

  • Automating cleanup of obsolete or completed projects in Teamdeck.
  • Integrating project lifecycle management into broader workflows where projects are programmatically removed based on external triggers or conditions.
  • Maintaining data hygiene by removing test or temporary projects after validation.

Example: Automatically deleting a project once all associated tasks and time entries are archived elsewhere.

Properties

Name Meaning
Add Additional JSON Whether to pass through extra JSON data from input to output alongside the main response.
Additional JSON The actual JSON object to pass through if "Add Additional JSON" is enabled.
Project ID The unique identifier of the project to delete.

Output

The node outputs a JSON object indicating the success of the deletion:

{
  "success": true,
  "additionalJson": { /* optional additional JSON passed through */ }
}
  • success: A boolean confirming that the project was successfully deleted.
  • additionalJson: If enabled, this contains any user-provided JSON data passed through from input to output.

No binary data is produced by this operation.

Dependencies

  • Requires an active connection to the Teamdeck API via an API key credential.
  • The node uses the Teamdeck REST API endpoint https://api.teamdeck.io/v1/projects/{project_id} with HTTP DELETE method.
  • Proper API authentication must be configured in n8n credentials for Teamdeck.

Troubleshooting

  • Common issues:

    • Invalid or missing Project ID: The node requires a valid project ID; ensure this is correctly provided.
    • API authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Network or connectivity problems: Ensure n8n can reach the Teamdeck API endpoint.

  • Error messages:

    • "Unknown operation: delete": This would indicate a misconfiguration of the operation parameter (unlikely here since it's fixed).
    • "Invalid API response received": Could mean the API returned unexpected data or no data; check API status and request parameters.
    • Errors related to missing fields or invalid IDs will typically come from the API and be surfaced by the node.

  • Resolution tips:

    • Double-check the Project ID value.
    • Confirm API key validity and permissions.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully in workflows.

Links and References

This summary focuses solely on the static analysis of the Project Delete operation within the Teamdeck node as requested.

Discussion