# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Optimizely Feature Experimentation Variations API
  version: 1.0.0
extends: openapi/optimizely-variations-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['/projects/{project_id}/flags/{flag_key}/variations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a flag's variations
      effect: read
      questions:
      - What variations does a feature flag have in my Optimizely Feature Experimentation project?
      - Can I list only the archived variations of a flag?
      - Which variations of a flag are currently in use?
      instructions:
      - text: List variations of flag {flag_key} in project {project_id}.
        slots:
          flag_key: path.flag_key
          project_id: path.project_id
      - text: List archived variations of flag {flag_key} in project {project_id} with archived {archived}.
        slots:
          flag_key: path.flag_key
          project_id: path.project_id
          archived: query.archived
      - text: Search variations of flag {flag_key} in project {project_id} for {query}.
        slots:
          flag_key: path.flag_key
          project_id: path.project_id
          query: query.query
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{project_id}/flags/{flag_key}/variations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a flag variation
      effect: write
      questions:
      - How do I add a new variation to a feature flag?
      - Can I set variable values when creating a variation?
      instructions:
      - text: Create variation {key} named {name} on flag {flag_key} in project {project_id}.
        slots:
          key: requestBody.key
          name: requestBody.name
          flag_key: path.flag_key
          project_id: path.project_id
      - text: Add variation {key} ({name}) to flag {flag_key} in project {project_id} with variables {variables}.
        slots:
          key: requestBody.key
          name: requestBody.name
          flag_key: path.flag_key
          project_id: path.project_id
          variables: requestBody.variables
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{project_id}/flags/{flag_key}/variations'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a flag's variations with a JSON patch
      effect: write
      questions:
      - How do I edit several variations of a flag in one JSON patch request?
      - Can I change variation names or variables using JSON patch?
      instructions:
      - text: Apply a JSON patch to the variations of flag {flag_key} in project {project_id}.
        slots:
          flag_key: path.flag_key
          project_id: path.project_id
      - text: Bulk-edit variations on flag {flag_key} (project {project_id}).
        slots:
          flag_key: path.flag_key
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{project_id}/flags/{flag_key}/variations/archived'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive flag variations
      effect: write
      questions:
      - How do I hide variations I no longer use without permanently deleting them?
      - Can I archive several variations of a flag at once?
      instructions:
      - text: Archive variations {keys} on flag {flag_key} in project {project_id}.
        slots:
          keys: requestBody.keys
          flag_key: path.flag_key
          project_id: path.project_id
      - text: Archive the unused variations {keys} of flag {flag_key} (project {project_id}).
        slots:
          keys: requestBody.keys
          flag_key: path.flag_key
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{project_id}/flags/{flag_key}/variations/brainstorm'].post
  update:
    x-apievangelist-phrasing:
      intent: Brainstorm variation ideas with AI
      effect: write
      questions:
      - Can Optimizely's AI suggest new variation definitions for a flag?
      - How do I get AI-generated variation ideas based on a conversation?
      instructions:
      - text: Brainstorm variations for flag {flag_key} in project {project_id} from interactions {interactions}.
        slots:
          flag_key: path.flag_key
          project_id: path.project_id
          interactions: requestBody.interactions
      - text: Use AI to suggest variation definitions for flag {flag_key} (project {project_id}) given {interactions}.
        slots:
          flag_key: path.flag_key
          project_id: path.project_id
          interactions: requestBody.interactions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{project_id}/flags/{flag_key}/variations/unarchived'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore archived flag variations
      effect: write
      questions:
      - How do I bring back variations I archived earlier?
      - Can I unarchive multiple variations of a flag in one call?
      instructions:
      - text: Unarchive variations {keys} on flag {flag_key} in project {project_id}.
        slots:
          keys: requestBody.keys
          flag_key: path.flag_key
          project_id: path.project_id
      - text: Restore archived variations {keys} of flag {flag_key} (project {project_id}).
        slots:
          keys: requestBody.keys
          flag_key: path.flag_key
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{project_id}/flags/{flag_key}/variations/{variation_key}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single flag variation
      effect: read
      questions:
      - What variables and settings does a specific variation of a flag have?
      - How do I fetch one variation by its key?
      instructions:
      - text: Get variation {variation_key} of flag {flag_key} in project {project_id}.
        slots:
          variation_key: path.variation_key
          flag_key: path.flag_key
          project_id: path.project_id
      - text: Show the variables of variation {variation_key} on flag {flag_key} (project {project_id}).
        slots:
          variation_key: path.variation_key
          flag_key: path.flag_key
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{project_id}/flags/{flag_key}/variations/{variation_key}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete a flag variation
      effect: destructive
      questions:
      - How do I permanently delete a variation so its data is gone for good?
      - Once I delete a variation, is there any way to get its data back?
      instructions:
      - text: Permanently delete variation {variation_key} from flag {flag_key} in project {project_id}.
        slots:
          variation_key: path.variation_key
          flag_key: path.flag_key
          project_id: path.project_id
      - text: Remove variation {variation_key} of flag {flag_key} (project {project_id}) forever.
        slots:
          variation_key: path.variation_key
          flag_key: path.flag_key
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'