# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for LaunchDarkly REST Feature Flags API
  version: 1.0.0
extends: openapi/launchdarkly-feature-flags-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: 5
- target: $.paths['/flags/{projectKey}'].get
  update:
    x-apievangelist-phrasing:
      intent: List a project's feature flags
      effect: read
      questions:
      - Which feature flags exist in this project?
      - Can I list only the flags that carry a certain tag?
      - How do I search flags by name within a project?
      instructions:
      - text: List feature flags in project {projectKey}.
        slots:
          projectKey: path.projectKey
      - text: List flags in {projectKey} tagged {tag}.
        slots:
          projectKey: path.projectKey
          tag: query.tag
      - text: Find flags in {projectKey} matching {filter} for environment {env}.
        slots:
          projectKey: path.projectKey
          filter: query.filter
          env: query.env
      method: generated
      generated: '2026-09-26'
- target: $.paths['/flags/{projectKey}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a feature flag
      effect: write
      questions:
      - How do I create a new feature flag with custom variations?
      - Can I mark a new flag as temporary when I create it?
      - Is it possible to make a new flag available to client-side SDKs?
      instructions:
      - text: Create flag {name} with key {key} in project {projectKey}.
        slots:
          name: requestBody.name
          key: requestBody.key
          projectKey: path.projectKey
      - text: Create a temporary flag {key} named {name} in {projectKey} with variations {variations}.
        slots:
          key: requestBody.key
          name: requestBody.name
          projectKey: path.projectKey
          variations: requestBody.variations
      method: generated
      generated: '2026-09-26'
- target: $.paths['/flags/{projectKey}/{flagKey}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a feature flag and its targeting
      effect: read
      questions:
      - How do I see a flag's targeting rules in each environment?
      - What is the current configuration of a single flag?
      instructions:
      - text: Get flag {flagKey} in project {projectKey}.
        slots:
          flagKey: path.flagKey
          projectKey: path.projectKey
      - text: Show the targeting for {flagKey} in {projectKey}, environment {env} only.
        slots:
          flagKey: path.flagKey
          projectKey: path.projectKey
          env: query.env
      method: generated
      generated: '2026-09-26'
- target: $.paths['/flags/{projectKey}/{flagKey}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a feature flag
      effect: destructive
      questions:
      - How do I permanently delete a flag we no longer use?
      - Does deleting a flag also remove its targeting in every environment?
      instructions:
      - text: Delete flag {flagKey} from project {projectKey}.
        slots:
          flagKey: path.flagKey
          projectKey: path.projectKey
      - text: Permanently remove feature flag {flagKey} in {projectKey}.
        slots:
          flagKey: path.flagKey
          projectKey: path.projectKey
      method: generated
      generated: '2026-09-26'
- target: $.paths['/flags/{projectKey}/{flagKey}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a flag's targeting or settings
      effect: write
      questions:
      - How do I turn a flag on or change its targeting rules?
      - Can I add a prerequisite to an existing flag?
      - Can I use a semantic patch to update a flag?
      instructions:
      - text: Update flag {flagKey} in {projectKey} with patch {patch}.
        slots:
          flagKey: path.flagKey
          projectKey: path.projectKey
          patch: requestBody.patch
      - text: Apply {patch} to flag {flagKey} in {projectKey} and note {comment}.
        slots:
          patch: requestBody.patch
          flagKey: path.flagKey
          projectKey: path.projectKey
          comment: requestBody.comment
      method: generated
      generated: '2026-09-26'