WTS Chat icon

WTS Chat

Get data from Wts API

Actions17

Overview

This node interacts with the "Panel" resource of the Helena API, specifically supporting the operation to Get All Annotations (notes) associated with a card in a panel. It retrieves paginated lists of annotations for a specified card, allowing users to fetch notes efficiently.

Common scenarios where this node is beneficial include:

  • Extracting all comments or notes linked to a specific card in a project management or CRM system.
  • Auditing or reviewing annotations made on a card for quality control or collaboration purposes.
  • Integrating annotation data into workflows for reporting or further processing.

For example, you might use this node to pull all annotations from a customer support ticket card to analyze feedback or track issue resolution progress.

Properties

Name Meaning
Card ID The unique identifier of the card from which to retrieve annotations (notes).
Page Number The page number of results to retrieve (pagination). Defaults to 1.
Page Size The number of annotation items per page. Accepts values between 1 and 100. Defaults to 10.
Order By Field name by which to sort the annotations.
Order Direction Direction of sorting: either Ascending or Descending. Defaults to Ascending.

Output

The output is an array of JSON objects, each representing an annotation (note) retrieved from the specified card. Each item contains the annotation's details as returned by the Helena API, such as text content, creation date, author, and any other metadata included in the note object.

The node does not output binary data for this operation; it only returns structured JSON data representing annotations.

Dependencies

  • Requires an API key credential for authentication with the Helena API.
  • Connects to the Helena test API endpoint at https://api-test.helena.run.
  • Uses HTTP GET requests to the endpoint /crm/v1/panel/card/{cardId}/note with query parameters for pagination and sorting.

Troubleshooting

  • Empty or no results: Ensure the provided Card ID is correct and that the card actually has annotations.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • Invalid pagination parameters: Page number and size must be within allowed ranges (pageSize between 1 and 100).
  • Network or API errors: Check network connectivity and Helena API service status.
  • Error responses without details: The node silently catches errors; consider enabling detailed error logging or inspecting raw API responses for troubleshooting.

Links and References

Discussion