# 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 Plans API
  version: 1.0.0
extends: openapi/mediamath-new-strategy-plans-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['/new_strategy_plans/forecast'].post
  update:
    x-apievangelist-phrasing:
      intent: Forecast a strategy plan without saving it
      effect: read
      questions:
      - Can I run a forecast on a strategy plan without saving the plan?
      - How do I try out a what-if strategy plan forecast for an advertiser?
      instructions:
      - text: Run a throwaway forecast for a strategy plan under campaign plan {campaign_plan_id}.
        slots:
          campaign_plan_id: requestBody.campaign_plan_id
      - text: Forecast an unsaved strategy plan for advertiser {advertiser_id} across channels {channels}.
        slots:
          advertiser_id: requestBody.advertiser_id
          channels: requestBody.channels
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_plans/{strategy_plan_id}/forecast'].post
  update:
    x-apievangelist-phrasing:
      intent: Rerun and save the forecast for a strategy plan
      effect: write
      questions:
      - How do I refresh the stored forecast for a saved strategy plan?
      - Can I rerun a forecast on an existing new strategy plan?
      instructions:
      - text: Rerun and update the forecast for strategy plan {strategy_plan_id}.
        slots:
          strategy_plan_id: path.strategy_plan_id
      - text: Refresh the saved forecast on strategy plan {strategy_plan_id}.
        slots:
          strategy_plan_id: path.strategy_plan_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_plans/{strategy_plan_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a new strategy plan
      effect: read
      questions:
      - How do I look up a single new strategy plan by ID?
      - Can I see the channels and forecast on one strategy plan?
      instructions:
      - text: Get strategy plan {strategy_plan_id}.
        slots:
          strategy_plan_id: path.strategy_plan_id
      - text: Show extended details for new strategy plan {strategy_plan_id}.
        slots:
          strategy_plan_id: path.strategy_plan_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_plans/{strategy_plan_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a new strategy plan
      effect: write
      questions:
      - How do I change the channels on a saved strategy plan?
      - Does updating a strategy plan need its current version?
      instructions:
      - text: Update strategy plan {strategy_plan_id} to use channels {channels}.
        slots:
          strategy_plan_id: path.strategy_plan_id
          channels: requestBody.channels
      - text: Save changes to strategy plan {strategy_plan_id} at version {version}.
        slots:
          strategy_plan_id: path.strategy_plan_id
          version: requestBody.version
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_plans/{strategy_plan_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a new strategy plan
      effect: destructive
      questions:
      - How do I delete a strategy plan I no longer need?
      - Can I remove a new strategy plan by its ID?
      instructions:
      - text: Delete strategy plan {strategy_plan_id}.
        slots:
          strategy_plan_id: path.strategy_plan_id
      - text: Remove new strategy plan {strategy_plan_id}.
        slots:
          strategy_plan_id: path.strategy_plan_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_plans'].get
  update:
    x-apievangelist-phrasing:
      intent: List new strategy plans
      effect: read
      questions:
      - Which strategy plans exist for one of my advertisers?
      - Can I filter strategy plans by organization or agency?
      instructions:
      - text: List new strategy plans for advertiser {advertiser_id}.
        slots:
          advertiser_id: query.advertiser_id
      - text: Show strategy plans under agency {agency_id}.
        slots:
          agency_id: query.agency_id
      - text: List strategy plans in organization {organization_id}.
        slots:
          organization_id: query.organization_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_plans'].post
  update:
    x-apievangelist-phrasing:
      intent: Create and save a new strategy plan
      effect: write
      questions:
      - How do I save a new strategy plan inside a campaign plan?
      - Can I create a strategy plan with specific channels for an advertiser?
      instructions:
      - text: Create a strategy plan under campaign plan {campaign_plan_id}.
        slots:
          campaign_plan_id: requestBody.campaign_plan_id
      - text: Save a new strategy plan for advertiser {advertiser_id} with channels {channels}.
        slots:
          advertiser_id: requestBody.advertiser_id
          channels: requestBody.channels
      method: generated
      generated: '2026-10-01'
- target: $.paths['/new_strategy_plan_target_values'].get
  update:
    x-apievangelist-phrasing:
      intent: List target values for strategy plans
      effect: read
      questions:
      - Which targeting values can I use when building a strategy plan?
      - Can I search the strategy plan target values by name?
      instructions:
      - text: List target values available for strategy plans.
      - text: Find strategy plan target values matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-10-01'