LearningSuite icon

LearningSuite

Interact with LearningSuite API (powered by agentur-systeme.de)

Overview

This node integrates with the LearningSuite API to manage webhook subscriptions. Specifically, the "Delete Webhook Subscription" operation allows users to remove an existing webhook subscription by specifying its name or ID. This is useful for cleaning up unused or obsolete webhook subscriptions to prevent unnecessary callbacks or notifications.

Common scenarios include:

  • Automating the removal of webhook subscriptions when they are no longer needed.
  • Managing webhook lifecycle programmatically within workflows.
  • Ensuring that only active and relevant webhooks remain subscribed to events.

Example: A user wants to delete a webhook subscription that was created for monitoring course updates once the course is archived or deleted.

Properties

Name Meaning
Subscription Name or ID The identifier of the webhook subscription to delete. Choose from a dynamically loaded list of existing subscriptions or specify an ID using an expression.

Output

The node outputs a JSON array containing the result of the deletion operation. Typically, this will be an object confirming the successful deletion or providing details about the deleted subscription. If the operation fails and "Continue On Fail" is enabled, the output will include an error message alongside the input data that caused the failure.

No binary data is produced by this operation.

Dependencies

  • Requires a valid API key credential for authenticating with the LearningSuite API.
  • The node depends on the LearningSuite API endpoint configured in the credentials (base URL).
  • The node uses internal handlers mapped to the "webhook" resource and "deleteSubscription" operation to perform the API call.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent subscription ID will cause the deletion to fail.
    • Network connectivity problems or incorrect API base URL configuration can prevent the node from reaching the LearningSuite API.
    • Insufficient permissions associated with the API key may result in authorization errors.
  • Error messages:

    • "No handler for resource "webhook" and operation "deleteSubscription": Indicates a misconfiguration or missing implementation; ensure the correct resource and operation names are used.
    • API errors returned from LearningSuite (e.g., 404 Not Found if subscription does not exist) will be surfaced as node errors.
  • Resolutions:

    • Verify the subscription ID exists by listing subscriptions before attempting deletion.
    • Check API credentials and base URL settings.
    • Enable "Continue On Fail" to handle errors gracefully within workflows.

Links and References

Discussion