Flipt icon

Flipt

Interact with Flipt API

Overview

This n8n node allows you to interact with the Flipt API, specifically to retrieve the value of a feature flag within a given namespace. It is useful in scenarios where you want to automate feature flag checks as part of your workflow—for example, enabling or disabling certain steps based on feature toggles managed in Flipt.

Practical examples:

  • Conditionally execute workflow branches depending on whether a feature flag is enabled.
  • Monitor and log the status of specific feature flags across different environments.
  • Integrate feature flag checks into CI/CD pipelines for dynamic configuration.

Properties

Name Meaning
Namespace Select namespace. The namespace in which the feature flag resides.
Feature Flag Flag name. The specific feature flag to retrieve from the selected namespace.

Output

The output will be a JSON object containing the details of the requested feature flag. The structure typically includes information such as the flag's key, its current value, and possibly metadata (depending on the Flipt API response).

Example output:

{
  "key": "my_flag",
  "enabled": true,
  "description": "A sample feature flag",
  "createdAt": "2023-01-01T00:00:00Z",
  "updatedAt": "2023-06-01T12:34:56Z"
}

Note: Actual fields may vary depending on the Flipt API version and configuration.

Dependencies

  • External Service: Requires access to a running Flipt API instance.
  • Credentials: Needs an n8n credential named fliptApi with at least a domain property specifying the Flipt API base URL.
  • n8n Configuration: Ensure the Flipt API credentials are configured in n8n.

Troubleshooting

  • Missing Credentials:
    Error message: "No credentials found for fliptApi."
    Resolution: Set up the required Flipt API credentials in n8n.

  • Invalid Namespace or Feature Flag:
    Error message: "Feature flag not found" or similar.
    Resolution: Double-check that the namespace and feature flag names are correct and exist in your Flipt instance.

  • Connection Issues:
    Error message: "Could not connect to Flipt API."
    Resolution: Verify the domain in your credentials and ensure the Flipt API is reachable from your n8n instance.

Links and References

Discussion