# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Marketplaces API V2.0 Private Marketplace Exchange (PMP-E)…
  version: 1.0.0
extends: openapi/mediamath-private-marketplace-exchange-pmp-e-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: 21
- target: $.paths['/deals'].get
  update:
    x-apievangelist-phrasing:
      intent: List private marketplace deals
      effect: read
      questions:
      - Which PMP deals does my organization own in MediaMath?
      - Can I filter my deal list by status, deal type or currency?
      - How do I see only the deals a particular strategy is using?
      instructions:
      - text: List the deals owned by organization {org}.
        slots:
          org: query.owner.organization_id
      - text: Show active deals for organization {org} that strategy {strategy} uses.
        slots:
          org: query.owner.organization_id
          strategy: query.strategy_id
      - text: Search organization {org}'s deals for names matching {term}.
        slots:
          org: query.owner.organization_id
          term: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deals'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a private marketplace deal
      effect: write
      questions:
      - How do I set up a new PMP deal with a supply source and floor price?
      - What do I need to provide to register a single new deal ID from a publisher?
      - Can a new deal be given start and end dates when I create it?
      instructions:
      - text: Create a deal named {name} on supply source {supply_source} priced at {price}.
        slots:
          name: requestBody.name
          supply_source: requestBody.supply_source_id
          price: requestBody.price
      - text: Register deal identifier {deal_identifier} as a new deal called {name}.
        slots:
          deal_identifier: requestBody.deal_identifier
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deal_analytics'].post
  update:
    x-apievangelist-phrasing:
      intent: List deals with their performance reporting
      effect: read
      questions:
      - How are my PMP deals performing over the last 7 days?
      - Can I pull deal details together with spend and impression reporting for month to date?
      - Which deals delivered yesterday for my organization?
      instructions:
      - text: Show deals for organization {org} with reporting for {reporting}.
        slots:
          org: query.owner.organization_id
          reporting: requestBody.reporting
      - text: Pull deal performance data for organization {org} over the last 30 days.
        slots:
          org: query.owner.organization_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deals/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single deal's details
      effect: read
      questions:
      - What are the settings and price on a specific deal?
      - Can I see one deal's price converted into another currency?
      instructions:
      - text: Get deal {id}.
        slots:
          id: path.id
      - text: Show deal {id} with its price in {currency}.
        slots:
          id: path.id
          currency: query.currency_code
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deals/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update an existing deal
      effect: write
      questions:
      - How do I change the price on a deal I already created?
      - Can I pause an existing deal or move its end date?
      instructions:
      - text: Change the price of deal {id} to {price}.
        slots:
          id: path.id
          price: requestBody.price
      - text: Set the status of deal {id} to {status}.
        slots:
          id: path.id
          status: requestBody.status
      - text: Extend deal {id} so it ends at {end}.
        slots:
          id: path.id
          end: requestBody.end_datetime
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deal_groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List deal groups
      effect: read
      questions:
      - Which deal groups has my organization packaged up?
      - Can I find the deal groups that contain a particular deal?
      instructions:
      - text: List deal groups owned by organization {org}.
        slots:
          org: query.owner.organization_id
      - text: Find organization {org}'s deal groups that include deal {deal}.
        slots:
          org: query.owner.organization_id
          deal: query.deal_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deal_groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a deal group
      effect: write
      questions:
      - How do I package several deals into one group for targeting?
      - Can I bundle viewability deals together into a single deal group?
      instructions:
      - text: Create a deal group named {name} containing deals {deal_ids}.
        slots:
          name: requestBody.name
          deal_ids: requestBody.deal_ids
      - text: Make a new deal group called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deal_groups/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deal group's details
      effect: read
      questions:
      - What deals are inside a specific deal group?
      - Can I look up one deal group's name and status by its ID?
      instructions:
      - text: Get deal group {id}.
        slots:
          id: path.id
      - text: Show me which deals are in deal group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deal_groups/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a deal group
      effect: write
      questions:
      - How do I add or remove deals from an existing deal group?
      - Can I rename a deal group or deactivate it?
      instructions:
      - text: Replace the deals in deal group {id} with {deal_ids}.
        slots:
          id: path.id
          deal_ids: requestBody.deal_ids
      - text: Rename deal group {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/publishers'].get
  update:
    x-apievangelist-phrasing:
      intent: List publishers for an organization
      effect: read
      questions:
      - Which PMP-Direct publishers are set up under my organization?
      - Can I search an organization's publishers by name?
      instructions:
      - text: List publishers for organization {org}.
        slots:
          org: query.organization_id
      - text: Find publishers named like {term} in organization {org}.
        slots:
          term: query.q
          org: query.organization_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/publishers'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a publisher
      effect: write
      questions:
      - How do I add one publisher for direct PMP deals?
      - What is needed to register a single publisher under an organization?
      instructions:
      - text: Create publisher {name} under organization {org}.
        slots:
          name: requestBody.name
          org: requestBody.organization_id
      - text: Add a direct publisher called {name} to organization {org}.
        slots:
          name: requestBody.name
          org: requestBody.organization_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/publishers/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a publisher
      effect: read
      questions:
      - What details are stored for a specific publisher ID?
      - Can I read back one publisher record by its ID?
      instructions:
      - text: Get publisher {id}.
        slots:
          id: path.id
      - text: Show me the publisher record for ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/publishers/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename a publisher
      effect: write
      questions:
      - How do I edit the name of a publisher I already added?
      - Can a publisher's name be changed after creation?
      instructions:
      - text: Rename publisher {id}.
        slots:
          id: path.id
      - text: Update the name on publisher {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/publishers/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a publisher
      effect: destructive
      questions:
      - How do I remove a publisher I no longer work with?
      - Is deleting a publisher permanent?
      instructions:
      - text: Delete publisher {id}.
        slots:
          id: path.id
      - text: Remove publisher {id} from my organization.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/channels'].get
  update:
    x-apievangelist-phrasing:
      intent: List deal channels
      effect: read
      questions:
      - What channels can a deal be assigned to?
      - Which media channels are available for PMP deals?
      instructions:
      - text: List the available deal channels.
      - text: Show which channels I can assign a deal to.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/bulk_update/deals'].put
  update:
    x-apievangelist-phrasing:
      intent: Update many deals at once
      effect: write
      questions:
      - Can I update a batch of existing deals in one request?
      - How do I change the description on lots of deals together?
      instructions:
      - text: 'Bulk update these deals: {deals}.'
        slots:
          deals: requestBody.deals
      - text: Set the description to {description} across a batch of deals.
        slots:
          description: query.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/bulk_create/deals'].post
  update:
    x-apievangelist-phrasing:
      intent: Create many deals at once
      effect: write
      questions:
      - Is there a way to create a large batch of new deals in one call?
      - How do I bulk-load new deals instead of creating them one by one?
      instructions:
      - text: Bulk create a set of new deals.
      - text: Load a batch of brand-new deals in a single bulk create.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/bulk/deals'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update deals in one batch
      effect: write
      questions:
      - Can one request both create new deals and update existing ones by ID?
      - What happens to deals in a mixed bulk upsert that include an id field?
      instructions:
      - text: Upsert a batch of deals, creating new ones and updating those with IDs.
      - text: Send one bulk upsert that creates some deals and edits others by ID.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/bulk_create/publishers'].post
  update:
    x-apievangelist-phrasing:
      intent: Create several publishers at once
      effect: write
      questions:
      - How do I add multiple publishers to the same organization in one go?
      - Can I bulk-create publishers from a list of names?
      instructions:
      - text: Create publishers {names} under organization {org}.
        slots:
          names: requestBody.names
          org: requestBody.organization_id
      - text: Add these publisher names {names} to organization {org} in one go.
        slots:
          names: requestBody.names
          org: requestBody.organization_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deals/{id}/strategy_deals'].get
  update:
    x-apievangelist-phrasing:
      intent: List strategies using a deal
      effect: read
      questions:
      - Which strategies and campaigns are targeting a specific deal?
      - Can I see the campaigns behind the strategies that use a deal?
      instructions:
      - text: List the strategies using deal {id}.
        slots:
          id: path.id
      - text: Show strategies on deal {id} including their campaigns via {with}.
        slots:
          id: path.id
          with: query.with
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deal_groups/{id}/strategy_deal_groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List strategies using a deal group
      effect: read
      questions:
      - Which strategies are targeting a particular deal group?
      - Can I see the advertiser behind each strategy using a deal group?
      instructions:
      - text: List the strategies attached to deal group {id}.
        slots:
          id: path.id
      - text: Show deal group {id}'s strategies with {with} details.
        slots:
          id: path.id
          with: query.with
      method: generated
      generated: '2026-10-01'