Overview
This node integrates with the FractalForge API to perform CRUD (Create, Read, Update, Delete) operations on entities defined within FractalForge. Specifically for the Command - Update operation, it updates an existing object of a selected entity by sending a PUT request with JSON data representing the updated fields.
Common scenarios where this node is useful include:
- Automating updates to objects in FractalForge based on external triggers or workflows.
- Synchronizing data changes from other systems into FractalForge.
- Modifying properties of specific command entities programmatically without manual intervention.
For example, you might use this node to update the status or attributes of a command object identified by its ID whenever a related event occurs in another system.
Properties
| Name | Meaning |
|---|---|
| Entity Name or ID | Select the target entity to update. Choose from a dynamically loaded list of entities or specify an ID. |
| Object ID | The unique identifier of the object within the selected entity that you want to update. |
| JSON | A JSON string representing the new data to update the object with. This should contain the fields to modify. |
Output
The node outputs a JSON array containing the response from the FractalForge API after the update operation. Each item corresponds to one input item processed and includes the updated object's data as returned by the API.
If the API returns binary data (not indicated here), it would be included accordingly, but this node primarily deals with JSON responses representing updated objects.
Dependencies
- Requires an active connection to the FractalForge API via an API key credential.
- Needs the API endpoint URL and a valid API authentication token configured in the node credentials.
- Uses HTTP methods (PUT) to communicate with the FractalForge REST API.
Troubleshooting
- Invalid Object ID: If the provided Object ID does not exist or is malformed, the API will likely return an error. Verify the ID format and existence.
- Malformed JSON: The JSON property must be valid JSON. Invalid JSON syntax will cause parsing errors before the request is sent.
- Authentication Errors: Missing or invalid API keys will result in authorization failures. Ensure credentials are correctly set up.
- Unknown Operation or Resource: The node throws errors if unsupported operations or resources are specified. Confirm that "command" resource and "update" operation are selected.
- API Endpoint Issues: Network problems or incorrect API endpoint URLs can cause request failures. Check connectivity and endpoint correctness.
Links and References
- FractalForge API Documentation
- n8n Expressions Documentation (for dynamic parameter expressions)