WTS Chat icon

WTS Chat

Get data from Wts API

Actions39

Overview

The "Gel All Annotation" operation for the Panel resource in this n8n node retrieves all annotations (notes, comments, or files) associated with a specific card within a panel from the WTS Chat API. This is useful for workflows that need to extract, review, or process all annotation data linked to a particular card, such as for reporting, auditing, or further automation steps.

Practical scenarios:

  • Automatically collecting all notes and files attached to a sales opportunity card for compliance or handover.
  • Aggregating feedback or comments on a project task card for analysis.
  • Exporting all card-related documentation for backup or migration purposes.

Properties

Below are the input properties relevant to the "Gel All Annotation" operation for the Panel resource:

Display Name Type Meaning
Card ID string The unique identifier of the card whose annotations you want to retrieve.
CreatedAt.After dateTime Filter: Only include annotations created after this date/time.
CreatedAt.Before dateTime Filter: Only include annotations created before this date/time.
UpdatedAt.After dateTime Filter: Only include annotations updated after this date/time.
UpdatedAt.Before dateTime Filter: Only include annotations updated before this date/time.
Auto Pagination boolean If enabled, automatically fetches all pages of results.
Max Pages number (Used if Auto Pagination is enabled) Maximum number of pages to retrieve (1–100).
Page Number number (Used if Auto Pagination is disabled) The page number to retrieve.
Page Size number (Used if Auto Pagination is disabled) Number of items per page (1–100).
Order By string Field by which to sort the results.
Order Direction options Sort direction: Ascending or Descending.

Note:

  • The only required field is Card ID; others are optional filters and pagination controls.

Output

The output will be an array of objects, each representing an annotation associated with the specified card. Each object is returned in the json property of the output item.

Typical structure:

[
  {
    "json": {
      // Annotation fields, e.g.:
      "id": "string",
      "cardId": "string",
      "type": "text" | "file",
      "content": "string",        // For text annotations
      "fileUrl": "string",        // For file annotations
      "createdAt": "date-time",
      "updatedAt": "date-time",
      "author": { /* ... */ },
      // ...other annotation metadata
    }
  }
]

The exact fields depend on the WTS Chat API's annotation schema.

Dependencies

  • External Service: Requires access to the WTS Chat API.
  • API Key: You must configure valid credentials (wtsApi) in n8n with your API key.
  • n8n Configuration: No special environment variables beyond standard credential setup.

Troubleshooting

Common issues:

  • Missing Card ID: If the Card ID is not provided, the node will throw an error:
    "CardID is empty, please fill it in"

    • Resolution: Ensure the Card ID field is filled with a valid value.

  • Invalid Filters/Pagination: Supplying out-of-range values for pagination may result in no data or errors.

    • Resolution: Use values within the allowed range (Page Size: 1–100, Max Pages: 1–100).

  • API Authentication Errors: If the API key is missing or invalid, authentication errors will occur.

    • Resolution: Check and update your n8n credentials for the WTS Chat API.

  • Network/API Issues: If the WTS Chat API is unreachable or returns errors, the node will fail with an API error message.

    • Resolution: Verify network connectivity and API service status.

Links and References

Summary:
This operation is ideal for retrieving all types of annotations (text, files, etc.) attached to a specific card in a panel, supporting advanced filtering and pagination for large datasets.

Discussion