# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Console Settings API
  version: 1.0.0
extends: openapi/statsig-settings-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: 8
- target: $.paths['/console/v1/settings/project'].get
  update:
    x-apievangelist-phrasing:
      intent: Get project settings
      effect: read
      questions:
      - What is my project's visibility and default unit type?
      - Can I read the general project settings?
      instructions:
      - text: Show my project settings.
      - text: Get the project name, visibility and default unit type.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/settings/project'].post
  update:
    x-apievangelist-phrasing:
      intent: Update project settings
      effect: write
      questions:
      - How do I rename the project or change its visibility?
      - Can I change the default unit type used for new gates and experiments?
      instructions:
      - text: Set the project name to {name} and visibility to {visibility}.
        slots:
          name: requestBody.name
          visibility: requestBody.visibility
      - text: Update project {name} with visibility {visibility} and default unit type {default_unit_type}.
        slots:
          name: requestBody.name
          visibility: requestBody.visibility
          default_unit_type: requestBody.default_unit_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/settings/reviews'].get
  update:
    x-apievangelist-phrasing:
      intent: Get review requirement settings
      effect: read
      questions:
      - Are config and metric reviews required in my project?
      - Do only verified metrics need review?
      instructions:
      - text: Show the reviews settings.
      - text: Check which changes require review in this project.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/settings/reviews'].post
  update:
    x-apievangelist-phrasing:
      intent: Update review requirement settings
      effect: write
      questions:
      - How do I require reviews on every config change?
      - Can I require metric reviews only for verified metrics?
      instructions:
      - text: Set config reviews required {is_config_review_required}, metric reviews {is_metric_review_required}, verified-only {is_metric_review_required_on_verified_only}.
        slots:
          is_config_review_required: requestBody.is_config_review_required
          is_metric_review_required: requestBody.is_metric_review_required
          is_metric_review_required_on_verified_only: requestBody.is_metric_review_required_on_verified_only
      - text: Require source reviews {is_whn_source_review_required} in our warehouse native project.
        slots:
          is_whn_source_review_required: requestBody.is_whn_source_review_required
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/settings/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the default project role setting
      effect: read
      questions:
      - What role do new members get by default?
      - Which default project role is configured?
      instructions:
      - text: Show the roles settings.
      - text: Tell me the default role assigned to new project members.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/settings/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the default project role
      effect: write
      questions:
      - How do I make new members start as Read Only?
      - Can I change the role newcomers are assigned automatically?
      instructions:
      - text: Set the default project role to {default_project_role}.
        slots:
          default_project_role: requestBody.default_project_role
      - text: Make {default_project_role} the role every new member gets.
        slots:
          default_project_role: requestBody.default_project_role
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/settings/teams'].get
  update:
    x-apievangelist-phrasing:
      intent: Get team requirement settings
      effect: read
      questions:
      - Is a team required on every new config?
      - What are the project's team settings?
      instructions:
      - text: Show the teams settings.
      - text: Check whether new configs must have a team.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/settings/teams'].post
  update:
    x-apievangelist-phrasing:
      intent: Require teams on new configs
      effect: write
      questions:
      - How do I force every new config to have an owning team?
      - Can I turn off the team requirement for configs?
      instructions:
      - text: Set require teams on configs to {require_teams_on_configs}.
        slots:
          require_teams_on_configs: requestBody.require_teams_on_configs
      - text: Turn the team-on-every-config rule {require_teams_on_configs}.
        slots:
          require_teams_on_configs: requestBody.require_teams_on_configs
      method: generated
      generated: '2026-10-01'