# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for LinkedIn Marketing Audiences DMP Segments API
  version: 1.0.0
extends: openapi/linkedin-dmp-segments-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/dmpSegments'].get
  update:
    x-apievangelist-phrasing:
      intent: Monitor DMP segments for an ad account
      effect: read
      questions:
      - What's the match rate and audience size of my uploaded segments?
      - Can I filter matched audience segments by source platform?
      instructions:
      - text: Show DMP segments for ad account {account}.
        slots:
          account: query.account
      - text: List segments in {account} from source {sourcePlatform}.
        slots:
          account: query.account
          sourcePlatform: query.sourcePlatform
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dmpSegments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a DMP segment
      effect: write
      questions:
      - Can I create a matched audience segment for list uploads or streaming?
      - How long must I wait after creating a segment before adding data?
      instructions:
      - text: Create a {type} segment named {name} in account {account}.
        slots:
          type: requestBody.type
          name: requestBody.name
          account: requestBody.account
      - text: Create segment {name} from {sourcePlatform} with policy {accessPolicy} and destinations {destinations}.
        slots:
          name: requestBody.name
          sourcePlatform: requestBody.sourcePlatform
          accessPolicy: requestBody.accessPolicy
          destinations: requestBody.destinations
      method: generated
      generated: '2026-09-26'