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 bookings, which represent scheduled allocations of resources (people) to projects over specific date ranges. The Update Booking operation allows users to modify existing booking records by changing details such as project association, resource assigned, start and end dates, description, and time allocation fraction.

Typical use cases include:

  • Adjusting a resource's booking dates or project assignment after initial scheduling.
  • Updating the percentage of time a resource is allocated to a project.
  • Adding or modifying descriptive notes on a booking for clarity.

For example, if a team member’s availability changes, you can update their booking start/end dates or reduce their time fraction from 100% to 50%.

Properties

Name Meaning
Booking ID The unique identifier of the booking to update.
Update Fields A collection of fields to update in the booking:
- Project ID ID of the project associated with the booking.
- Resource ID ID of the resource (person) assigned to the booking.
- Start Date New start date of the booking (format: YYYY-MM-DD).
- End Date New end date of the booking (format: YYYY-MM-DD).
- Description Text description or notes about the booking.
- Time Fraction Fractional time allocation for the booking (e.g., 0.5 = 50%, 1 = 100%).
Add Additional JSON Boolean flag indicating whether to pass through extra JSON data from input to output.
Additional JSON Optional JSON object to pass through unchanged from input to output when enabled.

Output

The node outputs JSON objects representing the updated booking record returned by the Teamdeck API. The structure includes all standard booking fields such as:

  • id: Booking identifier
  • project_id: Associated project ID
  • resource_id: Assigned resource ID
  • start_date: Booking start date (YYYY-MM-DD)
  • end_date: Booking end date (YYYY-MM-DD)
  • description: Booking description text
  • time_fraction: Time allocation fraction (0 to 1)

If "Add Additional JSON" is enabled, the output JSON will also contain an additionalJson field containing the passed-through custom JSON data.

No binary data is produced by this node.

Dependencies

  • Requires an API key credential for authenticating requests to the Teamdeck API.
  • The node uses the Teamdeck REST API endpoint at https://api.teamdeck.io/v1/bookings.
  • Proper configuration of the API key credential in n8n is necessary for successful operation.

Troubleshooting

  • Error: "Please specify at least one field to update"
    This occurs if no update fields are provided. Ensure you select at least one field to modify in the "Update Fields" property.

  • Error: "Start date is required" or "End date is required"
    When creating or updating bookings, these dates must be valid and provided in the correct format (YYYY-MM-DD).

  • Invalid API response received
    Indicates unexpected or empty response from the API. Verify that the Booking ID is correct and the API key has sufficient permissions.

  • HTTP errors (e.g., 401 Unauthorized, 404 Not Found)
    Check that the API key credential is valid and that the booking ID exists.

  • If using "Add Additional JSON," ensure the JSON is well-formed to avoid parsing issues.

Links and References

Discussion