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 - Update operation, it allows users to update existing project details such as the project's name, description, and color.

Typical use cases include:

  • Modifying project metadata after creation to reflect changes in project scope or branding.
  • Updating project descriptions to provide more context or updated information.
  • Changing the color associated with a project for better visual organization in dashboards or reports.

For example, you might use this node to rename a project from "Q2 Marketing Campaign" to "Q2 Digital Marketing Campaign" or update its color code to match new company branding guidelines.

Properties

Name Meaning
Add Additional JSON (useAdditionalJson) Boolean flag to decide whether to pass through extra JSON data from input to output.
Additional JSON (additionalJson) JSON object containing additional data to pass through if enabled.
Project ID (project_id) The unique identifier of the project to update (required).
Update Fields (updateFields) Collection of fields to update on the project:
- Name (name) New name of the project.
- Description (description) New description text for the project.
- Color (color) New color for the project, specified as a hex code (e.g., #FF0000).

Output

The node outputs JSON objects representing the updated project data returned by the Teamdeck API. Each output item contains:

  • All standard project properties as returned by the API after the update.
  • An optional additionalJson field that includes any extra JSON data passed through from the input if the "Add Additional JSON" option is enabled.

No binary data is produced by this node.

Example output JSON snippet:

{
  "id": "12345",
  "name": "Updated Project Name",
  "description": "Updated description",
  "color": "#00FF00",
  "additionalJson": {
    "customField": "value"
  }
}

Dependencies

  • Requires an API key credential for authenticating with the Teamdeck API.
  • The node makes HTTP requests to https://api.teamdeck.io/v1/projects/{project_id} using the PUT method to update project details.
  • No other external dependencies are required.

Troubleshooting

  • Error: "Please specify at least one field to update"
    This error occurs if no update fields are provided. Ensure you select at least one field (Name, Description, or Color) to update.

  • Invalid API response received
    Indicates the API did not return expected data. Check your API key validity and network connectivity.

  • Unknown resource or operation errors
    These happen if the resource or operation parameters are incorrect. Confirm you have selected "Project" as the resource and "Update" as the operation.

  • API authentication errors
    If the API key is missing or invalid, requests will fail. Verify the API key credential configuration in n8n.

  • Date formatting issues
    Not applicable for project updates but relevant for other resources like time entries or bookings.

Links and References

Discussion