Fractal Forge icon

Fractal Forge

Retrieve data from FractalForge API

Actions5

Overview

This node integrates with the Fractal Forge API to retrieve data related to various entities defined in the Fractal Forge system. Specifically, for the Query - Get operation, it fetches a single object by its ID from a selected entity. This is useful when you need to obtain detailed information about a specific record or item within Fractal Forge.

Common scenarios include:

  • Fetching configuration or metadata objects stored in Fractal Forge.
  • Retrieving details of a particular command or query entity for further processing.
  • Integrating Fractal Forge data into workflows that require up-to-date object information.

Example: You want to get the details of a user profile or a specific command configuration by providing its unique ID.

Properties

Name Meaning
Entity Name or ID Select the entity type from which to retrieve the object. Options are dynamically loaded from Fractal Forge.
Object ID The unique identifier of the object to retrieve within the selected entity. Must be provided as a string.

Output

The node outputs a JSON array where each element corresponds to the retrieved object(s) from Fractal Forge. For the "Get" operation, this will typically be a single object containing all fields and properties as returned by the Fractal Forge API for the specified entity and object ID.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Fractal Forge API.
  • The node uses the configured API endpoint and authorization token to make HTTP requests.
  • The "Entity Name or ID" options are dynamically loaded via an API call to the /system/commands-events-per-entity endpoint of Fractal Forge.

Troubleshooting

  • Error: "The operation 'get' is not known!"
    This indicates an unsupported operation was requested for the resource. Ensure the Resource is set to "Query" and Operation to "Get".

  • Error: "The resource '...' is not known!"
    This means the Resource parameter is invalid or missing. Confirm that "Query" is selected as the Resource.

  • API Request Failures (e.g., authentication errors)
    Check that the API key credential is correctly configured and has sufficient permissions. Verify the API endpoint URL is correct.

  • Invalid Object ID
    If the object ID does not exist or is malformed, the API may return an error or empty response. Double-check the ID format and existence.

  • Empty or Missing Entity List
    If the entity list fails to load, verify network connectivity and API credentials, as the node relies on the API to populate entity options.

Links and References

Discussion