# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns New Strategy Groups API
  version: 1.0.0
extends: openapi/mediamath-new-strategy-groups-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: 6
- target: $.paths['/new_strategy_groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List a campaign's strategy groups
      effect: read
      questions:
      - Which strategy groups exist in a campaign?
      - Do I have to filter strategy groups by campaign when listing them?
      instructions:
      - text: List strategy groups where {filter}.
        slots:
          filter: query.q
      - text: Show all strategy groups in the campaign matching {filter}, sorted by {sort}.
        slots:
          filter: query.q
          sort: query.sort_by
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a strategy group
      effect: write
      questions:
      - How do I group strategies inside a campaign?
      - Can a strategy group have its own spend or impression cap?
      instructions:
      - text: Create strategy group {name} in campaign {campaign}.
        slots:
          name: requestBody.name
          campaign: requestBody.campaign_id
      - text: Create a strategy group in campaign {campaign} capped at {amount} spend.
        slots:
          campaign: requestBody.campaign_id
          amount: requestBody.spend_cap_amount
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_groups/{strategy_group_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a strategy group
      effect: read
      questions:
      - What are the caps and settings on a specific strategy group?
      - Can I look up one strategy group by ID?
      instructions:
      - text: Get strategy group {group}.
        slots:
          group: path.strategy_group_id
      - text: Show the caps and settings of strategy group {group}.
        slots:
          group: path.strategy_group_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_groups/{strategy_group_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a strategy group
      effect: write
      questions:
      - How do I change the spend cap on an existing strategy group?
      - Can I raise the impression cap on a strategy group I already made?
      instructions:
      - text: Set the spend cap on strategy group {group} to {amount}.
        slots:
          group: path.strategy_group_id
          amount: requestBody.spend_cap_amount
      - text: Rename strategy group {group} to {name}.
        slots:
          group: path.strategy_group_id
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_groups/{strategy_group_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a strategy group
      effect: destructive
      questions:
      - What happens to strategies when I delete their strategy group?
      - How do I remove a strategy group?
      instructions:
      - text: Delete strategy group {group}.
        slots:
          group: path.strategy_group_id
      - text: Remove strategy group {group}, leaving its strategies detached.
        slots:
          group: path.strategy_group_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_groups/{strategy_group_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View a strategy group's change history
      effect: read
      questions:
      - Who changed this strategy group and when?
      - Where is the audit log for one strategy group?
      instructions:
      - text: Show the audit log for strategy group {group}.
        slots:
          group: path.strategy_group_id
      - text: List the changes made to strategy group {group}.
        slots:
          group: path.strategy_group_id
      method: generated
      generated: '2026-10-01'