# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Kinde Management Environments API
  version: 1.0.0
extends: openapi/kinde-environments-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/api/v1/environment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the current environment
      effect: read
      questions:
      - Which environment am I currently working in?
      - Can I see the details of my current environment?
      instructions:
      - text: Show the current environment.
      - text: Get details about this environment.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environment/feature_flags'].get
  update:
    x-apievangelist-phrasing:
      intent: List environment feature flags
      effect: read
      questions:
      - What feature flag values apply at the environment level?
      - Can I see every feature flag and its environment override?
      instructions:
      - text: List the environment's feature flags.
      - text: Show feature flag values set for this environment.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environment/feature_flags'].delete
  update:
    x-apievangelist-phrasing:
      intent: Clear all environment flag overrides
      effect: destructive
      questions:
      - How do I reset every feature flag override in the environment?
      - Can I remove all environment-level flag overrides at once?
      instructions:
      - text: Delete all environment feature flag overrides.
      - text: Reset every flag in this environment back to its default.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environment/feature_flags/{feature_flag_key}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Clear one environment flag override
      effect: destructive
      questions:
      - Can I remove the environment override for just one feature flag?
      - How do I revert a single flag to its default in this environment?
      instructions:
      - text: Remove the environment override for flag {feature_flag_key}.
        slots:
          feature_flag_key: path.feature_flag_key
      - text: Revert feature flag {feature_flag_key} to its default for the environment.
        slots:
          feature_flag_key: path.feature_flag_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environment/feature_flags/{feature_flag_key}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Override a flag for the environment
      effect: write
      questions:
      - How do I change a feature flag's value for the whole environment?
      - Can I override a flag's default at the environment level?
      instructions:
      - text: Set feature flag {feature_flag_key} to {value} for the environment.
        slots:
          feature_flag_key: path.feature_flag_key
          value: requestBody.value
      - text: Override environment flag {feature_flag_key} with {value}.
        slots:
          feature_flag_key: path.feature_flag_key
          value: requestBody.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environment/logos'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the environment's logos
      effect: read
      questions:
      - Which logos are configured for my environment?
      - Can I check the environment's light and dark logos?
      instructions:
      - text: Show the environment logo details.
      - text: List the logos uploaded for this environment.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environment/logos/{type}'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload an environment logo
      effect: write
      questions:
      - How do I upload a logo for my environment's sign-in pages?
      - Can I set a separate dark-mode logo for the environment?
      instructions:
      - text: Upload {logo} as the environment's {type} logo.
        slots:
          logo: requestBody.logo
          type: path.type
      - text: Set the environment {type} logo.
        slots:
          type: path.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environment/logos/{type}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an environment logo
      effect: destructive
      questions:
      - How do I remove a logo from my environment?
      - Can I delete just the dark environment logo?
      instructions:
      - text: Delete the environment's {type} logo.
        slots:
          type: path.type
      - text: Remove the {type} logo from this environment.
        slots:
          type: path.type
      method: generated
      generated: '2026-09-26'