WTS Chat icon

WTS Chat

Get data from Wts API

Overview

This node interacts with the "Panel" resource of the WTS API, specifically supporting operations related to annotation cards on panels. The Delete Annotation Card operation allows users to delete a specific annotation (note) from a card within a panel. This is useful for managing and cleaning up annotations or notes attached to cards in project management or CRM workflows.

Practical scenarios include:

  • Removing outdated or incorrect notes from a task card.
  • Automating cleanup of annotations when certain conditions are met.
  • Integrating annotation management into broader workflow automations involving panels and cards.

Properties

Name Meaning
Card ID The unique identifier of the card from which the annotation will be deleted.
Note ID The unique identifier of the annotation (note) that should be deleted from the card.

Output

The output of this operation is a JSON object representing the result of the deletion request. Typically, it contains confirmation data from the API indicating whether the annotation was successfully deleted. The exact structure depends on the API response but generally includes status or success indicators.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the WTS API via an API key credential.
  • The node uses the WtsCrmService.deleteAnnotationCard method internally to perform the deletion.
  • Proper permissions and valid identifiers (Card ID and Note ID) must be provided to successfully delete an annotation.

Troubleshooting

  • Missing Card ID or Note ID: The node throws an error if either the Card ID or Note ID is not provided. Ensure both fields are filled.
  • Invalid IDs: If the provided Card ID or Note ID does not exist or is invalid, the API may return an error. Verify the correctness of these IDs.
  • API Authentication Errors: If the API key credential is missing or invalid, requests will fail. Confirm that the API key is correctly configured.
  • Network Issues: Connectivity problems can cause request failures. Check network access to the WTS API endpoint.
  • Permission Denied: Insufficient permissions for deleting annotations may result in errors. Ensure the API key has appropriate rights.

Common error messages:

  • "Fill in NoteId and CardId": Indicates one or both required IDs are missing.
  • API error responses wrapped as NodeApiError with details from the WTS API.

Links and References

Discussion