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 project-related data, specifically focusing on time entries in this context. The Update Time-Entry operation allows users to modify existing time entry records by specifying the entry's ID and the fields to update. This is useful for correcting or adjusting logged work times, descriptions, or associated projects/resources after initial creation.

Typical use cases include:

  • Adjusting the duration or dates of a time entry if errors were made during logging.
  • Updating the description to provide more accurate details about the work done.
  • Changing the linked project or resource if the time was initially assigned incorrectly.

For example, a user might update a time entry to extend the end date or increase the number of minutes worked after realizing additional work was performed.

Properties

Name Meaning
Time Entry ID The unique identifier of the time entry to update.
Update Fields A collection of fields to update on the time entry. Options include:
- Project ID: ID of the project associated with the time entry.
- Resource ID: ID of the resource (person) associated with the time entry.
- Minutes: Duration of the time entry in minutes.
- End_date: End date of the time entry (format: YYYY-MM-DD).
- Start_date: Start date of the time entry (format: YYYY-MM-DD).
- Description: Text description of the time entry.
Add Additional JSON Boolean flag indicating whether to pass through extra JSON data from input to output.
Additional JSON JSON object containing additional data to pass through from input to output if enabled.

Output

The node outputs JSON objects representing the updated time entry data returned from the Teamdeck API. The structure includes all standard time entry fields as well as any additional JSON data passed through if enabled.

Example output JSON structure:

{
  "id": "string",
  "project_id": "string",
  "resource_id": "string",
  "minutes": 120,
  "start_date": "YYYY-MM-DD",
  "end_date": "YYYY-MM-DD",
  "description": "string",
  "additionalJson": { /* optional additional JSON data */ }
}

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Teamdeck API.
  • The node makes HTTP requests to https://api.teamdeck.io/v1/time-entries.
  • Proper configuration of the API key credential in n8n is necessary for successful operation.

Troubleshooting

  • Error: "Please specify at least one field to update"
    Occurs if no update fields are provided. To fix, ensure at least one field in the "Update Fields" collection is set.

  • Error related to missing or invalid Time Entry ID
    Ensure the "Time Entry ID" property is correctly set to an existing time entry's ID.

  • API authentication errors
    Verify that the API key credential is valid and has appropriate permissions.

  • Invalid date format errors
    Dates must be in YYYY-MM-DD format. Incorrect formats may cause API rejections.

  • Unknown operation or resource errors
    These indicate misconfiguration of the node parameters; confirm that "Resource" is set to "Time-Entry" and "Operation" to "Update".

Links and References

Discussion