# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Unity Remote Config Override Rules API
  version: 1.0.0
extends: openapi/unity-override-rules-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/v1/projects/{projectId}/environments/{environmentId}/rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List Remote Config override rules
      effect: read
      questions:
      - Which targeting rules override config values for player segments?
      - What override rules are active in this environment?
      instructions:
      - text: List the override rules in project {projectId}, environment {environmentId}.
        slots:
          projectId: path.projectId
          environmentId: path.environmentId
      - text: Show every segment targeting rule for environment {environmentId} of project {projectId}.
        slots:
          environmentId: path.environmentId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/projects/{projectId}/environments/{environmentId}/rules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a segment override rule
      effect: write
      questions:
      - How do I give a specific player segment different config values?
      - Can I roll out a config override to only a percentage of players between two dates?
      instructions:
      - text: Create override rule {name} for players matching {condition} with value {value} in environment {environmentId}, project {projectId}.
        slots:
          name: requestBody.name
          condition: requestBody.condition
          value: requestBody.value
          environmentId: path.environmentId
          projectId: path.projectId
      - text: Add enabled rule {name} at priority {priority} rolling {value} out to {rolloutPercentage} percent of players matching {condition}.
        slots:
          name: requestBody.name
          priority: requestBody.priority
          value: requestBody.value
          rolloutPercentage: requestBody.rolloutPercentage
          condition: requestBody.condition
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/projects/{projectId}/environments/{environmentId}/rules/{ruleId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an override rule
      effect: write
      questions:
      - Can I change the rollout percentage of an existing override rule?
      - Is it possible to pause a targeting rule without deleting it?
      instructions:
      - text: Set rule {ruleId} in environment {environmentId}, project {projectId}, to roll out to {rolloutPercentage} percent.
        slots:
          ruleId: path.ruleId
          environmentId: path.environmentId
          projectId: path.projectId
          rolloutPercentage: requestBody.rolloutPercentage
      - text: 'Disable override rule {ruleId} in project {projectId}, environment {environmentId} (enabled: {enabled}).'
        slots:
          ruleId: path.ruleId
          projectId: path.projectId
          environmentId: path.environmentId
          enabled: requestBody.enabled
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/projects/{projectId}/environments/{environmentId}/rules/{ruleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an override rule
      effect: destructive
      questions:
      - Can I permanently remove a targeting override rule?
      - What do I call to stop a segment override for good?
      instructions:
      - text: Delete override rule {ruleId} in environment {environmentId} of project {projectId}.
        slots:
          ruleId: path.ruleId
          environmentId: path.environmentId
          projectId: path.projectId
      - text: Remove targeting rule {ruleId} from project {projectId}, environment {environmentId}.
        slots:
          ruleId: path.ruleId
          projectId: path.projectId
          environmentId: path.environmentId
      method: generated
      generated: '2026-10-01'