# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Strategies API
  version: 1.0.0
extends: openapi/mediamath-strategies-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: 13
- target: $.paths['/strategies'].get
  update:
    x-apievangelist-phrasing:
      intent: List strategies
      effect: read
      questions:
      - Which strategies are running across my MediaMath campaigns?
      - Can I list only live strategies?
      - How do I search strategies by name?
      instructions:
      - text: List all strategies.
      - text: Show only live strategies.
      - text: Search strategies matching {query}.
        slots:
          query: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/strategies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a strategy in a campaign
      effect: write
      questions:
      - How do I add a new strategy to a campaign with goals and pacing?
      - Is there a limit on IPs or postal codes when creating a strategy?
      instructions:
      - text: Create a strategy in campaign {campaign} with goals {goals} and pacing {pacing}.
        slots:
          campaign: requestBody.campaign_id
          goals: requestBody.goals
          pacing: requestBody.pacing
      - text: Add a new strategy to campaign {campaign} using pacing {pacing} and goals {goals} with inventory {inventory}.
        slots:
          campaign: requestBody.campaign_id
          pacing: requestBody.pacing
          goals: requestBody.goals
          inventory: requestBody.inventory
      method: generated
      generated: '2026-10-01'
- target: $.paths['/strategies/{strategy_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a strategy
      effect: read
      questions:
      - What are the settings of a specific strategy?
      - Can I get the extended view of one strategy?
      instructions:
      - text: Get strategy {strategy}.
        slots:
          strategy: path.strategy_id
      - text: Show the settings of strategy {strategy}.
        slots:
          strategy: path.strategy_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/strategies/{strategy_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a strategy's targeting
      effect: write
      questions:
      - How do I change the targeting on an existing strategy?
      - Can I update a single strategy's settings by ID?
      instructions:
      - text: Update the targeting on strategy {strategy} to {targeting}.
        slots:
          strategy: path.strategy_id
          targeting: requestBody.targeting
      - text: Change strategy {strategy} so its targeting becomes {targeting}.
        slots:
          strategy: path.strategy_id
          targeting: requestBody.targeting
      method: generated
      generated: '2026-10-01'
- target: $.paths['/strategies/{strategy_id}/copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy a strategy
      effect: write
      questions:
      - Can I duplicate a strategy under a new name?
      - How do I copy a strategy along with its targeting and concepts?
      instructions:
      - text: Copy strategy {strategy} as {name} with status {status}.
        slots:
          strategy: path.strategy_id
          name: requestBody.name
          status: requestBody.status
      - text: Duplicate strategy {strategy} under the name {name} with status {status}.
        slots:
          strategy: path.strategy_id
          name: requestBody.name
          status: requestBody.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/strategies/{strategy_id}/healthcheck'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a strategy's health
      effect: read
      questions:
      - Is my strategy healthy and able to bid?
      - What problems are flagged on a strategy?
      instructions:
      - text: Run a health check on strategy {strategy}.
        slots:
          strategy: path.strategy_id
      - text: Tell me if strategy {strategy} has any health problems.
        slots:
          strategy: path.strategy_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/strategies/{strategy_id}/friendly_names'].get
  update:
    x-apievangelist-phrasing:
      intent: Get readable names for a strategy's targeting
      effect: read
      questions:
      - What do the targeting IDs on my strategy actually mean in plain names?
      - Can I see human-readable labels for a strategy's targeting?
      instructions:
      - text: Show friendly targeting names for strategy {strategy}.
        slots:
          strategy: path.strategy_id
      - text: Translate strategy {strategy}'s targeting IDs into readable names.
        slots:
          strategy: path.strategy_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/strategies/{strategy_id}/forecast_query'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a strategy's forecast query
      effect: read
      questions:
      - What forecast query is generated for a strategy?
      - Can I see the query used to forecast a strategy's reach?
      instructions:
      - text: Get the forecast query for strategy {strategy}.
        slots:
          strategy: path.strategy_id
      - text: Show me the query used to forecast strategy {strategy}.
        slots:
          strategy: path.strategy_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/strategies/{strategy_id}/targeting_expression'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a strategy's targeting expression
      effect: read
      questions:
      - What is the normalized targeting expression for my strategy?
      - Can the targeting expression include inactive targeting?
      instructions:
      - text: Get the targeting expression for strategy {strategy}.
        slots:
          strategy: path.strategy_id
      - text: Show strategy {strategy}'s targeting expression including inactive items.
        slots:
          strategy: path.strategy_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/strategies/{strategy_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View a strategy's change history
      effect: read
      questions:
      - Who changed this strategy and what did they change?
      - Where can I see the audit trail for one strategy?
      instructions:
      - text: Show the audit log for strategy {strategy}.
        slots:
          strategy: path.strategy_id
      - text: List the changes made to strategy {strategy}.
        slots:
          strategy: path.strategy_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/bulk_update/strategies'].post
  update:
    x-apievangelist-phrasing:
      intent: Update multiple strategies at once
      effect: write
      questions:
      - Can I change many strategies in one request?
      - How do I bulk edit strategies across a campaign?
      instructions:
      - text: Bulk update strategies with {update}.
        slots:
          update: requestBody.update
      - text: 'Apply this change to many strategies at once: {update}.'
        slots:
          update: requestBody.update
      method: generated
      generated: '2026-10-01'
- target: $.paths['/strategies/{strategy_id}/permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: List users with access to a strategy
      effect: read
      questions:
      - Which users have permission to a given strategy?
      - Who can view or edit this strategy?
      instructions:
      - text: List user permissions for strategy {strategy}.
        slots:
          strategy: path.strategy_id
      - text: Show who has access to strategy {strategy}.
        slots:
          strategy: path.strategy_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/audit_log/strategies'].post
  update:
    x-apievangelist-phrasing:
      intent: View change history for several strategies
      effect: read
      questions:
      - Can I pull the audit logs for several strategies together?
      - What changed across this set of strategies?
      instructions:
      - text: Get the audit logs for strategies {ids}.
        slots:
          ids: requestBody.id
      - text: List the changes made across strategies {ids}.
        slots:
          ids: requestBody.id
      method: generated
      generated: '2026-10-01'