Fractal Forge icon

Fractal Forge

Retrieve data from FractalForge API

Actions5

Overview

This node integrates with the Fractal Forge API to perform operations on entities categorized as "Command" or "Query". Specifically, for the Command resource and the Delete operation, it deletes an object identified by its ID within a specified entity. This is useful in scenarios where you need to programmatically remove commands or objects from your Fractal Forge system, such as cleaning up obsolete commands or managing lifecycle of command-based data.

Practical example:

  • Automatically deleting a command object when it is no longer needed after processing.
  • Removing test or temporary command entries during workflow automation.

Properties

Name Meaning
Entity Name or ID Select the target entity from a dynamically loaded list or specify an entity ID via expression.
Object ID The unique identifier of the object (command) to delete within the selected entity.

Output

The node outputs JSON data representing the response from the Fractal Forge API after attempting to delete the specified object. The structure depends on the API's response but typically confirms successful deletion or provides error details.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Fractal Forge API.
  • Needs the API endpoint URL configured in the credentials.
  • The node uses HTTP DELETE requests to the Fractal Forge API.

Troubleshooting

  • Common issues:

    • Invalid or missing Object ID: Ensure the Object ID is correctly provided and matches an existing object.
    • Incorrect Entity selection: The entity must be valid and accessible with the provided API key.
    • Authentication errors: Verify that the API key credential is correct and has sufficient permissions.
    • Network or API endpoint issues: Confirm the API endpoint URL is reachable and correct.

  • Error messages:

    • "The operation "delete" is not known!" — Occurs if the operation parameter is incorrectly set; ensure "Delete" is selected under Command resource.
    • API request failures will throw errors wrapped as API errors; check the error message for HTTP status codes or API-specific messages.
    • If the node is set to continue on fail, errors are returned in the output JSON with an error field describing the issue.

Links and References

Discussion