Lectful Central icon

Lectful Central

Interact with the Lectful Central API for admin operations

Overview

The BuilderX AI Integration - Get AI Manifest Batch operation in this node allows users to retrieve AI manifests for specific BuilderX widgets by providing a list of widget IDs. This is useful when you want to fetch detailed AI-generated metadata or configuration information for multiple widgets at once, enabling automated or programmatic access to AI manifest data related to UI components.

Typical use cases include:

  • Fetching AI manifests for a set of widgets to dynamically generate or update UI pages.
  • Integrating AI-driven widget configurations into BuilderX projects.
  • Batch processing of widget manifests to optimize workflows involving multiple UI elements.

For example, if you have widgets like "hero-1", "pricing-1", and "footer-2", you can request their AI manifests in one API call, which helps streamline the process of managing AI templates or configurations in bulk.

Properties

Name Meaning
Authentication Mode Choose how to authenticate with the Lectful Central API:
- Use Stored Credentials
- Manual Configuration (provide base URL and API key manually)
Base URL Override Optional base URL to override the credential setting (used only in Manual Configuration mode). Should not include /api/v1.
API Key Override Optional API key to override the credential setting (used only in Manual Configuration mode).
Widget IDs Required. Comma-separated list of widget IDs to fetch manifests for (e.g., hero-1,pricing-1,footer-2).

Output

The output is an array of JSON objects, each representing the response from the API for the requested batch of widget manifests. The structure corresponds to the API's returned data for the AI manifests of the specified widgets.

  • Each item in the output contains a json field holding the parsed API response.
  • The response typically includes detailed AI manifest data for each widget ID requested.
  • No binary data output is produced by this operation.

Example output snippet (conceptual):

[
  {
    "json": {
      "manifests": [
        {
          "widget_id": "hero-1",
          "manifest_data": { /* AI manifest details */ }
        },
        {
          "widget_id": "pricing-1",
          "manifest_data": { /* AI manifest details */ }
        }
      ]
    }
  }
]

Dependencies

  • Requires access to the Lectful Central API.
  • Authentication via either stored credentials configured in n8n or manual entry of Base URL and API key.
  • Proper API permissions to access the /admin/builderx/ai-manifest/batch endpoint.
  • Network connectivity to the Lectful Central API server.

Troubleshooting

  • Missing or invalid credentials:
    If using stored credentials, ensure they are correctly configured with a valid base URL and API key. For manual mode, both Base URL Override and API Key Override must be provided. Errors will indicate missing or invalid credentials.

  • Invalid Widget IDs format:
    The Widget IDs property must be a comma-separated string without extra spaces or invalid characters. Invalid formatting may cause API errors or empty responses.

  • API errors or timeouts:
    Network issues or incorrect API endpoint URLs (especially if Base URL Override is misconfigured) can cause failures. Verify the base URL does not include /api/v1 as it is appended automatically.

  • JSON parsing errors:
    The node attempts to parse string responses as JSON. If the API returns malformed JSON, the node will keep the raw string but this might affect downstream processing.

  • Continue on Fail behavior:
    If enabled, the node will continue processing other items even if one fails, returning error messages in the output JSON.

Links and References


This summary focuses specifically on the BuilderX AI Integration resource and the Get AI Manifest Batch operation as requested.

Discussion