flippercloud/flipper · error · RuntimeError

#{gate.key} is not a valid flipper gate key

Error message

#{gate.key} is not a valid flipper gate key

What it means

Error "#{gate.key} is not a valid flipper gate key" thrown in flippercloud/flipper.

Source

Thrown at lib/flipper/adapters/http.rb:200

          csv_keys = features.map { |feature| query_escape(feature.key) }.join(',')
          "keys=#{csv_keys}&exclude_gate_names=true"
        end
      end

      def request_body_for_gate(gate, value)
        data = case gate.key
        when :boolean
          {}
        when :groups
          { name: value.to_s }
        when :actors
          { flipper_id: value.to_s }
        when :percentage_of_actors, :percentage_of_time
          { percentage: value.to_s }
        when :expression
          value
        else
          raise "#{gate.key} is not a valid flipper gate key"
        end
        JSON.generate(data)
      end

      def result_for_feature(feature, api_gates)
        api_gates ||= []
        result = default_config

        feature.gates.each do |gate|
          api_gate = api_gates.detect { |ag| ag['key'] == gate.key.to_s }
          result[gate.key] = value_for_gate(gate, api_gate) if api_gate
        end

        result
      end

      def value_for_gate(gate, api_gate)
        value = api_gate['value']

View on GitHub (pinned to 1f86de3ec9)

Solutions

1. Check the gate key spelling; valid keys are like :boolean, :actors, :groups, :percentage_of_actors, :percentage_of_time, :expression
2. Use gate.key values produced by Flipper itself rather than hand-constructed strings
3. Upgrade both client and server gems so their gate key sets match

When it happens

Trigger: Thrown at lib/flipper/adapters/http.rb:200 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of flippercloud/flipper@1f86de3ec9 (2026-08-23). Data as JSON: /api/errors/c815d90423ccfe43. Report an issue: GitHub.