Overview
This node integrates with the Fractal Forge API to retrieve and manipulate data related to various entities defined in the Fractal Forge system. It supports two main resource types: Query and Command, each with specific operations such as listing, getting, creating, updating, and deleting objects.
Typical use cases include:
- Fetching lists or single objects from Fractal Forge entities.
- Creating new objects or updating existing ones within Fractal Forge.
- Deleting objects from Fractal Forge.
For example, you might use this node to list all users (entities) in your Fractal Forge environment, get details of a specific user by ID, create a new project object, update an existing task, or delete obsolete records.
Properties
| Name | Meaning |
|---|---|
| Entity Name or ID | Select the target entity from Fractal Forge. You can choose from a dynamically loaded list or specify an ID using an expression. |
Note: The provided properties JSON only includes "Entity Name or ID" because the user requested extraction for Resource: Default and Operation: Default, which corresponds to the single property shown. However, the node supports additional properties depending on the selected resource and operation (e.g., Object ID, JSON body for commands).
Output
The node outputs JSON data representing the response from the Fractal Forge API for the requested operation. The structure depends on the operation performed:
- For list operations, it returns an array of objects representing the listed entities.
- For get operations, it returns a single object with the entity's details.
- For create, update, and delete operations, it returns the API response confirming the action.
If the node encounters errors during execution, it can output error messages associated with the specific input item index when configured to continue on failure.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Fractal Forge API.
- Needs the API endpoint URL configured in the credentials.
- Uses HTTP requests to communicate with the Fractal Forge REST API.
- The node dynamically loads available entities via an authenticated GET request to the
/system/commands-events-per-entityendpoint.
Troubleshooting
- Unknown Resource or Operation Errors: If you select a resource or operation not supported by the node, it will throw an error indicating the unknown resource or operation. Ensure you select valid combinations.
- Authentication Failures: If the API key or endpoint is incorrect or missing, requests will fail. Verify that the API credentials are correctly set up.
- Invalid Object IDs: Operations requiring an object ID (like get, update, delete) require a valid UUID string. Providing an invalid or empty ID may cause errors.
- Malformed JSON Body: For create and update commands, the JSON body must be valid JSON. Invalid JSON will cause parsing errors.
- API Request Failures: Network issues or API errors will result in exceptions. Review error messages returned by the API for troubleshooting.
Links and References
- Fractal Forge Documentation
- n8n Expressions Documentation (for using expressions in properties)