# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Site Lists API
  version: 1.0.0
extends: openapi/mediamath-site-lists-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: 6
- target: $.paths['/site_lists'].get
  update:
    x-apievangelist-phrasing:
      intent: List site lists
      effect: read
      questions:
      - Which site lists exist in my organization?
      - Can I filter site lists by status or restriction?
      instructions:
      - text: List all my site lists.
      - text: Find site lists matching {q}.
        slots:
          q: query.q
      - text: List site lists sorted by {sort_by}.
        slots:
          sort_by: query.sort_by
      method: generated
      generated: '2026-10-01'
- target: $.paths['/site_lists/{site_list_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a site list
      effect: read
      questions:
      - How do I look up one site list's details by ID?
      - How many sites are in a given site list?
      instructions:
      - text: Get site list {site_list_id}.
        slots:
          site_list_id: path.site_list_id
      - text: Show the details and site count of site list {site_list_id}.
        slots:
          site_list_id: path.site_list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/site_lists/upload'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a file as a new site list
      effect: write
      questions:
      - How do I create a site list by uploading a file of domains?
      - Can I make a new blocklist or allowlist from a CSV?
      instructions:
      - text: Upload {file} as new site list {name} for organization {organization_id}.
        slots:
          file: requestBody.file
          name: requestBody.name
          organization_id: requestBody.organization_id
      - text: Create site list {name} in organization {organization_id} from {file} with restriction {restriction}.
        slots:
          name: requestBody.name
          organization_id: requestBody.organization_id
          file: requestBody.file
          restriction: requestBody.restriction
      method: generated
      generated: '2026-10-01'
- target: $.paths['/site_lists/{site_list_id}/upload'].post
  update:
    x-apievangelist-phrasing:
      intent: Replace a site list's contents by upload
      effect: write
      questions:
      - How do I upload a new file to replace the sites in an existing list?
      - Can I refresh an existing site list's domains from a file?
      instructions:
      - text: Upload {file} to replace the sites in site list {site_list_id}.
        slots:
          file: requestBody.file
          site_list_id: path.site_list_id
      - text: Update site list {site_list_id} at version {version} with a new upload.
        slots:
          site_list_id: path.site_list_id
          version: requestBody.version
      method: generated
      generated: '2026-10-01'
- target: $.paths['/site_lists/{site_list_id}/download.csv'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a site list as CSV
      effect: read
      questions:
      - How do I export the sites in a site list to CSV?
      - Can I download only a certain target type from a site list?
      instructions:
      - text: Download site list {site_list_id} as CSV.
        slots:
          site_list_id: path.site_list_id
      - text: Export the {target_type} entries of site list {site_list_id}.
        slots:
          target_type: query.target_type
          site_list_id: path.site_list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/site_lists/{site_list_id}/assignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List where a site list is assigned
      effect: read
      questions:
      - What entities is this site list currently assigned to?
      - How can I check where a site list is in use before changing it?
      instructions:
      - text: List assignments for site list {site_list_id}.
        slots:
          site_list_id: path.site_list_id
      - text: Show everything site list {site_list_id} is attached to.
        slots:
          site_list_id: path.site_list_id
      method: generated
      generated: '2026-10-01'