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 - Get Many operation, it retrieves multiple project records from Teamdeck, optionally filtered by parameters and with control over pagination.

Common scenarios where this node is beneficial include:

  • Fetching a list of all projects or a subset based on filters for reporting or dashboard purposes.
  • Synchronizing project data from Teamdeck into other systems.
  • Automating workflows that require bulk access to project information.

Practical example:

  • A user wants to retrieve all active projects to generate a weekly status report.
  • Another use case is fetching a limited number of projects to display in a custom app interface.

Properties

Name Meaning
Add Additional JSON Boolean flag to decide whether to pass through extra JSON data from input to output.
Additional JSON Custom JSON object to be passed through unchanged from input to output if enabled.
Return All Whether to return all available projects or limit the number of results returned.
Limit Maximum number of projects to return when "Return All" is false.

Output

The output is an array of JSON objects representing projects retrieved from Teamdeck. Each item contains the project data fields as provided by the Teamdeck API, augmented with an optional additionalJson field if additional JSON was passed through.

Example structure of each output item:

{
  "id": "string",
  "name": "string",
  "description": "string",
  "color": "string (hex code)",
  ...other project fields,
  "additionalJson": { /* any additional JSON passed through */ }
}

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/projects.
  • No other external dependencies are required.
  • Ensure the API key credential is configured properly in n8n before using this node.

Troubleshooting

  • Error: "Invalid API response received"
    This indicates the API did not return expected data. Check network connectivity and API key validity.

  • Error: "Unknown operation: getAll"
    This would occur if the operation parameter is incorrect or unsupported. Verify the operation name is exactly "getAll".

  • API Rate Limits or Authentication Errors
    If you receive errors related to authentication or rate limits, verify your API key is valid and has sufficient permissions.

  • Empty Results
    If no projects are returned, check if filters or limits are too restrictive.

  • Passing Additional JSON
    If enabling "Add Additional JSON", ensure the JSON is valid; otherwise, parsing errors may occur.

Links and References

Discussion