Fractal Forge icon

Fractal Forge

Retrieve data from FractalForge API

Actions9

Overview

This node integrates with the Fractal Forge API to create a new object within a specified entity collection. It is designed for scenarios where users want to programmatically add data entries into their Fractal Forge-managed collections. For example, it can be used to automate the creation of records such as user profiles, product items, or any custom entities defined in Fractal Forge.

The "Create" operation under the "Command" resource allows sending JSON data representing the new object's properties, optionally targeting a specific object ID if needed.

Properties

Name Meaning
Entity Collection Name or ID (collection) Selects the target entity collection by name or ID where the new object will be created. Options are dynamically loaded from Fractal Forge.
Object ID (objectId) Optional. The ID of the object to create. If provided, the object will be created with this specific ID. Otherwise, the system assigns one.
JSON (jsonBody) The JSON-formatted body containing the data fields and values for the new object to be created.

Output

  • The output json field contains the response from the Fractal Forge API after creating the object. This typically includes the newly created object's details such as its ID, attributes, and metadata.
  • The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the Fractal Forge API.
  • The node expects the API endpoint URL and API key to be configured in the credentials.
  • Network access to the Fractal Forge API endpoint is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key: The node will fail authentication; ensure the API key credential is correctly set.
    • Incorrect collection name or ID: The node may return errors if the specified collection does not exist or is misspelled.
    • Malformed JSON body: Ensure the JSON input is valid and matches the expected schema for the target collection.

  • Error Messages:

    • "The operation "create" is not known!": Indicates an unsupported operation was selected; verify the operation parameter.
    • API request failures wrapped as node errors usually indicate network issues, invalid credentials, or malformed requests.

  • To resolve errors, check credentials, validate input parameters, and confirm the API endpoint is reachable.

Links and References

Discussion