Actions63
- Authentication Actions
- Tenant Management Actions
- Blog Management Actions
- Image Management Actions
- BuilderX AI Integration Actions
- Form Submissions Actions
- Subscription Management Actions
- Subscription Operations Actions
- Product Family Management Actions
- Feature Management Actions
- Invoice Management Actions
- Payment Management Actions
- Payment Method Management Actions
- Coupon Management Actions
- Health Checks Actions
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
jsonfield 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/batchendpoint. - 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:
TheWidget IDsproperty 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/v1as 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
- Lectful Central API Documentation (hypothetical link, replace with actual if available)
- BuilderX AI Integration concepts: Refer to BuilderX documentation for understanding AI manifests and widget configurations.
- n8n HTTP Request Helper: https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httpRequest/
This summary focuses specifically on the BuilderX AI Integration resource and the Get AI Manifest Batch operation as requested.