# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns API
  version: 1.0.0
extends: openapi/mediamath-campaigns-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: 11
- target: $.paths['/bulk_update/campaigns'].post
  update:
    x-apievangelist-phrasing:
      intent: Update many campaigns at once
      effect: write
      questions:
      - Can I change settings on several campaigns in a single request?
      - How do I bulk update campaigns in MediaMath?
      instructions:
      - text: Bulk update campaigns with {update}.
        slots:
          update: requestBody.update
      - text: Apply update {update} to multiple campaigns at once.
        slots:
          update: requestBody.update
      method: generated
      generated: '2026-10-01'
- target: $.paths['/campaigns/{campaign_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a campaign
      effect: read
      questions:
      - What are the budget, goals and status of a specific campaign?
      - Can I get extended details for one campaign?
      instructions:
      - text: Get campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show extended details for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/campaigns/{campaign_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a campaign
      effect: write
      questions:
      - How can I change an existing campaign's budget or pacing?
      - Can I pause or archive a campaign I already created?
      instructions:
      - text: Set campaign {campaign_id} status to {status}.
        slots:
          campaign_id: path.campaign_id
          status: requestBody.status
      - text: Change the budget of campaign {campaign_id} to {budget}.
        slots:
          campaign_id: path.campaign_id
          budget: requestBody.budget
      - text: Rename campaign {campaign_id} to {name}.
        slots:
          campaign_id: path.campaign_id
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/campaigns'].get
  update:
    x-apievangelist-phrasing:
      intent: List campaigns
      effect: read
      questions:
      - Which campaigns are currently live?
      - Can I list campaigns while hiding ones that have expired?
      instructions:
      - text: List my campaigns.
      - text: List only live campaigns.
      - text: Find campaigns matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/campaigns'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a campaign
      effect: write
      questions:
      - How do I launch a new campaign for an advertiser?
      - What goals and budget are required when creating a campaign?
      instructions:
      - text: Create campaign {name} for advertiser {advertiser_id} with budget {budget} and goals {goals}.
        slots:
          name: requestBody.name
          advertiser_id: requestBody.advertiser_id
          budget: requestBody.budget
          goals: requestBody.goals
      - text: Set up a new campaign for advertiser {advertiser_id}.
        slots:
          advertiser_id: requestBody.advertiser_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/campaigns/{campaign_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View a campaign's change history
      effect: read
      questions:
      - Who changed this campaign and when?
      - Can I see the audit log for one campaign?
      instructions:
      - text: Show the change history for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Get the audit log of campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/campaigns/{campaign_id}/dynamic_budget_allocation'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a campaign's dynamic budget allocation (legacy)
      effect: write
      questions:
      - Can I toggle dynamic budget allocation on one campaign with the legacy endpoint?
      - Is the per-campaign dynamic budget allocation call going away?
      instructions:
      - text: Turn dynamic budget allocation {dynamic_budget_allocation_applied} for campaign {campaign_id} via the legacy call.
        slots:
          dynamic_budget_allocation_applied: requestBody.dynamic_budget_allocation_applied
          campaign_id: path.campaign_id
      - text: Set dynamic budget allocation availability to {dynamic_budget_allocation_available} on campaign {campaign_id}.
        slots:
          dynamic_budget_allocation_available: requestBody.dynamic_budget_allocation_available
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/campaigns/{campaign_id}/copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy a campaign
      effect: write
      questions:
      - Can I duplicate an existing campaign with new dates?
      - When copying a campaign, can I bring over its site lists and brain settings?
      instructions:
      - text: Copy campaign {campaign_id} as {name} with status {status}.
        slots:
          campaign_id: path.campaign_id
          name: requestBody.name
          status: requestBody.status
      - text: Duplicate campaign {campaign_id} into {name} running {start_date} to {end_date}, status {status}.
        slots:
          campaign_id: path.campaign_id
          name: requestBody.name
          start_date: requestBody.start_date
          end_date: requestBody.end_date
          status: requestBody.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/campaign_dba'].post
  update:
    x-apievangelist-phrasing:
      intent: Update dynamic budget allocation (service account)
      effect: write
      questions:
      - Is there a service-account-only endpoint for campaign dynamic budget allocation?
      - Who can call the campaign_dba update endpoint?
      instructions:
      - text: Update campaign dynamic budget allocation through the service account endpoint.
      - text: Push dynamic budget allocation updates via campaign_dba.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/campaigns/{campaign_id}/permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: List users with access to a campaign
      effect: read
      questions:
      - Which users have permissions on a particular campaign?
      - Can I search a campaign's user permissions?
      instructions:
      - text: List user permissions for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show users who can access campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/audit_log/campaigns'].post
  update:
    x-apievangelist-phrasing:
      intent: View change history for several campaigns
      effect: read
      questions:
      - Can I pull the audit log for multiple campaigns at once?
      - What changed across a batch of campaigns?
      instructions:
      - text: Get the audit log for campaigns {id}.
        slots:
          id: requestBody.id
      - text: Show changes made to campaigns {id}.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-10-01'