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, projects, and time entries for resource scheduling and project management. Specifically, the Booking - Get operation retrieves detailed information about a single booking by its unique ID.

Typical use cases include:

  • Fetching details of a specific booking to review or process it further in an automation workflow.
  • Integrating Teamdeck booking data into other systems or reports.
  • Validating booking information before performing updates or deletions.

For example, you might use this node to get the start and end dates, associated project and resource IDs, description, and time allocation fraction of a particular booking.

Properties

Name Meaning
Add Additional JSON Whether to pass through extra JSON data from input to output unchanged.
Additional JSON The actual JSON data to pass through if "Add Additional JSON" is enabled.
Booking ID The unique identifier of the booking to retrieve (required).

Output

The node outputs a JSON object representing the booking details retrieved from Teamdeck. This includes fields such as:

  • id: Booking unique identifier.
  • project_id: ID of the project associated with the booking.
  • resource_id: ID of the resource/person booked.
  • start_date: Start date of the booking (YYYY-MM-DD).
  • end_date: End date of the booking (YYYY-MM-DD).
  • description: Optional description of the booking.
  • time_fraction: Fractional time allocation (e.g., 0.5 for 50%, 1 for 100%).
  • additionalJson: If enabled, any additional JSON passed through from input.

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Teamdeck API.
  • The node makes HTTP requests to https://api.teamdeck.io/v1/bookings/{bookingId}.
  • Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

  • Common issues:

    • Missing or invalid Booking ID will cause errors.
    • Invalid or missing API key credential will result in authentication failures.
    • Network connectivity issues can prevent API calls.

  • Error messages:

    • "The resource you are requesting could not be found": Usually means the booking ID does not exist or is incorrect.
    • "Please specify at least one field to update": Not applicable here but common in update operations.
    • Authentication errors indicate problems with the API key setup.

  • Resolutions:

    • Verify the Booking ID is correct and exists in Teamdeck.
    • Ensure the API key credential is valid and has required permissions.
    • Check network access and proxy settings if applicable.

Links and References

Discussion