WTS Chat icon

WTS Chat

Get data from Wts API

Actions39

Overview

This node interacts with the "Panel" resource of the WTS API, specifically supporting the operation Get Card By ID. It retrieves detailed information about a specific card within a panel by its unique identifier. This is useful in scenarios where you need to fetch and process data related to a particular card, such as viewing its details, metadata, custom fields, or associated entities.

Practical examples include:

  • Fetching a project task card by its ID to display or update its status.
  • Retrieving detailed information about a sales pipeline card for reporting.
  • Accessing a card's metadata and custom fields to integrate with other systems.

Properties

Name Meaning
Card ID The unique identifier of the card to retrieve.
Include Details Optional list of additional related details to include in the response. Possible values: Contacts, CustomFields, PanelTitle, ResponsibleUser, StepPhase, StepTitle

Output

The output is a JSON object representing the card data retrieved from the WTS API. It includes the card's core properties such as title, description, position, monetary amount, responsible user, tags, contact IDs, and any custom fields or metadata associated with the card.

If "Include Details" options are specified, the output will also contain nested objects or arrays with additional related information like contacts linked to the card, custom fields definitions, panel title, responsible user details, step phase, and step title.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the WTS API.
  • The node depends on the WtsCrmService.getCardById method from the bundled service code to perform the API call.
  • Proper configuration of the WTS API credentials in n8n is necessary.

Troubleshooting

  • Error: "CardID is empty, please fill it in"
    Occurs if the Card ID property is not provided or left blank. Ensure that the Card ID field is filled with a valid identifier.

  • API errors wrapped as NodeApiError
    These indicate issues returned from the WTS API, such as invalid Card ID, permission issues, or network problems. Check the error message for specifics and verify the Card ID and API key validity.

  • Empty or unexpected output
    Verify that the Card ID exists and that the API key has sufficient permissions to access the card data. Also, check if the "Include Details" options are correctly set if expecting additional related data.

Links and References

Discussion