LearningSuite icon

LearningSuite

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

Overview

The "Create Hub" operation in the LearningSuite node allows users to create a new hub within the LearningSuite platform. A hub can be thought of as a container or grouping entity that organizes content, courses, or other resources. This operation is useful for automating the setup of hubs programmatically, such as when onboarding new clients, setting up training environments, or managing multiple learning communities.

Practical examples include:

  • Automatically creating a new hub for each client or department in an organization.
  • Setting up hubs with predefined templates and custom variables to standardize content delivery.
  • Publishing hubs immediately upon creation to make them available without manual intervention.

Properties

Name Meaning
Hub Name The name of the hub to be created.
Template Name or ID The ID of the hub template to use. Choose from a list of available templates or specify an ID via expression.
Hub Description (Optional) A textual description of the hub.
Publish Hub Whether to publish the hub immediately after creation. Options: true (publish) or false (do not publish). Default is true.
Sort Index Numeric value to determine the sort order of the hub among others.
Template Variables Optional JSON object containing variables to customize the selected template during hub creation.

Output

The node outputs an array of JSON objects representing the created hub(s). Each object contains details about the newly created hub, such as its ID, name, status, and any other metadata returned by the LearningSuite API.

If the operation fails for any input item and "Continue On Fail" is enabled, the output will include an error object with the error message and the original input data for that item.

This node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the LearningSuite API.
  • The base URL for the API must be configured in the node credentials.
  • The node depends on the LearningSuite API being accessible and the user having permissions to create hubs.
  • The "Template Name or ID" property relies on a dynamic options loader method (hub_getTemplates) to fetch available templates.

Troubleshooting

  • No handler for resource "hub" and operation "create": This error indicates a misconfiguration or missing implementation for the specified resource-operation pair. Ensure the node version supports this operation.
  • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Invalid template ID: If the provided template ID does not exist or is invalid, the API will reject the request. Use the dropdown to select a valid template or verify the expression used.
  • JSON parsing errors in Template Variables: Ensure that the JSON entered in the "Template Variables" field is well-formed.
  • Publish failures: If publishing the hub immediately fails, try setting "Publish Hub" to false and publishing manually later.

Links and References

Discussion