{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.com/schemas/kinde/feature-flag",
  "title": "FeatureFlag",
  "description": "A Kinde feature flag — a typed, environment-scoped configuration value that can be overridden per environment or per organization to drive progressive delivery.",
  "type": "object",
  "required": ["key", "type"],
  "properties": {
    "key": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_]*$",
      "description": "Stable feature-flag key."
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": ["string", "null"]
    },
    "type": {
      "type": "string",
      "enum": ["boolean", "string", "integer", "json"],
      "description": "Value type."
    },
    "allow_override_level": {
      "type": "string",
      "enum": ["env", "org", "usr"],
      "description": "Lowest scope at which the flag value can be overridden."
    },
    "value": {
      "description": "Default value at the environment scope."
    }
  }
}